文章目录
- 一、概述
- 二、A2A协议核心概念速览
- 三、项目架构全景
- 四、开发环境准备
- 4.1 基础软件
- 4.2 获取DashScope API Key
- 4.3 Nacos（可选）
- 五、项目搭建与目录结构
- 六、pom.xml完整配置
- 七、核心代码逐深度解析
- 7.1 工具类：ExampleTools
- 7.2 服务端启动类：A2aExampleApplication
- 7.3 客户端交互运行器：A2aAgentExampleRunner
- 7.4 两种客户端发现模式
- 模式一：Well-Known URI直连
- 模式二：Nacos注册中心发现
- 八、A2A协议深度集成
- 8.1 协议栈四层模型
- 8.2 AgentCard实例
- 8.3 一次完整请求的时序流程
- 8.4 curl直接测试服务端
- 九、配置文件全解
- 9.1 application.yml
- 9.2 logback.xml
- 十、测试验证完整流程
- Step 1：编译项目
- Step 2：启动服务端
- Step 3：验证AgentCard
- Step 4：交互式客户端测试
- Step 5：Nacos模式测试（可选）
- 十一、常见问题排错指南
- Q1：编译报错"Could not find artifact io.agentscope:agentscope-core"
- Q2：启动时报"DashScope API key is not set"
- Q3：端口8888被占用
- Q4：客户端报"Connection refused"
- Q5：Nacos连接失败
- 十二、进阶扩展方向
- 12.1 添加自定义Tool
- 12.2 切换大模型
- 12.3 多Agent协作
- 12.4 RocketMQ异步传输
- 十三、总结
一、概述
2024年4月，Google在Google Cloud Next大会上正式提出了A2A（Agent-to-Agent）协议，这是一个开放协议，旨在让不同的AI Agent之间能够像微服务一样相互发现、相互调用。通俗地讲：A2A协议就是AI Agent世界的HTTP协议——有了它，一个Agent可以把自己的能力以标准化的方式暴露出去，另一个Agent可以无缝地发现并调用它。
本文将基于阿里巴巴开源的AgentScope Java SDK（Apache 2.0协议），手把手带你从零搭建一个完整的A2A Agent应用。这个应用的服务端会暴露一个具备天气查询、数学计算、时间查询能力的ReActAgent，客户端则通过URL直连或Nacos注册中心两种方式去发现并调用它。
2026年了，如果你还不知道如何让两个AI Agent互相发现和协作，这篇文章就是为你准备的。
二、A2A协议核心概念速览
在动手写代码之前，先梳理A2A协议的四个核心概念：
| 概念 | 通俗解释 | 类比 |
|---|---|---|
| AgentCard | Agent的电子名片，描述它能做什么 | 微服务的Swagger文档 |
