Skip to content

[Enhancement] Upgrade A2A Java SDK from 0.2.x to a supported 1.x release #25

Open

Description

@Aias00

背景

迁移自上游遗留需求 alibaba/spring-ai-alibaba#4762。在 argi-extensions 当前 main(9f5f5aa)中仍明确存在。

当前状态

根 pom.xml 仍固定:

<a2a-sdk.version>0.2.5</a2a-sdk.version>

并继续使用旧 Maven 坐标:

<groupId>io.github.a2asdk</groupId>
<artifactId>a2a-java-reference-server</artifactId>
<artifactId>a2a-java-sdk-server-common</artifactId>
<artifactId>a2a-java-sdk-client</artifactId>

截至 2026-10-12,官方 a2aproject/a2a-java 已发布稳定的 1.4.0.Final,并使用 org.a2aproject.sdk 坐标。当前 Extensions 仍停留在 0.2.x 协议/SDK 世代。

官方发布页:https://github.com/a2aproject/a2a-java/releases

影响

  • 继续依赖旧 0.2.x API 与协议模型,无法跟随 A2A 1.0 稳定规范。
  • 缺失新版本的兼容性、安全和服务器实现修复。
  • 现有 A2A Nacos starter 的实体、客户端、服务端与测试都建立在旧包结构上,迁移越晚成本越高。

期望

迁移到维护中的 A2A Java SDK 1.x。目标版本应根据兼容性评估选定受支持的稳定版本,不应机械地只改版本号。

验收建议

  • 迁移 Maven 坐标和所有 io.a2a.* API 使用。
  • 核对 Agent Card、message/send、message/stream、task、artifact、SSE 与错误模型的协议变化。
  • A2A Nacos server/client 单测和集成测试全部通过。
  • 与 Python/Java 官方 1.0-compatible Agent 做互操作验证。
  • 补充升级说明和 breaking changes 文档。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions