Activepieces

Activepieces 是以可视化 Flow 连接应用和处理数据的自动化平台，核心代码采用 MIT 许可，也提供云服务与商业功能。它既能把一个服务的事件交给另一个服务处理，也把 Agents 和 Tables 纳入同一套工作空间。理解它的重点不只是“有多少连接器”，而是数据怎样从触发器传到后续动作，以及哪些逻辑交给确定的流程、哪些交给 AI。

Flow 中每一步都要接到真实的上游数据

一个 Flow 从 Trigger 开始，后面连接 Actions。触发器可以是定时、Webhook 或某个服务事件；动作可以调用其他服务或运行代码。各步骤按流程顺序执行，后面的步骤可引用前面步骤的输出，形成明确的数据传递关系。

先收到样本，字段才有上下文

以外部表单发送姓名和邮箱为例，假设 Webhook 收到的示例数据是 {"name":"示例客户","email":"demo@example.com"}。这只是用于说明映射的自拟数据，不是实际收集的访客信息。官方文档提供 Load Data、Test Trigger、Send Data 等采样方式；Webhook 路线应先按界面提示发送样本，让编辑器取得输出结构。

没有样本时，后续字段选择器可能无法展开你期望的内容。即使使用模拟数据完成搭建，上线前也要用真实结构重新核对：表单服务可能把字段包在 body 或其他层级里，而不是直接放在最外层。字段名称相同，并不说明路径也相同。

在 Data to Insert 中映射，而不是输入一份固定文案

配置后续动作时，点击输入项打开 Data to Insert，展开上游步骤并选取姓名、邮箱等字段。例如把姓名插入通知正文，运行时应替换成当次提交者的值，而不是永远出现“示例客户”。输入框可以混合固定文字和动态字段，适合组成通知内容。

官方也支持 {{step_slug.path.to.property}} 形式的表达式，但具体 step slug 与字段路径应来自当前流程，不能照抄示例字符串。检查一条测试数据是否成功传递，重点是下游收到的值是否对应上游样本；步骤显示成功，却把固定演示文字发出去，仍然不是正确的数据连接。

编辑中的流程与正在执行的版本分开

修改 Flow 不会立即改变已发布版本，需要点击 Publish 才会让修改生效。这里的“发布”指工作流运行版本，不是把内容发到互联网。若你已改好字段却仍看到旧结果，应先确认运行使用的版本，而不是反复修改同一映射。

在 Dashboard 的 Runs 中打开对应记录，再点击具体步骤，可以在 Run Details 看输入和输出。这条路径能区分：触发器没有收到数据、映射路径不对，还是目标服务拒绝动作。上述说明依据官方文档，未连接外部账号执行通知。

Agents 负责判断，Tables 保存流程需要记住的事

Activepieces 当前把 Agents、Flows 和 Tables 作为相互协作的部分。Flow 可调用 Agent，Agent 也能使用 Flow；Tables 则在平台内保存结构化记录，供流程读写或作为 Agent 的知识来源。平台另有 MCP 等连接能力，但不需要为了一个简单的字段转存任务同时引入所有模块。

例如收集到一条新线索后，固定字段入表适合明确的 Flow；需要从自由文本中概括需求时，才考虑 AI 处理。Tables 可以记录是否已联系、上次处理结果等状态，避免每次运行都从零开始。不过，建一张表并不会自动完成去重，还需要在流程里明确查询依据和更新逻辑。

现成连接器在平台中称为 Pieces。需要对接尚未覆盖的内部服务时，可查阅自定义 Piece 的 TypeScript 开发文档；这属于扩展开发，不等于所有业务系统都已经能无配置接入。

云服务与自托管，差别不只是服务器放在哪里

官方 Docker Compose 方案使用 PostgreSQL 和 Redis。需要外部服务推送 Webhook 时，还必须有对方能访问的入口；只在本机打开管理页面并不代表外部触发已经可用。备份也不能只复制安装目录：数据库数据与连接加密密钥都关系到恢复，密钥丢失会使已保存的连接无法解密。

许可文档明确区分 MIT 核心与商业授权的企业、云相关功能代码。因此，自托管不等于全部功能免费，也不自动解决合规或降低总成本；选择依据应是基础设施控制需求与维护能力。流程文档入口：www.activepieces.com/docs；许可说明：www.activepieces.com/docs/about/license。