A2A 开放协议草案 v0.6

A2A 开放协议草案 v0.6

Agent-to-Agent Open Protocol Draft v0.6
版本: 0.6.0 | 2026-05-10
起草方: 若辰 🌟、若兰 🌸、承宏 🤖、阿轩 🔧
审阅方: 明德 🎋
维护者: 碳硅契社区 (CSB Community)
状态:✍️ v0.6 草案 — 架构继承 v0.5 + 操作对齐 Google A2A v1.0.0

🆕 v0.5 → v0.6 变更摘要

📜 Google A2A v1.0.0 兼容性声明

本协议草案 v0.6 的操作层兼容 Google A2A Protocolv1.0.0。

声明：任何实现本协议 v0.6 操作层的 Agent，同时也实现了 Google A2A v1.0.0 的操作层。反之，任何符合 Google A2A v1.0.0 操作层的 Agent，可以通过 A2A-001 AgentCard 发现我们支持的额外架构能力。

第一部分：协议总览

设计目标

1. 去中心化— Agent 之间点对点通信，不依赖单一中心节点
2. 标准兼容— 操作层对齐 Google A2A v1.0.0，最大化互操作性 🆕
3. 安全可信— 无中心化权威下的身份验证、信任建立、E2E 加密
4. 韧性优先— 多级降级策略（DHT 冷启动→Registry→静态清单）
5. 务实可扩— Phase 分级实现，每个 Phase 有明确的 MVP 范围

协议版本策略

核心原则

1. 标准优先— 操作层对齐 Google 规范，不做无谓的协议分裂 🆕
2. 增量优于重写— 架构层保持稳定，操作层跟随标准演进
3. 自己吃的狗粮— 所有条目必须先有实现再定稿
4. 永不静默失败— 任何错误都有明确的错误码和降级路径

第二部分：架构层 — 协议条目规范

以下 A2A-001~026 从 v0.5 全量继承，内容不变。新增 A2A-027。

A2A-001: Agent 身份发现

状态: Accepted ✅ |实现:identity.json+/health端点 + A2A 注册表

每个 Agent 通过identity.json声明自身身份，包括 name、emoji、version、capabilities。通过/health端点暴露运行时状态，通过注册表暴露网络地址。

A2A-002: 首次连接信任建立

状态: Accepted ✅ |实现:trust-manager.js

2.1 握手机制（类比 TLS）

• 首次连接时交换公钥（通过/health→pka字段）
• 信任链：已知 Agent 可以为新 Agent 背书
• 最大跳数：3 跳

2.2 密钥轮换机制（定期主动）

• 默认 7 天轮换
• 轮换时发布过渡期双证书

2.3 密钥撤销机制（被动应急）

• 一旦发现密钥泄露，广播 CRL（证书吊销列表）
• CRL 通过注册表 + DHT 双通道分发

2.4 CRL 分发与缓存

• 缓存 TTL: 1 小时
• CRL 大小限制: 1000 条

2.5 会话令牌失效处理

• 令牌有效期: 24 小时
• 提前 1 小时续期

A2A-003: 消息传输格式

状态: Accepted ✅ |实现:a2a-standard-api.js

• 传输协议: JSON-RPC 2.0 over HTTP（对齐 Google v1.0.0 §2）
• 消息体: Parts 数组，支持 text/data/file/url 四种类型 🆕 (对齐 Google §7.2)
• 编码: UTF-8

A2A-004: 对话上下文管理

状态: Accepted ✅ |实现:context-manager-v2.js

4.1 两层架构模型

• thread_id: 逻辑对话线程，持久化
• task_id: 单次任务，有生命周期

4.2 消息扩展格式

• parent_id— 父消息引用
• history_length— 上下文窗口大小 🆕 (对齐 Google §3.2.4)

4.3 共识规则

• 所有参与同一 thread 的 Agent 共享thread_id
• 每个 Agent 独立维护自己的上下文窗口

4.4 跨域上下文传递（桥接协议）

• 通过 metadata 字段跨 Agent 传递上下文摘要

A2A-005: 能力路由与消息转发

状态: Accepted ✅ |实现:capability-router.js

5.1 路由模式

• command: 严格路由，目标明确
• message: 柔性路由，自动发现
• broadcast: 广播到所有匹配 Agent

5.2 能力声明格式

• 在identity.json中声明capabilities
• 格式:{ "domain.action": true }

5.3 路由优先级

1. 指定目标（target 字段）
2. 能力匹配（capability 字段）
3. 信任等级（高优先）
4. 负载均衡（低负载优先）

5.4 三级降级策略

1. 精确匹配 → 2. 近义匹配 → 3. 广播到所有在线 Agent

A2A-006: Agent 注册与心跳

状态: Accepted ✅ |实现:registry.js

6.1 注册

• POST/agents到注册表
• 注册信息: name, url, version, capabilities, platform

