common_agent/设计文档/4.Workflow编排模块设计.md

Workflow 编排模块设计

1. 核心模型

对象	说明
Studio 项目	聚合多个 Workflow、Agent 和发布配置
Workflow 定义	可编辑流程主数据
Workflow 版本	发布或草稿快照，保存 graph_json
Workflow 运行	一次测试或正式运行
Workflow 步骤	单个节点的输入、输出、耗时和错误

2. 图模型

workflow_version.graph_json 保存节点与边：

• 节点：id、type、label、config、position
• 边：from、to、condition

图模型由后端做最小结构校验，复杂交互由前端画布负责。

3. 运行链路

flowchart LR
    Start["Start"] --> Retrieve["Knowledge Retrieval"]
    Retrieve --> LLM["LLM"]
    LLM --> Tool["MCP Tool"]
    Tool --> Skill["Skill"]
    Skill --> Answer["Answer"]

4. 状态设计

• Workflow 定义状态：草稿、启用、停用、归档。
• 发布状态：草稿、已发布、已归档。
• 运行状态：排队中、运行中、成功、失败、取消。
• 节点状态：等待、运行中、成功、失败、跳过。

5. 依赖关系

• Knowledge Retrieval 节点依赖知识资产模块。
• LLM 节点依赖模型与路由模块。
• MCP Tool 节点依赖 MCP 模块。
• Skill 节点依赖 Skill 模块。
• 运行记录被运行观测模块消费。