Agent2Agent（A2A）协议

Agent2Agent（A2A）协议

一种开放协议，用于实现不透明代理应用之间的通信与互操作性。

Agent2Agent（A2A）协议解决了人工智能领域的一个关键挑战：使由不同公司基于多种框架构建、运行在独立服务器上的生成式AI代理能够以代理身份而非单纯工具的方式进行有效沟通与协作。A2A旨在为代理提供一种通用语言，从而促进更加互联、强大且创新的人工智能生态系统。

借助A2A，代理可以：

• 发现彼此的能力。
• 协商交互方式（文本、表单、媒体）。
• 安全地协作完成长期任务。
• 在不暴露其内部状态、记忆或工具的情况下运行。

DeepLearning.AI 课程

加入这门与Google Cloud和IBM Research合作开发的短期课程——A2A：Agent2Agent协议，由Holt Skinner、Ivan Nardini和Sandi Besen主讲。

你将学到的内容：

• 使代理符合A2A标准： 将使用Google ADK、LangGraph或BeeAI等框架构建的代理公开为A2A服务器。
• 连接代理： 从零开始创建A2A客户端，或利用现有集成连接到符合A2A标准的代理。
• 编排工作流： 构建符合A2A标准的代理的顺序和层次化工作流。
• 多代理系统： 使用不同框架构建一个医疗领域的多代理系统，并了解A2A如何实现协作。
• A2A与MCP： 学习A2A如何通过使代理之间能够相互协作来补充MCP。

为什么需要A2A？

随着AI代理的日益普及，它们的互操作能力对于构建复杂、多功能的应用程序至关重要。A2A旨在：

• 打破孤岛效应： 连接不同生态系统的代理。
• 实现复杂协作： 允许专业代理共同完成单个代理无法独立处理的任务。
• 推动开放标准： 倡导社区驱动的代理通信方式，鼓励创新并促进广泛采用。
• 保持不透明性： 允许代理在无需共享内部记忆、专有逻辑或特定工具实现的情况下进行协作，从而增强安全性并保护知识产权。

主要特性

• 标准化通信： 基于HTTP(S)的JSON-RPC 2.0。
• 代理发现： 通过详细说明能力和连接信息的“代理卡片”实现。
• 灵活交互： 支持同步请求/响应、流式传输（SSE）以及异步推送通知。
• 丰富的数据交换： 可处理文本、文件和结构化的JSON数据。
• 企业级就绪： 在设计时充分考虑了安全性、身份验证和可观测性。

开始使用

• 📚 浏览文档： 访问Agent2Agent协议文档网站，获取完整概述、完整的协议规范、教程和指南。
• 📝 查看规范： A2A协议规范
• 使用SDK：
  • 🐍 A2A Python SDK pip install a2a-sdk
  • 🐿️ A2A Go SDK go get github.com/a2aproject/a2a-go
  • 🧑‍💻 A2A JS SDK npm install @a2a-js/sdk
  • ☕️ A2A Java SDK 使用Maven
  • 🔷 A2A .NET SDK 使用NuGet dotnet add package A2A
• 🎬 使用我们的示例，查看A2A的实际应用情况。

贡献

我们欢迎社区为 A2A 协议的增强与演进贡献力量！

• 问题与讨论： 欢迎加入我们的 GitHub Discussions。
• 问题报告与反馈： 请通过 GitHub Issues 报告问题或提出改进建议。
• 贡献指南： 有关如何贡献的详细信息，请参阅我们的 CONTRIBUTING.md。
• 私密反馈： 请使用此 Google 表单 提交反馈。
• 合作伙伴计划： Google Cloud 客户可通过此 表单 加入我们的合作伙伴计划。

下一步

协议增强

• 代理发现：
  • 正式定义在 AgentCard 中直接包含授权机制和可选凭据。
• 代理协作：
  • 研究 QuerySkill() 方法，以动态检查不支持或未预期的技能。