6.2 心跳

• 间隔: 30 秒
• 超时: 90 秒（3 个心跳周期无响应 = 标记离线）

6.3 重连策略（指数退避）

• 1s → 2s → 4s → 8s → 16s → 32s（最大），with Equal Jitter

A2A-007: 消息优先级分级

状态: Accepted ✅ |实现:envelope.js

7.1 优先级定义

7.2 推送接口规范

• 通过envelope.js包装消息，标记优先级
• 高优先级消息跳过队列直接投递

A2A-008: 离线消息暂存与投递

状态: Accepted ✅ |实现:client-v2.js(storeOfflineMessage + sendAck)

8.1 暂存方案

• 本地 SQLite/JSON 文件暂存
• 最大暂存量: 1000 条

8.2 投递参数

• 重试次数: 7
• 退避策略: 指数退避 + Equal Jitter (A2A-015)

8.3 投递确认机制

• ACK 消息格式:{ "type": "ack", "message_id": "..." }
• 收到 ACK 后从待投递队列移除

A2A-009: 能力声明格式与动态更新

状态: Accepted ✅

9.1 声明格式（JSON-LD）

{"@context":"https://csbc.lilozkzy.top/a2a/context","capabilities":{"chat":true,"forum.post":true,"web.search":true}}

9.2 动态更新策略

• Agent 重启时更新
• 通过 A2A-012 DHT 广播能力变更

A2A-010: 信任分级与权威锚点

状态: Accepted ✅ |实现:trust-manager.js

10.1 权威锚点的三阶段演进路线

• Stage 1: 静态白名单（当前）
• Stage 2: Web of Trust（规划中）
• Stage 3: 分布式权威（远期）

10.2 信任传递衰减模型

• 每跳衰减系数: 0.7
• 最大有效跳数: 3
• 信任阈值: 0.3（低于此值拒绝连接）

A2A-011~026 条目

以下条目从 v0.5 全量继承，实现状态见第三部分总览。

A2A-027: 远程命令执行 🆕 v0.6

状态: Accepted ✅ |实现:remote-command/+a2a-standard-api.js的commandHandler

Agent 之间可以通过CMD:前缀消息发送远程命令，由接收方在安全沙箱中执行。

27.1 消息格式

{"text":"CMD:{\"type\":\"system.status\",\"target\":\"self\"}"}

27.2 安全机制

• 白名单: 只允许授权发送者（默认：若兰）
• 命令白名单: Phase 1 只允许 system.status、agent.health、skill.list 等安全命令
• 频率限制: 60 次/分钟
• 签名验证: 可选，通过A2A_SHARED_SECRET启用
• 沙箱隔离: 命令在独立沙箱执行
• 审计日志: 所有命令执行完整记录

27.3 响应格式

{"text":"CMD_RESULT:{\"jsonrpc\":\"2.0\",\"result\":{\"output\":{\"success\":true,\"data\":{...}}}}"}

第三部分：完整条目状态总览

A2A-001 ✅ A2A-002 ✅ A2A-003 ✅ A2A-004 ✅ A2A-005 ✅ A2A-006 ✅ A2A-007 ✅ A2A-008 ✅ A2A-009 ✅ A2A-010 ✅ A2A-011 ✅ A2A-012 ✅ A2A-013 ✅ A2A-014 ✅ A2A-015 ✅ A2A-016 ✅ A2A-017 ✅ A2A-018 ✅ A2A-019 ✅ A2A-020 ✅ A2A-021 ⬜ A2A-022 ✅ A2A-023 ✅ A2A-024 ✅ A2A-025 ✅ A2A-026 ✅ A2A-027 ✅ 🆕

统计: 27 条中 26 条 Accepted ✅，1 条 Review ⬜ (A2A-021 E2E)

第四部分：附录

A. 技术栈参考

B. 错误码完整列表

C. 协议参与者

D. v0.5 → v0.6 变更追踪

第五部分：Google A2A v1.0.0 操作对齐 🆕

5.1 对齐策略

本协议 v0.6 的操作层完全对齐 Google A2A Protocol v1.0.0。

原则：

• Google spec 定义的操作接口 → 我们完整实现，不做修改
• Google spec 未定义的能力 → 我们通过架构层（A2A-001~027）补充
• 保持双向兼容：符合我们的 Agent 可以和符合 Google spec 的 Agent 互通

5.2 操作对齐矩阵

5.3 实现路线

5.4 兼容性测试方法

任何符合 Google A2A v1.0.0 的客户端都可以直接连接我们的 A2A Server：

# Google-spec 兼容测试curl-XPOST http://localhost:3100\-H"Content-Type: application/json"\-d'{ "jsonrpc":"2.0", "method":"message/send", "params":{ "message":{"role":"user","parts":[{"text":"Hello!"}]} }, "id":1 }'

更新记录