> ## Documentation Index
> Fetch the complete documentation index at: https://java.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 | 交给一个 Agent 执行 |
| team | 交给 Team 协作 |
| condition | 根据 CEL 条件选择路径 |
| join | 汇合分支，按配置决定何时满足依赖 |
| approval | 等待指定人员审批 |
| timer | 等待指定时长 |
| signal | 等待具名外部信号 |
| subrun | 调用指定的已发布 Workflow revision |
例如“生成草稿 → 人工审批 → 发布准备”可以使用 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 接入](/v2/zh/service/endpoints) · [执行状态参考](/v2/zh/service/sessions)。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.