A2A v1：协议绑定、AgentInterface 与兼容性治理

A2A v1：协议绑定、AgentInterface 与兼容性治理

一句话结论

A2A v1 把 agent-to-agent delegation 从“一个 JSON-RPC 约定”推进到更正式的 protocol binding governance：规范声明 Latest Released Version 1.0.0，spec/a2a.proto 是数据对象和 request/response 的唯一权威定义；同一应用协议被映射到 JSON-RPC、gRPC、HTTP+JSON/REST 多种绑定；Agent Card 通过 supportedInterfaces[] 声明每个 interface 的 URL、protocolBinding 与 protocolVersion；v1.0 还引入/澄清 Agent Card signature、扩展、version negotiation、multi-tenancy、OAuth 更新、application/a2a+json media type、A2A-Version/A2A-Extensions header。^[raw/articles/a2a-v1-protocol-binding-governance-2026-09-09.md]

本轮读取了 A2A latest specification、What's New in v1.0、GitHub releases 摘要、官方 JS/Java SDK README。web_extract 观测 a2a-js 为 606 stars / 167 forks；GitHub API 对 A2A repos rate-limited，因此星数采用页面抽取值。官方 JS SDK README 明确其 v1.0 stable release 支持 JSON-RPC、HTTP+JSON/REST、gRPC，并提供 v0.3 backward compatibility。

命中的知识点轴

• A2A / Agent Card / Agent Discovery：Agent Card 从单 endpoint 自述升级为多 interface、versioned、可签名、可扩展的 delegation contract。
• MCP Gateway / federation control plane：gateway/registry 需要按 protocol binding、version、auth、extension、signature 和 trust tier 管理 A2A agents。
• harness-runtime：harness 必须知道当前调用走 JSON-RPC、REST 还是 gRPC，是否启用 v0.3 compatibility，如何 resubscribe/push/list tasks。
• context management：AgentInterface、capabilities、skills、auth、extensions 都是上下文 manifest，不应被扁平化成自然语言描述。
• benchmark-evaluation：A2A 实践案例不能只“能连上”，还应做协议兼容性、version negotiation、signature、auth、task lifecycle、push/stream 的 conformance tests。
• sandbox-security：OAuth flow 更新、extended card access control、file reference SSRF validation、push notification security 都是跨 agent 委托边界。

为什么对用户重要

如果 Hermes 未来接入多个远程 agent，A2A v1 的启发是：注册一个 Agent Card 不等于安全可用。真正的 registry entry 应是可执行合同：有哪些 interface，哪个是首选 transport，协议版本是什么，是否有旧版兼容层，extended card 是否要鉴权，Agent Card 是否可签名/验证，文件 URL 和 push webhook 如何防 SSRF/伪造，task/list/cancel/resubscribe 是否可恢复。

这也能帮助 llm-wiki 雷达过滤 A2A 噪音：只说“支持 A2A”的项目不够；有 v1 compatibility、transport matrix、AgentInterface、card signature、auth、task lifecycle 与 conformance evidence 的项目才值得深挖。

机制 / 一阶原理

1. 应用协议与传输绑定分离，减少生态漂移

v1.0 的规范结构把 Data Model、Operations、Protocol Bindings 分层，proto 作为权威定义，JSON schema/OpenAPI/SDK 都应从 proto 派生。这个设计防止每个 SDK 手写字段和错误码后互不兼容。对 MCP-Gateway-Runtime 来说，gateway 不应只转发 HTTP；还要理解它代理的是哪一层：应用语义、绑定映射、还是某个 SDK 的兼容层。

2. supportedInterfaces[] 让 Agent Card 变成 negotiation surface

v0.3 的 preferredTransport / additionalInterfaces 在 v1.0 合并为 supportedInterfaces[]，每个 interface 带 URL、protocolBinding、protocolVersion。这样上游 agent 不只是拿到一个 endpoint，而是要选择 transport、检查版本、决定是否可降级/兼容。Agent Card 也因此从“发现文本”升级为“可协商接口清单”。

3. Extended Agent Card 与签名把 discovery 拆成公开层和鉴权层

v1.0 把 extendedAgentCard 移到 capabilities，并澄清 Agent Card signature canonicalization。生产 registry 可先暴露最小 public card，再在鉴权后给出更完整 skill/endpoint 信息。对 Hermes 来说，这支持 selective disclosure：低信任任务只能看 public skill，高信任/授权任务才能获取敏感能力。

4. Compatibility layer 是迁移机制，也是评测变量

官方 JS SDK 的 v1.0 README 强调 v0.3 backward compatibility 是 opt-in。它让 staged migration 可行，但也意味着同一个 agent 在 v0.3/v1.0、JSON-RPC/REST/gRPC 下可能暴露不同字段或错误。Benchmark 和 audit receipt 必须记录 protocol version 和 binding，否则“A2A 调用失败/成功”不可解释。

和已有 wiki 概念的关系

• 对 A2A-Agent2Agent-Protocol：补齐 v1.0 版本化、multi-transport、AgentInterface、signature、extension 与 compatibility 细节。

• 对 MCP-Gateway-Runtime：A2A agents 与 MCP tools 都应进入统一 asset registry，但 agent entry 要多记录 task lifecycle 与 interface negotiation。

对 Hermes / llm-wiki 的可执行启发

1. A2A registry entry 增加 protocol-binding receipt。 字段包括 card_url、card_hash/signature、supportedInterfaces、preferred interface、protocolVersion、compat_mode、auth scheme、extended card policy、extension requirements。
2. A2A 调用报告记录 binding。 每次 task 应写明走 JSON-RPC/REST/gRPC，是否 stream/push/resubscribe，task id、context id、artifact id 和错误映射。
3. 雷达提升 official SDK / conformance evidence 权重。 有官方 SDK、transport matrix、migration guide、compat tests 的项目优先于只展示 Agent Card 的 demo。
4. 不要把 v0.3 教程当成 v1.0 实践。 A2A 教程/样例需要标注协议版本，否则容易把 preferredTransport、字段命名、OAuth flow、extended card 位置等旧规则带入新系统。

失败模式 / 边界条件

• 官方规范版本与第三方教程/SDK版本常不一致；入库时必须带日期和协议版本。
• 多 transport 增加 interop surface：JSON-RPC、REST、gRPC 的错误映射、streaming、headers、content type 可能不一致。
• Agent Card signature 只证明 card 未被篡改，不证明 agent 可靠；仍需 registry trust、endpoint probe、auth 和 artifact verifier。
• v0.3 compatibility layer 方便迁移，也可能隐藏旧字段/旧安全模型，应显式记录。

候选评分

深度判断

晋升为正式 source page，因为 A2A v1 的价值不只是版本新闻，而是给出跨 agent delegation 的协议治理边界：权威 proto、transport bindings、AgentInterface negotiation、签名、扩展、鉴权、版本兼容与 conformance testing。这些都能直接指导 Hermes 未来的 agent registry 与 A2A 调用 receipt。

写入记录

• 2026-09-09 09:01 CST：新增 A2A v1 来源页，沉淀 protocol binding governance、AgentInterface、version negotiation、extended card、signature、compatibility layer 与 Hermes A2A registry receipt。