A2A 协议规范

本部分把 A2A 规范按“先整体、后细节”的顺序整理成六页参考：先理解协议的分层与核心操作，再查数据结构的字段与智能体如何被发现，然后是安全要求、各协议绑定的细节，以及请求与响应的完整示例。完整、逐字的权威文本以官方规范和 a2a.proto 为准。

阅读顺序

页面内容
核心协议规范三层模型、11 个核心操作及三种绑定的映射、SendMessage 的行为、多轮标识符规则、错误与错误码、服务参数与版本协商
数据结构Task、Message、Part、Artifact、流式事件、推送配置、AgentCard 及安全方案的字段参考
智能体发现与 Agent Card发现机制、supportedInterfaces 选择与 tenant 规则、Agent Card 签名（JWS + JCS）、缓存要求
认证、授权与安全考量TLS 与客户端认证、授权范围限定、任务内授权（TASK_STATE_AUTH_REQUIRED）、推送通知与扩展 Agent Card 的安全、最佳实践
协议绑定详解JSON-RPC、gRPC、HTTP+JSON/REST 三种绑定的服务参数、错误与流式传输，以及 application/a2a+json、A2A-Version、A2A-Extensions、agent-card.json 的注册模板
常见交互流程与示例请求与响应示例：基础任务、流式传输、多轮交互、任务列表、推送通知、文件与结构化数据交换、扩展 Agent Card

版本与权威来源

  • 当前稳定版本为 v1.0，最新补丁版本为 v1.0.1（2026-05-28）。协议版本只由 Major.Minor 标识，补丁版本不影响协议兼容性；
  • a2a.proto 是所有协议对象和请求/响应消息的唯一权威定义，JSON Schema 与各语言 SDK 均由它生成；
  • 官方规范全文见 a2a-protocol.org 规范 ，历史版本见 v0.3.0 、v0.2.6 、v0.1.0 ；
  • 从 v0.3 升级请阅读 v1.0 版本变化与迁移指南 。

配合阅读