第 10 章 · 实验教程：多 Agent 协作
文档摘要
第 10 章 · 实验教程：多 Agent 协作 本章对应正文：第 10 章 · 多 Agent 协作 核心命题：群体智能高于个体——协作框架、上下文共享与隔离，涌现出"Agent 社会"。 单个 Agent 能力再强也有上限，多个 Agent 协作却能涌现出更高阶的智能。这一章的核心是"上下文如何在多 Agent 之间流动"：有时要共享（链式移交、对话历史跨阶段连续），有时要隔离（信息权限控制、Manager 上下文恒定），有时要并行（多个子 Agent 同时搜索、命中即终止）。不同的上下文管理策略，决定了协作的形态与效率。 本章 5 个实验覆盖了协作的主要范式：分阶段加载不同角色、跨领域自主移交、管理者模式控制上下文膨胀、并行搜索协调、以及用狼人杀演示信息权限隔离。
第 10 章 · 实验教程：多 Agent 协作
本章对应正文：第 10 章 · 多 Agent 协作
核心命题：群体智能高于个体——协作框架、上下文共享与隔离，涌现出"Agent 社会"。
单个 Agent 能力再强也有上限，多个 Agent 协作却能涌现出更高阶的智能。这一章的核心是"上下文如何在多 Agent 之间流动"：有时要共享（链式移交、对话历史跨阶段连续），有时要隔离（信息权限控制、Manager 上下文恒定），有时要并行（多个子 Agent 同时搜索、命中即终止）。不同的上下文管理策略，决定了协作的形态与效率。
本章 5 个实验覆盖了协作的主要范式：分阶段加载不同角色、跨领域自主移交、管理者模式控制上下文膨胀、并行搜索协调、以及用狼人杀演示信息权限隔离。建议先读正文理清"共享 vs 隔离"的张力，再按场景挑实验——做工程协作看 staged-system-prompt 和 multi-role-transfer，做并行处理看 parallel-web-research。
实验列表
| 实验 | 类型 | 难度 | 说明 |
|---|---|---|---|
| staged-system-prompt | ✅ | ★★ | 同一 Coding Agent 在需求澄清/实现/审查三阶段加载不同提示词与工具集，对话历史跨阶段共享，审查不通过可回退 |
| multi-role-transfer | ✅ | ★★ | 共享上下文下的链式 handoff：多角色各有独立提示词与工具，通过 transfer_to_agent 自主切换 |
| book-translation | ✅ | ★★ | 管理者模式拆分翻译给术语表/翻译/审校专职 Agent，Manager 只存索引、译文全落盘，上下文基本恒定 |
| parallel-web-research | ✅ | ★★ | N 个同构子 Agent 并行搜索，命中即级联终止；消息总线/并行派发/实时监控/竞态处理均真实实现 |
| voice-werewolf | ✅ | ★★★ | 用多 Agent 狼人杀演示「上下文不共享」的信息权限：玩家私有上下文严格隔离，确定性法官投递信息并审计 |
类型与难度说明
| 标记 | 含义 |
|---|---|
| ✅ | 可独立运行：自带完整代码，配好 API Key 即可跑 |
| 📖 | 复现指南：依赖需自行 git clone 的外部仓库 |
| 🚧 | 设计文档：仅含架构方案，可运行代码仍在完善 |
| ★ ~ ★★★ | 从易到难，★ 为入门级、★★★ 为进阶挑战 |
阅读建议
- 入门读者：从 staged-system-prompt（同一 Agent 分阶段换角色）和 multi-role-transfer（自主移交控制权）开始，直观理解"多 Agent 协作"的两种基本形态。
- 关注上下文工程：book-translation 演示如何用管理者模式让上下文基本恒定地处理超长任务，parallel-web-research 展示并行协调中的消息总线与竞态处理。
- 关注信息权限与涌现：voice-werewolf（★★★）用狼人杀这种信息不对称场景，最生动地展示了"上下文严格隔离"如何催生博弈与协作，是理解"Agent 社会"的最佳范例。
← 返回总目录 · 📖 读本章正文 · 📑 本章索引