‌
‌
‌
‌
‌
‌
QIYA · 系统交付实践
首页交付闭环
生态店铺 GMV 清洗迁移供应链订单与履约中台激励结算与业财一体化异构数据同步平台复盘AI 研发工作台参考方法论如何放大
总规程(可复制给 AI)认知:价值上移需求:体检与规格设计:上下文与边界执行:工作单与编排AI 工程操作系统验证:闭环与缺陷库运行:排查与业务解答交付物标准
总规程(可复制)需求体检清单需求到规格模板Agent 工作单模板验收与验证清单AI 代码缺陷检查表
关于
首页交付闭环
证据生态店铺 GMV 清洗迁移供应链订单与履约中台激励结算与业财一体化异构数据同步平台复盘AI 研发工作台参考方法论如何放大
方法论总规程(可复制给 AI)认知:价值上移需求:体检与规格设计:上下文与边界执行:工作单与编排AI 工程操作系统验证:闭环与缺陷库运行:排查与业务解答交付物标准
资产包总规程(可复制)需求体检清单需求到规格模板Agent 工作单模板验收与验证清单AI 代码缺陷检查表
关于本站

第四部分 · 执行

11

多 Agent 编排:按依赖关系组织并行

在顺序、路由、并行、编排者-工作者与评估器模式之间选择,而不是为了数量使用多 Agent。

总规程★ 把这一页交给你的 AI
第一部分:认知01. 工程师价值没有消失02. AI-native 工程交付者
第二部分:需求03. 需求体检04. 需求反问清单05. 从需求到规格
第三部分:设计06. 上下文工程07. 规格驱动开发08. 架构边界
第四部分:执行09. Agent 执行10. Agent 工作单11. 多 Agent 编排12. 工具工作台13. AI 工程操作系统
第五部分:验证14. 验证闭环15. AI 代码缺陷库
第六部分:运行与解答16. 运行排查与业务解答17. 交付物标准
第七部分:实证18. 方法论如何放大
配套资产需求体检清单需求到规格模板Agent 工作单模板验收与验证清单AI 代码缺陷检查表

THESIS / 核心主张

多 Agent 的收益来自独立上下文和真实并行,成本来自重复上下文、集成冲突和更高验证负担。

OPERATING STEPS / 执行动作

把原则变成可以检查的动作。

  1. 先画依赖图再决定并行
  2. 共享事实通过冻结契约交接
  3. 审查者只看规格与差异
  4. 同一文件或同一决定不并行修改

OUTPUTS / 交付物

每个阶段都要留下可复用的产物。

01任务依赖图
02角色与工具权限
03集成顺序和冲突记录

APPLIED CASE / 项目映射

这条方法如何落到真实项目?

九个平台可在总控契约冻结后并行核验;汇总逻辑、统一模型与公共规则需要单点所有权。

生态店铺 GMV 清洗迁移异构数据同步平台

FULL CHAPTER / 完整正文

从结论摘要,继续读到判断依据和执行细节。

正文保留 site-v3 的完整论证结构,并将贯穿示例改写为生态店铺 GMV 清洗迁移;原作者身份、原演示案例和未经证实的个人成果不进入本站。

多 Agent 编排:分角色,不一锅端

多 Agent 不是为了炫技,而是为了职责分离和独立验证。它有真实的成本,所以必须算得过账。

单个 AI 会话容易形成闭环幻觉:它写了代码,又解释为什么这样写,再生成一组刚好通过的测试——整个过程自洽,但没有任何环节独立于其他环节(机制见 Agent 执行的自我偏好与上下文污染分析)。多 Agent 编排的价值,就是把工程交付中的不同职责拆进互相独立的上下文。

一、编排模式:行业已有公共词汇

多 Agent 不是自由发挥的组合,Anthropic 在《Building Effective Agents》中总结的五种基础模式已成为行业公共词汇。本站的执行链路是其中三种的组合:

模式 含义 在 GMV 清洗迁移中的位置
链式(prompt chaining) 上游产物作为下游输入,顺序执行 需求审查 → 架构 → 实现的主干
并行(parallelization) 无依赖任务同时执行 测试与文档同时展开;多视角 review
评估-优化(evaluator-optimizer) 一个执行、一个评审,循环收敛 Review Agent → 修复 Agent → 回归
路由(routing) 按任务类型分发给不同处理者 本站用任务分级承担此职能
编排者-工作者(orchestrator-workers) 动态拆分子任务 用于案例级的大型交付

用公共词汇描述自己的流程有个务实的好处:可以被同行检验。"我的链路 = chaining + parallelization + evaluator-optimizer 的组合"是可讨论的工程方案;"我发明了一套多 Agent 体系"不是。

二、角色与链路

