Workflow：多 Agent 流程编排

DESIGN → Workflows 用于有明确步骤、依赖和人工关口的工作。定义保存可编辑草稿；发布生成不可变 revision；每次执行固定一个 revision，因此后续编辑不会改变已有运行的拓扑。

​

界面导览

在 Workflow Design 中检查步骤和依赖，再编辑选中步骤的配置。保存草稿后先校验，再发布版本；Run Workflow 使用已发布版本，修改草稿不等于更新已运行的工作。

​

从一个 Agent 步骤开始

1. 新建 Workflow，填写名称并选择 Initial Workflow Agent。
2. 在设计器中设置节点 key 和目标 Agent。节点 key 在同一流程中必须唯一。
3. 保存草稿，执行校验，修复未选目标、未知节点引用或环路等错误。
4. 发布版本，进入执行入口选择该版本和新建或已有 Issue，填写 JSON input 后启动。
5. 检查执行图、节点输出和 Issue 结果；确定单步可用后再添加更多节点。

​

可用节点

例如“生成草稿 → 人工审批 → 发布准备”可以使用 agent、approval、agent 三个节点，并建立相应边。审批通过只放行下一步；对外发布能力仍需要目标 Agent 的工具和权限。

​

数据映射与校验

Input mapping 把输入名称映射为 CEL 表达式，例如 run.input.request。表达式可引用运行输入、变量、Issue、trigger 和前序节点的状态、输出、产物。使用设计器检查依赖关系，先查看真实节点输出，再编写下游字段映射。 CEL 是受限表达式，不能当作任意脚本执行器。流程必须是无环图；子流程引用固定版本。JSON 编辑和图形编辑操作的是同一份定义，发布前都需要服务端校验。

​

控制执行

Pause 阻止新节点调度，已经运行的步骤仍可返回结果；Resume 恢复调度。Cancel 请求取消节点、任务和子运行，但不会把 Issue 自动验收或删除。 终态后使用 Rerun 会创建新的 Run 并保留来源关联。选择 fail_fast、continue 或 partial_success 时，要明确部分成功是否能满足业务目标。流程不提供自动补偿已发生外部副作用的保证。

​

提供给应用使用

发布后在 Endpoint 配置中选择具体 revision。新 revision 发布不等于调用方已切换；更新 Endpoint release 后再检查实际调用版本。 下一步：Endpoint 接入 · 执行状态参考。