63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
---
|
||
title: "Agent Collaboration Protocol"
|
||
type: concept
|
||
tags: []
|
||
last_updated: 2026-05-02
|
||
---
|
||
|
||
## Definition
|
||
|
||
规范化多 Agent 协作流程——定义何时发起协作、协作内容模板、协作边界及交接合同。
|
||
|
||
## Overview
|
||
|
||
在多 Agent 系统中，不同 Agent 负责不同专业领域。Agent Collaboration Protocol 为每个协作节点定义标准化协议，确保信息传递完整、意图清晰、交接无遗漏。
|
||
|
||
## Core Components
|
||
|
||
### 协作发起时机
|
||
- 交接点：当前 Agent 工作完成后、需要下游 Agent 承接时
|
||
- 依赖点：当前 Agent 需要上游 Agent 输出时
|
||
- 冲突点：发现超出自身职责范围的问题时
|
||
- 安全点：涉及凭证/密钥/认证等安全敏感操作时
|
||
|
||
### 协作内容模板
|
||
每个协作请求必须包含：
|
||
1. **上下文摘要**：工作进展和已完成内容
|
||
2. **具体请求**：需要对方完成什么
|
||
3. **交付物格式**：期望的输出格式和结构
|
||
4. **约束条件**：时间限制、质量标准、特殊要求
|
||
5. **交接合同**：交接数据的 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
|