Agent 职责 产物
需求审查 检查需求缺口 待确认问题、风险清单
架构 检查规格自洽性 边界、契约、数据模型的审查报告
实现 按规格写代码 代码改动、实现说明
测试 按风险补测试 测试用例、覆盖与未覆盖说明
Review 独立审查产物 问题清单、修改建议
修复 根据失败结果修复 修复补丁、回归说明
文档 沉淀交付说明 使用文档、变更说明

GMV 清洗迁移链路的完整链路:

需求审查 ──→ 架构 ──→ 实现 ──┬─→ 测试 ──┐
                              └─→ 文档   ├─→ Review ⇄ 修复 ──→ 回归
                                         ┘

每个节点的输入输出和人工检查点见 Agent 执行的链路表;每个节点的任务书格式见 Agent 工作单。本章只补一条链路设计原则:评估-优化环(Review ⇄ 修复)必须有退出条件——通常是"回归全绿 + review 问题清零"或"循环三轮仍不收敛则升级人工"。没有退出条件的自动循环会在两个 Agent 互相礼貌地修改对方产物中烧掉预算。

三、成本模型:多 Agent 必须算得过账

多 Agent 的成本不是修辞,是可量化的。Anthropic 复盘自家多 Agent 研究系统时给过量级:单 agent 任务的 token 消耗约为普通对话的 4 倍,多 agent 系统约为 15 倍。在此之上还有两重开销:

  • 延迟:链式节点串行等待,每个节点还要冷启动读规格;
  • 集成协调:并行产物合并时的冲突检测与返工。

所以决策标准和任务分级完全一致:缺陷逃逸的代价 > 编排开销,才值得编排。 具体对照:

适合多 Agent:涉及多模块;有经营口径、存量数据和边界风险;需要影响面分析与独立核对;代码量大到单会话必然上下文稀释。

不适合多 Agent:文案与样式调整;单文件低风险改动(S 级);探索性原型;以及最重要的一条——需求本身还没澄清。需求不清时,多 Agent 只是让 N 个上下文并行地做出 N 组不同的默认假设,编排在放大混乱而不是控制混乱。

四、编排四规则

① 先规格,后并行

规格(数据模型、契约、状态机)未定稿前,只允许链式推进,不允许并行实现。并行的前提是所有分支共享同一份已冻结的事实——这就是规格驱动开发"先定不可逆决策"在编排层的投影。

② 并行分支之间必须有书面契约

字段、入参出参、错误码、状态流转、目录归属——全部落在文件里。两个 Agent 之间不存在"口头对齐":它们不共享记忆,唯一的通信信道就是写下来的契约。人类团队漏写契约靠茶水间补救,Agent 团队漏写契约直接集成失败。

③ 文件归属明确

每个 Agent 知道自己能改哪些文件、不能改哪些。两个 Agent 写同一个文件约等于必然冲突——边界怎么定义、怎么机器强制,见架构边界。

④ Review 独立

Review Agent 用干净上下文,输入只有规格 + diff,不继承任何实现会话。依据是验收清单和架构边界,不是"看看写得好不好"。这是整条链路里最不能省的一环——省掉它,多 Agent 就退化成了"多个会话的单 Agent",闭环幻觉原样回归。

五、典型失败模式

编排失败是有形状的,提前认识可以少交学费:

失败模式 原因 预防
集成冲突 规格未冻结就并行 规则①
假设分歧 契约留白,各分支自行脑补 规则②;契约里写"未尽事宜返回人工"而不是"合理处理"
重复劳动 范围重叠,两个 Agent 都改总控或共享规则 规则③ + 工作单【输入】指明已有组件与文件归属
礼貌循环 Review 与修复互改不收敛 评估环设退出条件与轮数上限
放大混乱 需求未澄清就编排 退回需求体检,编排不是澄清工具

六、本章小结

  • 多 Agent 的目的在职责分离与独立验证;用行业公共词汇(chaining / parallelization / evaluator-optimizer)描述链路,让方案可被同行检验。
  • 成本可量化:多 agent 系统约消耗普通对话 15 倍的 token,外加延迟与集成开销——缺陷逃逸代价高于编排开销才值得用。
  • 四规则:先规格后并行;分支间只有书面契约这一条通信信道;文件归属明确;Review 独立且不可省。
  • 评估-优化环必须有退出条件;需求未澄清时编排放大混乱。

下一章 工具工作台,讲这些流程如何被工具固化成默认动作。


参考资料

  • Anthropic, Building Effective Agents(2024)——五种编排模式的原始定义。
  • Anthropic, How We Built Our Multi-Agent Research System(2025)——多 agent 约 15 倍 token 消耗的实测量级与工程教训。
上一章Agent 工作单:把提示升级为工程任务下一章工具工作台:先增强感知,再增强操作
QIYA Engineering Notes企业系统、数据链路与 AI 应用实践记录
关于方法论项目复盘