AgentScope实战训练营：从零搭建一个完整的A2A Agent应用

文章目录

• • 一、概述
  • 二、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协议的四个核心概念：