随着大语言模型 (LLM) 能力的不断演进，单一 Prompt 或单节点 Agent 在面对复杂工程落地时往往表现出上下文丢失、幻觉泛滥与状态失控的问题。本文分享 Pocketmelon 团队在生产环境中构建多智能体协同系统 (Multi-Agent System) 的核心架构设计。
一、单 Agent 瓶颈与多 Agent 解耦
在复杂软工程开发或数据处理场景中，要求单个 Prompt 涵盖需求分析、代码编写、质量审计与测试运行是不切实际的。Pocketmelon 采用了“职责单一化 (Single Responsibility Principle)”的解耦策略：
- Orchestrator（主控智能体）: 负责全局规划、任务分解与子节点调度。
- Explorer（勘测智能体）: 负责只读分析、代码库检索与可行性验证。
- Implementer（执行智能体）: 负责具体的代码编写与接口实现。
- QA / Auditor（审计智能体）: 负责独立的单元测试执行与黑盒/白盒对抗校验。
二、编排层与状态机设计
多 Agent 系统的核心难点在于节点通信的可靠性与状态防脱轨。我们构建了基于有向无环图 (DAG) 的状态机控制网格。
2.1 五要素 Handoff 协议
智能体之间的交付 (Handoff) 必须是绝对自包含的。我们规定每一次 Hand-off Report 均需包含以下 5 项要素：
- Observation（直接观测）: 包含文件路径、行号、精准报错与工具输出。
- Logic Chain（推导链条）: 从观测现象到结论的逐级推导过程。
- Caveats（注意事项）: 未覆盖边界与假设条件。
- Conclusion（最终结论）: 可落地的评估方案。
- Verification Method（验证方法）: 可直接运行的复现或测试命令。
2.2 自动审计与自愈机制
任何 Agent 产出的代码更改，在合入主干前必须经过 QA 智能体的对抗测试 (Adversarial Audit)。若构建失败或测试未通过，状态机会捕获完整的 stderr 堆栈信息并触发自动修复循环 (Self-Correction Loop)，直至满足质量门禁。
三、工程实践与案例分析
在 Pocketmelon 内部的数字基础设施与客户定制 B2B 系统交付中，该 Agent 架构将复杂的端到端迭代周期缩短了 60% 以上，同时将人工介入率降至最低。未来我们将继续推行 Agent 运行态的透明可监测化。