目录

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 的正交分工

两者解决多智能体系统里完全不同的两个切面,不是替代关系:

flowchart LR Client["协调 Agent (A2A Client)"] -->|"A2A: 发现 Agent Card / 委派与续接 Task"| Compliance["合规审查 Agent (A2A Server)"] Client -->|"A2A: 获取最终 Artifact"| Review["研发评审 Agent (A2A Server)"] Compliance -->|"MCP: 查询策略库与审批单"| PolicyDB["合规知识库"] Review -->|"MCP: 调用 Git / CI 工具"| RepoTools["代码与构建工具"]
  • MCP(纵向:Agent → 工具与数据源):把确定性能力(查库、读文件、调内部 API)以统一 Schema 暴露给单个 Agent。
  • A2A(横向:Agent → Agent):把远端自治 Agent 当作 不透明对等节点(Opaque Peer) 对待——调用方只耦合对方对外声明的接口、技能与任务状态,不耦合其内部提示词、记忆或底层模型。

若协作角色全部运行在同一个团队与代码库内,采用 Multi-Agent 系统协作实践 中的进程内编排通常更轻量;只有跨越团队、语言栈或组织边界时,A2A 的协议边界才会发挥价值。

三层规范架构与官方 SDK

A2A 以 Protocol Buffers(a2a.proto)为唯一权威数据模型,自底向上分为三层:

  1. 规范数据模型(Canonical Data Model):定义与传输无关的 Message、Part、Task、Artifact 与 AgentCard。
  2. 抽象操作(Abstract Operations):定义发送消息、查询/取消任务、订阅状态更新等语义。
  3. 协议绑定(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 状态机:

flowchart LR Sub["Submitted"] --> Work["Working"] Work --> InputReq["Input Required (等待补充材料)"] Work --> AuthReq["Auth Required (等待补充授权)"] InputReq -->|"调用方携带 taskId 续传材料"| Work AuthReq -->|"调用方完成授权后续接"| Work Work --> Done["Completed (终态 · 产出 Artifact)"] Work --> Cancel["Canceled (终态)"] Work --> Reject["Rejected (终态)"] Work --> Fail["Failed (终态)"]

需要守住两点契约:

  • 可恢复状态不新建 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 路由)。

参考资料