工作流编排

自动化工作流编辑器用于在画布中编排一条可执行流水线。管理员可以通过节点和连线定义输入、处理、分支、循环、资产保存和最终输出。

你可以在这里做什么

一、理解画布节点

开始节点和输出节点是流水线的边界。中间节点负责处理业务逻辑。

二、配置开始节点

开始节点决定运行流水线时要填哪些参数。

1. 选择开始节点。

1. 配置输入字段。
2. 为字段填写清晰的展示名称。
3. 设置字段类型和默认值。
4. 保存后打开试运行，确认输入表单符合预期。

输入字段要围绕业务任务设计。例如「产品名称」「目标平台」「素材链接」「生成数量」，不要把技术变量直接暴露给运营人员。

三、添加智能体或工作流节点

1. 点击添加节点。
2. 选择智能体、工作流或系统工作流。

1. 在节点配置中选择要调用的项目。
2. 配置输入映射，把上游字段传给该节点。
3. 检查输出字段，确认下游节点可以引用。
4. 保存并试运行。

节点之间的关键不是连线本身，而是字段映射。上游输出字段名变更后，下游引用也要同步检查。

四、配置条件分支

条件分支用于根据字段值选择不同路径。

1. 添加条件分支节点。

1. 配置「如果」条件。
2. 选择判断字段。
3. 设置判断关系，例如等于、包含、大于、小于。
4. 配置右侧比较值。
5. 保留「否则」分支作为兜底路径。

条件分支建议只处理明确规则。例如「平台等于小红书」「生成数量大于 5」。复杂判断应尽量在上游节点输出结构化字段后再分支。

五、配置循环

循环用于批量处理数组。

1. 添加循环节点。

1. 配置循环来源，通常是上游节点输出的数组字段。
2. 设置循环项变量和序号变量。
3. 设置最大循环次数，避免异常数据导致过量执行。
4. 在循环体内添加处理节点。
5. 配置循环输出字段。
6. 试运行小样本，确认每一轮输出都能汇总。

批量处理前先用 1 到 3 条数据测试，不要一开始就用大量数据跑正式流程。

六、配置保存资产

保存资产节点用于把流程产物沉淀到系统资产库或业务资产库。

1. 添加保存资产节点。

1. 选择要保存的资产库类型。
2. 配置要保存的字段，例如标题、正文、封面、文件链接。
3. 将上游输出映射到保存字段。
4. 试运行后确认资产库中出现记录。

如果保存字段映射错误，运行可能成功，但资产内容不可用。上线前必须到目标资产库检查一次真实记录。

七、配置输出节点

输出节点决定流水线最终返回什么。

1. 选择输出节点。

1. 添加输出字段。
2. 将字段映射到上游节点结果。
3. 设置展示名称和类型。
4. 试运行后查看输出预览。

输出字段不宜过多，只保留调用方真正需要的结果。内部调试字段可以在试运行日志中查看，不一定要进入最终输出。

八、试运行和日志

试运行用于在发布前验证整条链路。

1. 点击调试与运行。
2. 填写开始节点输入参数。
3. 点击立即开始。
4. 查看运行状态。
5. 切换到日志，检查每个节点是否成功。
6. 查看输出结果预览。
7. 如果失败，根据失败节点修改配置后重新运行。

试运行会先保存当前配置，再提交运行任务。不要只看最终结果，也要看节点日志，很多问题会在中间节点暴露。

九、发布前检查

1. 所有节点都有清晰名称。
2. 必填资源都已选择。
3. 字段映射没有引用不存在的上游字段。
4. 条件分支有兜底路径。
5. 循环设置了合理的最大次数。
6. 保存资产节点能写入目标资产库。
7. 输出节点返回了业务需要的结果。
8. 至少一次完整试运行成功。

十、常见问题

为什么保存前校验不通过？
检查节点是否缺少必填配置，尤其是资源选择、保存资产类型和插件动作参数。

为什么发布后结果还是旧的？
保存草稿不等于发布版本。修改后需要再次发布，正式调用才会使用新版本。

为什么下游节点拿不到上游结果？
通常是字段映射错误，或上游输出字段名变更后没有同步更新下游引用。