A2A 协议与 MCP 协同架构实战
合规 Agent 收到审查请求后,常常需要调用方补充材料或完成二次授权。跨团队、跨框架的两个独立 Agent 之间,调用方如何查询 Task 状态、补交材料并取回最终 Artifact?
Agent2Agent(A2A)协议 正是为这类跨边界 Agent 协作设计的开放标准(由 Google 于 2025 年 4 月公布、2025 年 6 月移交 Linux Foundation 托管,并在 2026 年 3 月发布 v1.0;而 MCP 则于 2025 年 12 月作为创始贡献项目加入 AAIF)。本文以 A2A v1.0.1 为技术锚点,结合官方 v1.0 变更说明 与 Life of a Task,梳理 A2A 与 MCP 的正交分工、v1 Agent Card 发现校验与规范 Task 状态机。
A2A 与 MCP 的正交分工
两者解决多智能体系统里完全不同的两个切面,不是替代关系:
- MCP(纵向:Agent → 工具与数据源):把确定性能力(查库、读文件、调内部 API)以统一 Schema 暴露给单个 Agent。
- A2A(横向:Agent → Agent):把远端自治 Agent 当作 不透明对等节点(Opaque Peer) 对待——调用方只耦合对方对外声明的接口、技能与任务状态,不耦合其内部提示词、记忆或底层模型。
若协作角色全部运行在同一个团队与代码库内,采用 Multi-Agent 系统协作实践 中的进程内编排通常更轻量;只有跨越团队、语言栈或组织边界时,A2A 的协议边界才会发挥价值。
三层规范架构与官方 SDK
A2A 以 Protocol Buffers(a2a.proto)为唯一权威数据模型,自底向上分为三层:
- 规范数据模型(Canonical Data Model):定义与传输无关的
Message、Part、Task、Artifact与AgentCard。 - 抽象操作(Abstract Operations):定义发送消息、查询/取消任务、订阅状态更新等语义。
- 协议绑定(Protocol Bindings):提供功能等价的三种绑定——JSON-RPC 2.0 over HTTP(S)、gRPC 与 HTTP+JSON/REST。是否支持 SSE 流式输出、任务订阅或 Push Notifications,均以远端 Agent Card 中声明的能力开关为准。
官方 SDK 清单 覆盖 TypeScript/JavaScript(@a2a-js/sdk)、Go(github.com/a2aproject/a2a-go)、Python(a2a-sdk)、Rust(a2a-lf)以及 Java 与 .NET 官方包。
规范 Task 生命周期:包含可恢复分支
在合规审查这类真实协作中,远端 Agent 经常无法一步到位给出终态。规范 Life of a Task 既定义了简单问答可直接返回 Message(不必每次都创建 Task),也定义了带可恢复分支的完整 Task 状态机:
需要守住两点契约:
- 可恢复状态不新建 Task:当合规 Agent 返回
Input Required(要求补交证明材料)或Auth Required时,调用方应携带原taskId续接同一个 Task,直到它推进回Working。 - 四个终态不可逆:一旦 Task 进入
Completed、Canceled、Rejected或Failed,即成为不可变状态、不可重启。后续如需基于已有 Artifact 继续迭代,需发起新 Task 并引用前序上下文以保留审计关系(若业务需要幂等语义,应由调用方另行设计幂等键)。
TypeScript 示例:A2A v1.0.1 Agent Card 最小投影校验
A2A v1 相比旧版 v0.3 的一项关键破坏性变更,是把顶层 url 升级为 supportedInterfaces[] 数组,每项显式声明 url、protocolBinding 与 protocolVersion(详见 What’s New in v1)。生产代码建议直接复用 @a2a-js/sdk 的 v1 类型;下面给出一个针对 v1.0.1 的最小投影校验示例(显式校验每个 skill 与接口对象,并设置请求超时;如需兼容 v0.3 卡片应写单独分支):
export interface SupportedInterface {
url: string;
protocolBinding: string;
protocolVersion: string;
}
export interface AgentSkill {
id: string;
name: string;
}
export interface AgentCardV1 {
name: string;
supportedInterfaces: SupportedInterface[];
skills: AgentSkill[];
}
function isRecord(v: unknown): v is Record<string, unknown> {
return typeof v === "object" && v !== null;
}
export function parseAgentCardV1(raw: unknown): AgentCardV1 {
if (!isRecord(raw) || typeof raw.name !== "string") {
throw new Error("Invalid A2A v1 Agent Card: missing name");
}
if (!Array.isArray(raw.supportedInterfaces) || raw.supportedInterfaces.length === 0) {
throw new Error("Invalid A2A v1 Agent Card: missing supportedInterfaces");
}
if (!Array.isArray(raw.skills)) {
throw new Error("Invalid A2A v1 Agent Card: missing skills array");
}
const supportedInterfaces: SupportedInterface[] = raw.supportedInterfaces.map((entry, i) => {
if (
!isRecord(entry) ||
typeof entry.url !== "string" ||
typeof entry.protocolBinding !== "string" ||
typeof entry.protocolVersion !== "string"
) {
throw new Error(`Invalid supportedInterfaces[${i}]`);
}
return {
url: entry.url,
protocolBinding: entry.protocolBinding,
protocolVersion: entry.protocolVersion,
};
});
const skills: AgentSkill[] = raw.skills.map((entry, i) => {
if (!isRecord(entry) || typeof entry.id !== "string" || typeof entry.name !== "string") {
throw new Error(`Invalid skills[${i}]`);
}
return { id: entry.id, name: entry.name };
});
return { name: raw.name, supportedInterfaces, skills };
}
export async function discoverAgentCardV1(
baseUrl: string,
timeoutMs = 5000,
): Promise<AgentCardV1> {
const endpoint = new URL("/.well-known/agent-card.json", baseUrl);
const res = await fetch(endpoint, {
headers: { Accept: "application/json" },
redirect: "error", // 禁止隐式跨域重定向,避免 SSRF 绕过白名单
signal: AbortSignal.timeout(timeoutMs),
});
if (!res.ok) {
throw new Error(`Agent Card discovery failed (${res.status}): ${endpoint.toString()}`);
}
let raw: unknown;
try {
raw = await res.json();
} catch {
throw new Error("Agent Card discovery returned non-JSON payload");
}
return parseAgentCardV1(raw);
}
export function selectInterface(
card: AgentCardV1,
binding: string,
versionPrefix = "1.",
): SupportedInterface | undefined {
return card.supportedInterfaces.find(
(iface) =>
iface.protocolBinding === binding && iface.protocolVersion.startsWith(versionPrefix),
);
}向 selectInterface 返回的目标 url 附带凭据发起任务前,务必同时校验发现地址与 Card 声明目标地址均落在受信域名白名单内,防止恶意 Card 把带认证头的请求导向第三方主机。
何时不该引入 A2A
- 别把确定性微服务包装成 A2A Agent:查订单、写库、发通知直接走 REST/gRPC 或封装成 MCP Tool,避免无谓引入 Task 状态机。
- 跨团队治理下沉至网关:当跨部门 A2A 与 MCP 流量增多时,可配合统一网关层做鉴权与观测(详见 AI 网关与 MCP 路由)。