A2A v1.0 有哪些变化
A2A 正从早期草案阶段进入更成熟的 v1.0 release candidate 语义。
一分钟结论
- 协议在 JSON-RPC、gRPC、REST 三类绑定上的定义更明确。
a2a.proto成为规范事实源。- 一些旧写法（尤其流式完成判断）需要迁移到新语义。
四类用户的关注重点
决策者
- 需要明确版本治理和兼容策略。
- 需要把协议演进纳入发布节奏和风险评估。
- 需要在安全、审计、可观测性上提前设边界。
初学者
- 建议按“发现 -> 发消息 -> 查任务 -> 流式/订阅”顺序学习。
- 先理解任务状态，再处理复杂扩展。
开发者
- 以
Task为状态事实源，不把流事件当持久事实。 - 以
Message承载交互，以Artifact承载结果。 - 统一处理能力声明、错误类型和服务参数。
高级用户
- 构建多版本客户端兼容测试矩阵。
- 做跨绑定一致性验证。
- 为扩展建立严格 schema 和版本演进规范。
高影响变化（落地层面）
- 流式完成判断不再依赖
final字段。 - 操作命名与映射更统一。
- 版本参数和扩展参数处理更明确。
- 新任务 ID 由服务端生成，客户端不应自行创建。
迁移清单
- 清点现有流式完成判断逻辑。
- 对齐 v1 操作映射和错误处理。
- 从最新 proto 重新生成 schema 与 SDK 绑定。
- 回归验证轮询、流式、推送三条链路。
- 把兼容窗口写入对外文档和发布策略。