跳至内容

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黑盒,自己拿主意

  • 对方可能要干很久,中途还会反过来问你
  • 你只看得到它的「名片」和交回来的结果
两者互补:同一个 agent 可以往下用 MCP 调工具,往外用 A2A 把子任务交给别的 agent。虚线框表示你看不到对方内部。

一次协作怎么走

下面的请求和响应照抄规范第 6 节的示例,用的是 HTTP+JSON 绑定。换成 JSON-RPC 绑定时,内容一样,只是外面包一层 {"jsonrpc":"2.0","method":"SendMessage",…}。

  1. 客户端 → 远端

    先看名片:Agent Card

    到对方域名下的固定路径取一份 JSON:https://{域名}/.well-known/agent-card.json。名片里写着:

    • skills:能干哪些事,附示例说法
    • supportedInterfaces:在哪个地址、用哪种绑定说话
    • securitySchemes:要怎么鉴权
    • capabilities:支不支持流式、推送
  2. 客户端 → 远端

    发一条消息

    POST /message:send
    A2A-Version: 1.0
    
    {
      "message": {
        "role": "ROLE_USER",
        "parts": [{"text": "Book me a flight"}],
        "messageId": "msg-1"
      }
    }
  3. 远端 → 客户端

    对方决定:直接回话,还是开个任务

    简单问题,对方可以直接回一条 Message 了事。要真干活,就建一个 Task,把任务编号和状态回给你。任务慢的话,有三种方式跟进:

    • 轮询:隔一会儿 GetTask 问一次
    • 流式:SendStreamingMessage 或 SubscribeToTask,对方用 SSE 边干边推
    • 推送:你留一个 webhook 地址,对方有进展就 POST 过来
  4. 远端 → 客户端 → 远端

    缺信息就反过来问你

    任务状态变成 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"
    }
  5. 远端 → 客户端

    交结果: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。

任务的状态

示意常见走向,不是规范里的完整状态转换表。线上传输时每个值都带 TASK_STATE_ 前缀,例如 TASK_STATE_COMPLETED。规范把橙色两种叫作「中断」状态:任务没结束,只是在等委托方。

怎么传:三种绑定,挑一种说

同一个 agent 可以在名片的 supportedInterfaces 里同时列出几种绑定,客户端挑自己会的那种。每个请求都要带上 A2A-Version 头;不带时,对方按 0.3 版处理。

绑定发消息查任务取消任务
JSON-RPC 2.0SendMessageGetTaskCancelTask
gRPCSendMessageGetTaskCancelTask
HTTP+JSONPOST /message:sendGET /tasks/{id}POST /tasks/{id}:cancel

鉴权不另起炉灶,名片里声明现成的方案:API Key、HTTP 认证(如 Bearer)、OAuth 2.0、OpenID Connect、双向 TLS。

现在能用什么

以下按各家官方文档核对,读取日期 2026-11-11。「支持」都是指框架或平台自己的文档写明了。

名称是什么A2A 支持情况
官方 SDKa2aproject 组织维护Python、JS/TS、Java、Go、.NET、Rust;另有 Inspector 调试工具、TCK 兼容性测试和示例仓库
Google ADKagent 开发框架能对外提供 A2A 服务,也能调用远端 agent。Python 正式 Go / Java / Kotlin 实验性
Microsoft Agent Frameworkagent 开发框架A2AAgent 把远端 agent 当本地 agent 用,也能把自己的 agent 托管成 A2A 服务;C#、Python、Go
LangSmith Agent ServerLangGraph 的部署服务内置 /a2a/{assistant_id} 端点,讲 1.0 的 JSON-RPC,兼容 0.3 方法名。gRPC、HTTP+JSON、推送尚未实现
CrewAI多 agent 框架A2AClientConfig 委托出去,A2AServerConfig 对外接活
云平台托管运行 agentLinux 基金会点名:Azure AI Foundry、Copilot Studio、Amazon Bedrock AgentCore Runtime

开源应用:多在基础设施这一层

按各项目自己的仓库或文档核对;star 数为 2026-11-11 的约数。

名称是什么A2A 怎么用
agentgatewayLLM、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 starREADME 写明「Built on A2A」,接进来的 agent 自动暴露成 A2A agent。仍是 0.x
Langflow可视化搭 flow 和 agent,约 157k star能把 flow 发布成 A2A 服务,也有调用外部 A2A agent 的组件。1.11 起默认关闭,要设 LANGFLOW_A2A_ENABLED=true
LiteLLMLLM 网关,约 63k star网关提供 /a2a 端点,可以调用 A2A agent
Docker AgentDocker 的 agent 运行工具docker agent serve a2a 把 agent 暴露成 A2A 服务。文档标注 Early support

反过来看,Dify、n8n、LibreChat 这些用户最多的开源应用,本体都不支持 A2A,最多有第三方插件或社区节点;Open WebUI 的官方文档里也没找到相关说明。截至 2026-11,A2A 的落地集中在网关、编排平台和开发框架,还没有大众直接上手的成熟 A2A 应用。

用之前要知道的几件事

  1. 0.3 到 1.0 有不兼容的改动,旧教程照抄会出错。方法名从 message/send 改成了 SendMessage;枚举值改成 TASK_STATE_COMPLETED、ROLE_USER 这种全大写写法;Part 去掉了 kind 字段,过去的 TextPart、FilePart、DataPart 不再这么区分。2025 年的文章大多是 0.3 写法。
  2. 名片路径以规范为准。规范写的是 /.well-known/agent-card.json,个别文档还写着 agent.json。
  3. 「支持 A2A」不等于支持全部功能。有的只实现 JSON-RPC,有的没有推送,有的语言版本还是实验性。选型前先对照你要用的那几项。
  4. 远端 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 请求头。