A2A · 规范 1.0 · 2026-11
让一个 agent把活儿交给另一个 agent
A2A(Agent2Agent)是一套开放协议:不同公司、不同框架做出来的 agent,按同一套规矩互相发现、派任务、追问、交结果。对方内部用什么模型、什么工具、怎么推理,你不用知道,也看不到。
- 2025-04 由 Google 发布
- Linux 基金会托管
- 规范 1.0:首个稳定版
- 三种传输绑定
- 6 种语言官方 SDK
它和 MCP 管的不是一件事
MCP:往下接工具
你的 agent自己拿主意
调用函数、读数据
工具、数据库、API只会按参数干活
- 对方没有自己的判断,你说怎么调就怎么调
- 一次调用,一次返回
A2A:往外找同行
你的 agent把一件事委托出去
发消息、跟踪任务
别人做的 agent黑盒,自己拿主意
- 对方可能要干很久,中途还会反过来问你
- 你只看得到它的「名片」和交回来的结果
一次协作怎么走
下面的请求和响应照抄规范第 6 节的示例,用的是 HTTP+JSON 绑定。换成 JSON-RPC 绑定时,内容一样,只是外面包一层 {"jsonrpc":"2.0","method":"SendMessage",…}。
-
客户端 → 远端
先看名片:Agent Card
到对方域名下的固定路径取一份 JSON:
https://{域名}/.well-known/agent-card.json。名片里写着:skills:能干哪些事,附示例说法supportedInterfaces:在哪个地址、用哪种绑定说话securitySchemes:要怎么鉴权capabilities:支不支持流式、推送
-
客户端 → 远端
发一条消息
POST /message:send A2A-Version: 1.0 { "message": { "role": "ROLE_USER", "parts": [{"text": "Book me a flight"}], "messageId": "msg-1" } } -
远端 → 客户端
对方决定:直接回话,还是开个任务
简单问题,对方可以直接回一条 Message 了事。要真干活,就建一个 Task,把任务编号和状态回给你。任务慢的话,有三种方式跟进:
- 轮询:隔一会儿
GetTask问一次 - 流式:
SendStreamingMessage或SubscribeToTask,对方用 SSE 边干边推 - 推送:你留一个 webhook 地址,对方有进展就 POST 过来
- 轮询:隔一会儿
-
远端 → 客户端 → 远端
缺信息就反过来问你
任务状态变成
TASK_STATE_INPUT_REQUIRED,状态里附着对方的问题。你带上同一个taskId再发一条消息补充,任务接着跑:// 对方问 "status": { "state": "TASK_STATE_INPUT_REQUIRED", "message": { "role": "ROLE_AGENT", "parts": [{"text": "Where would you like to fly from and to?"}] } } // 你答 "message": { "taskId": "task-uuid", "role": "ROLE_USER", "parts": [{"text": "From San Francisco to New York"}], "messageId": "msg-2" } -
远端 → 客户端
交结果:Artifact
任务完成,产出放在
artifacts里:"task": { "id": "task-uuid", "contextId": "context-uuid", "status": {"state": "TASK_STATE_COMPLETED"}, "artifacts": [{ "artifactId": "artifact-uuid", "name": "Weather Report", "parts": [{"text": "Today will be sunny with a high of 75°F"}] }] }
五个核心概念
Agent Card名片
一份公开的 JSON,说明这个 agent 能干什么、怎么连、怎么鉴权。1.0 起名片可以带签名(
signatures),客户端能验证名片没被篡改。Task任务
干活的单位,有编号和状态,可能跑几秒,也可能跑几天。同一段对话里的多个任务和消息,用同一个
contextId串起来。Message消息
双方来回说的一轮话,角色只有两种:
ROLE_USER(委托方)和ROLE_AGENT(干活方)。Artifact产出
任务交出的成果,比如一份文档、一张图、一段结构化数据。和过程中的聊天消息分开放。
Part内容块
消息和产出都由若干个 Part 拼成。每个 Part 恰好装四种内容之一:
text文字、raw二进制字节、url文件链接、data任意 JSON,可以附带mediaType和filename。
任务的状态
SUBMITTED已提交
WORKING进行中
INPUT_REQUIRED等你补信息
AUTH_REQUIRED等你授权
终态:任务到此结束
COMPLETED完成
FAILED失败
CANCELED被取消
REJECTED对方不接
TASK_STATE_ 前缀,例如 TASK_STATE_COMPLETED。规范把橙色两种叫作「中断」状态:任务没结束,只是在等委托方。怎么传:三种绑定,挑一种说
同一个 agent 可以在名片的 supportedInterfaces 里同时列出几种绑定,客户端挑自己会的那种。每个请求都要带上 A2A-Version 头;不带时,对方按 0.3 版处理。
| 绑定 | 发消息 | 查任务 | 取消任务 |
|---|---|---|---|
| JSON-RPC 2.0 | SendMessage | GetTask | CancelTask |
| gRPC | SendMessage | GetTask | CancelTask |
| HTTP+JSON | POST /message:send | GET /tasks/{id} | POST /tasks/{id}:cancel |
鉴权不另起炉灶,名片里声明现成的方案:API Key、HTTP 认证(如 Bearer)、OAuth 2.0、OpenID Connect、双向 TLS。
现在能用什么
以下按各家官方文档核对,读取日期 2026-11-11。「支持」都是指框架或平台自己的文档写明了。
| 名称 | 是什么 | A2A 支持情况 |
|---|---|---|
| 官方 SDK | a2aproject 组织维护 | Python、JS/TS、Java、Go、.NET、Rust;另有 Inspector 调试工具、TCK 兼容性测试和示例仓库 |
| Google ADK | agent 开发框架 | 能对外提供 A2A 服务,也能调用远端 agent。Python 正式 Go / Java / Kotlin 实验性 |
| Microsoft Agent Framework | agent 开发框架 | A2AAgent 把远端 agent 当本地 agent 用,也能把自己的 agent 托管成 A2A 服务;C#、Python、Go |
| LangSmith Agent Server | LangGraph 的部署服务 | 内置 /a2a/{assistant_id} 端点,讲 1.0 的 JSON-RPC,兼容 0.3 方法名。gRPC、HTTP+JSON、推送尚未实现 |
| CrewAI | 多 agent 框架 | A2AClientConfig 委托出去,A2AServerConfig 对外接活 |
| 云平台 | 托管运行 agent | Linux 基金会点名:Azure AI Foundry、Copilot Studio、Amazon Bedrock AgentCore Runtime |
开源应用:多在基础设施这一层
按各项目自己的仓库或文档核对;star 数为 2026-11-11 的约数。
| 名称 | 是什么 | A2A 怎么用 |
|---|---|---|
| agentgateway | LLM、MCP、A2A 流量的代理网关;Linux 基金会项目,约 6.1k star | 在 agent 之间加一层 A2A 网关,统一做鉴权、观测和治理 |
| kagent | 在 Kubernetes 上部署和管理 agent;CNCF 项目,约 4.2k star,刚发布 1.0 | 控制器对外提供 A2A API,部署的 agent 可以按 A2A 被调用 |
| Agent Stack | 原名 BeeAI Platform,把 agent 跑成服务,自带界面;Linux 基金会托管,约 1.2k star | README 写明「Built on A2A」,接进来的 agent 自动暴露成 A2A agent。仍是 0.x |
| Langflow | 可视化搭 flow 和 agent,约 157k star | 能把 flow 发布成 A2A 服务,也有调用外部 A2A agent 的组件。1.11 起默认关闭,要设 LANGFLOW_A2A_ENABLED=true |
| LiteLLM | LLM 网关,约 63k star | 网关提供 /a2a 端点,可以调用 A2A agent |
| Docker Agent | Docker 的 agent 运行工具 | docker agent serve a2a 把 agent 暴露成 A2A 服务。文档标注 Early support |
反过来看,Dify、n8n、LibreChat 这些用户最多的开源应用,本体都不支持 A2A,最多有第三方插件或社区节点;Open WebUI 的官方文档里也没找到相关说明。截至 2026-11,A2A 的落地集中在网关、编排平台和开发框架,还没有大众直接上手的成熟 A2A 应用。
用之前要知道的几件事
- 0.3 到 1.0 有不兼容的改动,旧教程照抄会出错。方法名从
message/send改成了SendMessage;枚举值改成TASK_STATE_COMPLETED、ROLE_USER这种全大写写法;Part 去掉了kind字段,过去的 TextPart、FilePart、DataPart 不再这么区分。2025 年的文章大多是 0.3 写法。 - 名片路径以规范为准。规范写的是
/.well-known/agent-card.json,个别文档还写着agent.json。 - 「支持 A2A」不等于支持全部功能。有的只实现 JSON-RPC,有的没有推送,有的语言版本还是实验性。选型前先对照你要用的那几项。
- 远端 agent 是黑盒,接之前先想清楚信不信它。你看不到它用了什么工具、把你的数据交给了谁。微软的文档也特意提醒:连接前确认你信任这个地址和背后的运营方。
依据:A2A 规范 1.0(a2a-protocol.org 与 a2aproject/A2A 仓库的 specification.md)、Linux 基金会 2026-04-09 新闻稿,以及 Google ADK、Microsoft Agent Framework、LangSmith、CrewAI、Langflow 的官方文档和各开源项目的 GitHub 仓库,均于 2026-11-11 读取。示例 JSON 摘自规范第 6 节,略有删减,并补上了 A2A-Version 请求头。