• 任务生命周期与用户体验：
  • 支持在任务 内部 进行动态用户体验协商（例如，代理在对话过程中添加音频/视频）。
• 客户端方法与传输：
  • 探索将支持扩展到客户端发起的方法（超出任务管理范围）。
  • 提升流式传输的可靠性及推送通知机制。

关于

A2A 协议是 Linux 基金会旗下的开源项目，由 Google 贡献。该协议采用 Apache License 2.0 许可证，并向社区开放贡献。

A2A (Agent2Agent) 协议快速上手指南

A2A 是一个开放协议，旨在让不同框架、不同公司开发的 AI 智能体（Agent）能够像“特工”一样相互通信和协作，而无需暴露内部状态或私有逻辑。本指南将帮助你快速搭建环境并开始使用。

环境准备

在开始之前，请确保你的开发环境满足以下基本要求：

• 操作系统：Linux, macOS, 或 Windows。
• 编程语言环境（根据你选择的 SDK 任选其一）：
  • Python: 版本 3.9 或更高。
  • Node.js: 版本 18 或更高（用于 JS/TS SDK）。
  • Go: 版本 1.21 或更高。
  • Java: JDK 17 或更高 (Maven 项目)。
  • .NET: .NET 6 或更高。
• 网络要求：能够访问 pypi.org, npmjs.com 等公共仓库（若在国内访问受限，建议配置相应镜像源）。

安装步骤

A2A 提供了多种语言的 SDK。请选择适合你项目的语言进行安装。

Python (推荐)

pip install a2a-sdk

(国内用户可使用清华源加速：pip install a2a-sdk -i https://pypi.tuna.tsinghua.edu.cn/simple)

JavaScript / TypeScript

npm install @a2a-js/sdk

(国内用户可使用淘宝源加速：npm install @a2a-js/sdk --registry=https://registry.npmmirror.com)

Go

go get github.com/a2aproject/a2a-go

Java (Maven)

在你的 pom.xml 中添加依赖（具体版本号请查阅 Maven Central）：

<dependency>
    <groupId>org.a2aprotocol</groupId>
    <artifactId>a2a-java</artifactId>
    <version>latest</version>
</dependency>

.NET

dotnet add package A2A

基本使用

A2A 的核心概念是客户端 (Client) 与 服务器 (Server) 的交互。服务器通过 "Agent Card" 暴露能力，客户端发现并连接服务器以执行任务。

以下是一个最简单的 Python 客户端 示例，展示如何连接一个 A2A 服务器并发送消息：

1. 导入 SDK 并初始化客户端

假设你已经有一个运行中的 A2A 服务器（例如地址为 http://localhost:8080），你可以这样连接：

from a2a.client import A2ACardResolver, A2AClient

# 目标 A2A 服务器的 URL
server_url = "http://localhost:8080"

# 解析 Agent Card 获取服务器能力信息
resolver = A2ACardResolver(server_url)
agent_card = resolver.get_agent_card()

print(f"连接到智能体：{agent_card.name}")
print(f"支持的能力：{agent_card.capabilities}")

# 初始化客户端
client = A2AClient(agent_card)

2. 发送任务请求

创建一个简单的文本任务并发送给智能体：

from a2a.types import Task, Message, Part, TextPart

# 构建消息内容
message_content = [TextPart(text="请帮我分析这份销售数据。")]
message = Message(role="user", parts=message_content)

# 发送请求 (同步模式示例)
# send_message 会处理任务的创建或更新
response = client.send_message(message)

# 处理响应
if response.root.result:
    print("任务执行结果：")
    for part in response.root.result.artifacts[0].parts:
        if isinstance(part, TextPart):
            print(part.text)
elif response.root.error:
    print(f"发生错误：{response.root.error.message}")

下一步

• 运行服务器：要测试完整流程，你需要运行一个 A2A Server。可以参考官方 samples 仓库 中的示例代码来快速启动一个本地服务器。
• 深入文档：访问 A2A 协议文档站点 查看完整的协议规范、流式传输（SSE）用法以及多智能体编排教程。