工作流构建器
工作流构建器是任务编辑器中的可视化画布。它让您以图表方式设计任务的执行流程——将节点拖到画布上、用连线将它们连接起来、并配置每个节点——而无需编写代码。
构建器是任务编辑器的一部分。关于完整的任务生命周期（创建任务、任务列表、运行任务和执行历史），请参阅任务管理。
打开构建器
在任务列表中点击任务的配置，或创建新任务，即可打开任务编辑器。编辑器在 /tasks/edit/:taskId 打开，画布位于中央。
编辑器中央是画布，左侧是节点库，右侧是配置面板，底部是调试面板。这些区域的详细说明请参阅任务管理 → 任务编辑器。
画布
画布是您组装流程的地方：
- 拖放——从左侧节点库将节点拖到画布上。
- 连线——从一个节点的输出端口拖到另一个节点的输入端口，即可创建连线。连线会进行类型兼容性校验。
- 缩放与平移——通过缩放和拖动来浏览大型流程。
- 空画布提示——画布为空时会出现引导按钮，帮助您添加第一个步骤。
节点类型
您可以用以下节点类型构建工作流：
| 节点类型 | 用途 |
|---|---|
| 智能体（Agent） | 调用 AI 智能体处理需要判断或生成的任务 |
| 操作节点（Operator） | 执行具体任务——调用 API、转换数据、发送通知、运行自定义代码等（参见操作节点） |
| 控制（Control） | 控制执行路径——分支与迭代 |
| 数据集（Dataset） | 查询或修改数据集 |
| 数据源（Data Source） | 连接并读取数据源 |
您可以从节点库添加节点，节点库分为 智能体、组件（操作节点）、数据集、数据源 和 控制流 等分类。
控制流
控制流分类中提供两个可拖放的控制节点：
- 条件分支（If-Else）——根据条件将执行路由到
true或false分支。参见条件分支节点。 - ForEach——遍历列表，为每个项目运行子流程。参见 ForEach 循环节点。
备注
引擎也支持 Switch（多分支）控制节点，但它未作为可拖放节点出现在控制台构建器中——调色板中仅有 If-Else 和 ForEach。详情请参阅 Switch 分支节点。
在节点之间连接数据
节点沿连线传递数据。连线使用 nodeId:portName 形式将源端口连接到目标端口，并可选地用 dataPath 选取源输出的一部分。连线的确切格式与示例请参阅操作节点 → 数据如何在节点之间流动。
节点输入和连线值支持 {{VARIABLE_NAME}} 环境变量模板语法——请参阅环境变量。
错误处理与重试
错误处理在任务级别配置（位于任务的高级配置中），而不是作为单独的节点。可用设置包括：
| 设置 | 说明 |
|---|---|
| 最大重试次数 | 失败运行的重试次数（0–10） |
| 重试间隔 | 两次重试之间的等待时间，单位毫秒（最小 1000） |
| 重试策略 | fixed（固定间隔）或 exponential（指数退避） |
| 失败动作 | 失败时的处理方式：retry、notify 或 stop |
| 启用通知 | 失败时是否发送通知 |
您可在创建或编辑任务时设置这些项。请参阅任务管理 → 高级配置。
要在流程内部针对错误进行分支，可将操作节点的输出与 条件分支 控制节点结合使用。
构建工作流的典型步骤
- 打开任务编辑器（对任务点击配置，或创建新任务）。
- 打开节点库（
Ctrl + K），将第一个节点拖到画布上。 - 添加流程所需的操作节点、智能体、数据集和数据源节点。
- 用连线连接节点，必要时用
dataPath选取字段。 - 添加 条件分支 / ForEach 控制节点以实现分支与迭代。
- 在右侧面板（
Ctrl + I）中配置每个节点，并在配置中设置任务级的重试 / 失败处理。 - 保存改动，然后点击立即运行并在底部调试面板中查看实时日志。