# Multi-Agent Wiki

> A working reference for multi-agent interaction patterns, classification, and engineering implementation. Each pattern answers four questions: what problem it solves, what its communication structure is, how to implement it in a real system, and when *not* to use it.

Site sections:

- [多 Agent Wiki](/) — 多 Agent 交互模式、分类法和工程实现的系统性参考。
- [分类法](/taxonomy) — 多 Agent 模式的五维分类法
- [决策矩阵](/decision-matrix) — 按任务特征选择多 Agent 模式

## Patterns

- [监督者 / 管理者模式](/patterns/supervisor-manager) — 主 Agent 负责规划、路由和综合汇总；专家 Agent 执行子任务。
- [Agent 即工具模式](/patterns/agents-as-tools) — 将专家 Agent 封装为工具；主 Agent 保持对话控制权。
- [交接 / 路由 / 转移模式](/patterns/handoff-router) — 当前 Agent 将对话控制权转移给另一个 Agent。
- [层级分解](/patterns/hierarchical-decomposition) — 多层管理者-执行者体系——上层分解任务，下层执行，可按需递归。
- [图/状态机/工作流](/patterns/graph-workflow) — 用显式的图或状态机定义流程，而非让 LLM 即兴发挥。
- [点对点/群体协作](/patterns/peer-swarm) — 无固定中心；Agent 通过直接消息、共享环境或动态交接自组织。
- [协调器 / 调度器](/patterns/coordinator-dispatcher) — 跨 Agent 、工作流和工具分发请求——管理任务状态、重试、超时和路由。
- [顺序流水线](/patterns/sequential-pipeline) — 任务按固定顺序经过多个 Agent；每步的输出作为下一步的输入。
- [并行扇出 / 汇聚](/patterns/parallel-fanout-gather) — 将任务并行拆分到多个 Agent；由汇聚器合并结果。
- [群聊 / 会议](/patterns/group-chat) — 多个 Agent 共享一个线程；由主持人或选择器决定谁下一个发言。
- [嵌套对话 / 内部团队](/patterns/nested-chat) — 一个 Agent 在向外部回复之前，先运行一个内部多 Agent 子对话。
- [黑板 / 共享内存 / 工作区](/patterns/blackboard-shared-memory) — Agent 通过共享状态、知识库、任务板或工作区间接协作。
- [事件总线 / 发布-订阅](/patterns/event-bus-pubsub) — Agent 通过事件、主题或队列进行异步通信——而非直接调用。
- [辩论 / 裁判](/patterns/debate-judge) — 多个 Agent 进行辩论；由裁判机制得出结论。
- [生成器-评审者 / 验证器](/patterns/generator-critic) — 一个 Agent 负责生成；另一个负责评审、验证、评分或提出修改建议。
- [迭代优化循环 / 评估器-优化器](/patterns/refinement-loop) — 生成 → 评估 → 修正，直到满足退出条件或达到预算上限。
- [市场 / 拍卖 / 合同网](/patterns/market-auction-contract-net) — 任务和资源通过竞标、定价或合同网协议进行分配。
- [混合代理 / 分层集成](/patterns/mixture-of-agents) — 多个模型或 Agent 分层堆叠；每一层读取多个前序输出并加以改进。
- [投票 / 集成](/patterns/voting-ensemble) — 多个 Agent 独立产出候选答案；通过投票、评分或验证器选出最终结果。
- [边缘澄清 / 行动前询问](/patterns/clarification-at-edge) — 在 Agent 间交接边界或不确定操作前插入澄清步骤。
- [角色扮演 / SOP / 虚拟公司](/patterns/role-playing-sop) — Agent 扮演产品、架构师、开发、QA 等角色，按文档化 SOP 约束协作。
- [人在回路 (Human-in-the-loop)](/patterns/human-in-the-loop) — 将人类视为特殊 Agent——参与审批、纠正、路由、中断或最终决策。
- [工作区 / 沙箱隔离](/patterns/workspace-isolation) — 每个 Agent 在独立的工作区、git worktree、容器或沙箱中运行。
- [共识主动性 / 环境中介协作](/patterns/stigmergy-environment-mediated) — Agent 通过在环境中留下痕迹来协作，其他 Agent 观察并做出反应。
- [协议中介的 Agent 网络](/patterns/protocol-mediated) — 通过标准协议（MCP、A2A、ACP）连接工具、Agent 、客户端和平台。
- [组合模式](/patterns/composite-pattern) — 真实生产系统将流水线、并行、交接、评审、人在回路、黑板和协议层组合在一起。
- [联盟 / 联邦 / 合弄组织](/patterns/coalition-federation-holonic) — Agent 围绕任务形成临时联盟、团队、联邦或合弄。
- [社会仿真 / Agent 社会](/patterns/social-simulation) — 仿真一个群体、组织或社会，包含长期记忆、关系和涌现行为。
- [MARL / CTDE (多 Agent 强化学习)](/patterns/marl-ctde) — 多 Agent 强化学习，采用集中训练、分散执行范式。

## Implementation

- [生产级多 Agent 运行时](/implementation/production-runtime) — 面向内部编码 Agent 平台和 Agent 后端的架构
- [编排器实现指南](/implementation/orchestrator) — 多 Agent 平台的调度器、路由器和状态机
- [可观测性与事件模型](/implementation/observability) — 多 Agent 平台的追踪、事件和指标设计。
- [安全、权限与护栏](/implementation/safety-guardrails) — 多 Agent 平台的安全边界设计。
- [Wiki 内容模型](/implementation/content-model) — 如何为每个多 Agent 模式编写页面。
- [模式页面模板](/implementation/pattern-page-template) — 添加新的多 Agent 模式页面时使用此模板。

## Reference

- [术语表](/reference/glossary) — 多 Agent 常用术语
- [参考资料](/reference/references) — 多 Agent Wiki 引用的公开来源

## Full content

- [/llms-full.txt](/llms-full.txt) — every wiki page concatenated as plain markdown.

## Source

- [GitHub](https://github.com/riba2534/multi-agent-wiki-cn)