用途:为多智能体系统选择合适拓扑提供决策矩阵。先回答四个任务特征问题(子任务是否可并行且无共享状态、任务类型是否在设计期确定、是否需要多阶段子编排、错误结果是否需多评审者一致),再据此选型。
主要拓扑与相对 token 成本:Conductor 约 6x(顺序阶段、默认模式);Supervisor 约 5x(已知任务类型、确定性路由);Fan-out/Fan-in 约 8x(并行评审、map-reduce);Swarm 约 8x(独立任务、负载均衡、容错);Consensus Voting 约 12x(高风险决策);Hierarchical 约 15x(EPIC 复杂度、多阶段子编排)。成本为相对单智能体的数量级指导。
失败模式与处置:SE-M01 协调者过载(Supervisor、Conductor、Hierarchical 根),可分散协调或加路由副本;SE-M02 Swarm 死锁(Swarm、Consensus Voting),可设超时加大多数投票与裁决,并设置 consensus_timeout_ms;SE-M03 级联失败(Hierarchical),可在各层加断路器、退避重试与回退代理;SE-M04 token 失控(Hierarchical),可设 max_depth=3 并按层监控预算;SE-M05 孤儿任务(Swarm),可分配任务 ID、用 TaskUpdate 跟踪,并在领取时调用 TaskUpdate(in_progress)。
升级路径:TRIVIAL 用单智能体;LOW 用 Supervisor;MEDIUM 用 Conductor + Fan-out;HIGH 用 Hierarchical;EPIC 用 Hierarchical + Consensus Voting(最多 3 层加投票门)。
使用要点:默认从 Conductor 开始;Hierarchical 不超过 depth=3;Swarm 领取任务时先调用 TaskUpdate(in_progress);仅在真正高风险决策加共识门;确定拓扑前交叉核对失败模式。避免对有序依赖任务使用 Swarm,避免在同一编排范围混用多种主拓扑。提供代码评审、功能实现、架构决策、批量创建智能体等示例。限制:未提供具体平台、安装命令或定价信息。