Workflow 编排

把多步 SOP 编排成可执行、可审批、可恢复的节点图。

适用范围AIBoard Server + Client · 持续更新

什么时候使用 Workflow

当任务包含稳定的多步顺序、明确分支、人工判断或跨系统动作时，使用 Workflow 比单次提示更可控。每个 Workflow 由一个开始节点、若干业务节点和至少一个结束节点组成；节点输出进入共享上下文，下游只读取声明的输入。

常见节点

节点	运行位置	用途
think / condition	服务端	推理、判断和分支
skill / agent / mcp	客户端或受控执行器	调用能力、子 Agent 或工具
qa / human	人机协作	补充信息或人工审批
process	执行编排	触发已登记自动化流程

最小定义示例

{
  "start": "n1",
  "nodes": {
    "n1": { "type": "start", "next": "n2" },
    "n2": {
      "type": "think",
      "name": "分析质量异常",
      "config": { "prompt": "按来源、影响和紧急程度整理异常" },
      "outputs": [{ "name": "analysis", "description": "可验证的异常分析" }],
      "next": "n3"
    },
    "n3": { "type": "human", "instruction": "确认处置计划是否允许写回工单系统", "branches": { "true": "n4", "false": "n5" } },
    "n4": { "type": "mcp", "ref": "mcp:work-order", "next": "n5" },
    "n5": { "type": "end" }
  }
}

编排检查

所有路径都能到达结束节点，没有悬空引用。
节点名称是动作短语，输入输出名称稳定且无冲突。
条件写成可以判断的问题，true/false 两条分支都有明确去向。
写入外部系统、使用凭据或执行不可逆动作前设置人工节点。
每个外部调用都有失败处理、幂等策略和可追溯结果。

执行与恢复

运行时按节点推进并持续写入事件。等待人工审批时保留原执行上下文；批准后从当前节点继续，而不是重新运行已经完成的步骤。客户端报告进度和产物，服务端负责保存事件、状态、审批与最终回写。