2.6 KiB
2.6 KiB
title, type, tags, last_updated
| title | type | tags | last_updated |
|---|---|---|---|
| Agent Collaboration Protocol | concept | 2026-05-02 |
Definition
规范化多 Agent 协作流程——定义何时发起协作、协作内容模板、协作边界及交接合同。
Overview
在多 Agent 系统中，不同 Agent 负责不同专业领域。Agent Collaboration Protocol 为每个协作节点定义标准化协议，确保信息传递完整、意图清晰、交接无遗漏。
Core Components
协作发起时机
- 交接点：当前 Agent 工作完成后、需要下游 Agent 承接时
- 依赖点：当前 Agent 需要上游 Agent 输出时
- 冲突点：发现超出自身职责范围的问题时
- 安全点：涉及凭证/密钥/认证等安全敏感操作时
协作内容模板
每个协作请求必须包含：
- 上下文摘要：工作进展和已完成内容
- 具体请求：需要对方完成什么
- 交付物格式：期望的输出格式和结构
- 约束条件：时间限制、质量标准、特殊要求
- 交接合同：交接数据的 schema 定义
协作边界
- 不越权：不在自身职责外做决策
- 不兜底：发现超出范围的问题时立即上报，而非自行处理
- 不丢失：每次协作记录到 log.md，确保可追溯
Workflow Architect 中的协作协议
| 协作方 | 时机 | 内容 | 交付物 |
|---|---|---|---|
| Reality-Checker | Draft spec 完成后、标记 Review 前 | 规范与实际代码差距验证 | Reality Checker Findings 表 |
| Backend-Architect | 发现实现缺陷时 | 补充缺失逻辑（重试/错误处理） | 修复代码 |
| Security-Engineer | 涉及凭证/密钥/认证/API 调用时 | 凭证传递机制安全性审查 | 安全评估意见 |
| API-Tester | Spec 标记 Approved 后 | 生成全部测试用例 | 自动化测试脚本 |
| DevOps-Automator | 揭示基础设施销毁顺序需求时 | 验证 IaC 销毁顺序 | 销毁顺序确认 |
Key Principles
- 主动发起：发现需要协作时立即发起，不等待
- 标准化模板：每次协作使用统一格式，减少理解成本
- 明确边界：知道自己不做什么，比知道自己做什么更重要
- 完整交接：交接内容包括所有上下文，而非仅最终结果
Related Concepts
- Handoff-Contract：协作交接的数据 schema 定义
- Reality-Checker：Workflow Architect 的首个强制协作节点
- Workflow-Tree-Spec：协作产出的主要载体
Aliases
- Multi-Agent Handoff Protocol
- Agent Coordination Framework
- Inter-Agent Collaboration Standard