技术规范 / v0.1 草案
A2A MSA 互操作规范
本草案面向实现者和评审者。它约束如何使用现有 A2A 能力,不替换上游协议。字段、配置与测试要求仍可能变化。
查看上游 A2A 规范本文的「必须」和「不得」是声明符合性时的要求;「应」是推荐做法。没有任何实现因部署此草案而自动获得认证。
1. 范围与上游版本
此版本以 A2A v0.3.0 的 JSON-RPC 绑定为基准。实现必须满足上游要求,并按本草案声明符合性。Agent Card 的 protocolVersion 必须为 0.3.0;对其他绑定或上游版本的支持不在本草案的符合性声明范围内。
2. 符合性级别
core:提供 HTTPS 上的公开 Agent Card;接受 message/send;至少有一项公开技能可返回带任务 ID 的 Task,可通过 tasks/get 取得当前状态。streaming:满足 core,并声明 streaming: true,支持 message/stream。客户端断开后必须能通过 tasks/get 查询同一任务的当前状态或最终结果。未声明 streaming 时,客户端不得要求流式响应。两个级别均不约束智能体内部实现。
3. Agent Card 扩展
实现必须在 capabilities.extensions 中使用下方的 URI,required 必须为 false。params.version 必须是字符串 0.1;params.profiles 是字符串数组,必须含 core,只有通过流式配置要求时才可同时声明 streaming。遇到未知配置名时,客户端必须忽略该名称;遇到未知草案版本时不得推断符合性,但仍可按普通 A2A 客户端运行。
{
"uri": "https://www.a2amsa.com/spec#msa-profile",
"required": false,
"params": {
"version": "0.1",
"profiles": [
"core",
"streaming"
]
}
}
4. 安全与认证
公开 Agent Card 不得包含凭据或租户专有数据。非公开任务端点必须使用 HTTPS 和在 Agent Card 中声明的 OAuth 2.0 Bearer 访问令牌方案,并验证令牌的有效期、受众及所需权限。缺失或无效的令牌必须在业务逻辑执行前返回 HTTP 401;权限不足返回 403。任务读取必须执行与任务创建一致的租户隔离,不得把凭据放进 URL、日志或测试报告。
5. 互操作测试与证据
通过 A2A Test 查看测试入口。core 的最低测试集包括:验证 Agent Card 和声明;通过两种独立客户端向同一测试技能发送请求并读取任务状态;对受保护端点验证缺失令牌、过期令牌和错误租户令牌被拒绝。streaming 还需验证事件属于同一任务、流断开后可读回任务状态。测试报告必须记录草案版本、配置级别、实现版本、测试集版本或修订号和通过/失败;不得包含凭据或真实业务数据。以上是草案要求,不表示测试入口已自动覆盖每项检查。
打开 A2A Test6. 版本与治理
草案修订将分别编号,不保证 v0.x 之间兼容。实现必须只声明自己验证过的草案版本。提案应包含互操作用例、兼容性影响及可复现的测试;建议在公开评审后发布变更记录,规范定稿前由至少两套独立实现验证。欢迎通过联盟申请提交评审兴趣或参与意向。