A2A Python SDK

---

✨ 特性

• 符合 A2A 协议： 构建遵循 Agent2Agent (A2A) 协议的代理应用。
• 可扩展： 轻松添加对不同通信协议和数据库后端的支持。
• 异步： 基于现代异步 Python 构建，性能卓越。
• 可选集成： 包括对以下内容的可选支持：
  • HTTP 服务器（FastAPI、Starlette)
  • gRPC
  • 用于追踪的 OpenTelemetry
  • SQL 数据库（PostgreSQL、MySQL、SQLite)

---

🧩 兼容性

该 SDK 实现了 A2A 协议规范 0.3。

[!重要] 目前有一个alpha 版本，同时支持 1.0 和 0.3 版本。此版本的开发正在 1.0-dev 分支中进行，并在 #701 中跟踪。

传输方式	客户端	服务器
JSON-RPC	✅	✅
HTTP+JSON/REST	✅	✅
GRPC	✅	✅

---

🚀 快速入门

前提条件

• Python 3.10+
• uv（推荐）或 pip

🔧 安装

使用您喜欢的包管理器安装核心 SDK 和任何所需的附加组件。

功能	uv 命令	pip 命令
核心 SDK	uv add a2a-sdk	pip install a2a-sdk
所有附加组件	uv add "a2a-sdk[all]"	pip install "a2a-sdk[all]"
HTTP 服务器	uv add "a2a-sdk[http-server]"	pip install "a2a-sdk[http-server]"
gRPC 支持	uv add "a2a-sdk[grpc]"	pip install "a2a-sdk[grpc]"
OpenTelemetry 追踪	uv add "a2a-sdk[telemetry]"	pip install "a2a-sdk[telemetry]"
加密	uv add "a2a-sdk[encryption]"	pip install "a2a-sdk[encryption]"
Vertex AI 任务存储	uv add "a2a-sdk[vertex]"	pip install "a2a-sdk[vertex]"
数据库驱动程序
PostgreSQL	uv add "a2a-sdk[postgresql]"	pip install "a2a-sdk[postgresql]"
MySQL	uv add "a2a-sdk[mysql]"	pip install "a2a-sdk[mysql]"
SQLite	uv add "a2a-sdk[sqlite]"	pip install "a2a-sdk[sqlite]"
所有 SQL 驱动程序	uv add "a2a-sdk[sql]"	pip install "a2a-sdk[sql]"

示例

Helloworld 示例

1. 运行远程代理

   git clone https://github.com/a2aproject/a2a-samples.git
   cd a2a-samples/samples/python/agents/helloworld
   uv run .
   

2. 在另一个终端中，运行客户端

   cd a2a-samples/samples/python/agents/helloworld
   uv run test_client.py
   

3. 您可以使用代理检查器验证您的代理。请按照 a2a-inspector 仓库中的说明操作。

---

🌐 更多示例

您可以在 a2a-samples 仓库中找到各种更详细的示例：

• Python 示例
• JavaScript 示例

---

🤝 贡献

欢迎贡献！请参阅 CONTRIBUTING.md 文件，了解参与方式的指南。

---

📄 许可证

本项目采用 Apache 2.0 许可证授权。有关详细信息，请参阅 LICENSE 文件。

a2a-python 快速上手指南

环境准备

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

• 操作系统：Linux, macOS 或 Windows
• Python 版本：Python 3.10 或更高版本
• 包管理工具：推荐使用 uv（速度更快），也可使用标准的 pip

提示：国内开发者若遇到网络延迟，可在安装命令后添加国内镜像源（如清华源）：

• uv：目前主要依赖官方源，建议配置全局代理或使用 pip 替代。
• pip：在命令后追加 -i https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

根据您的具体需求，选择以下任一方式安装 a2a-sdk。

1. 安装核心 SDK

仅包含基础功能，适用于构建基本的 A2A 客户端或服务端。

# 使用 uv (推荐)
uv add a2a-sdk

# 或使用 pip
pip install a2a-sdk

2. 安装完整功能（所有扩展）

如果您需要 HTTP 服务器、gRPC、链路追踪及所有数据库支持，可一键安装所有可选依赖。

# 使用 uv
uv add "a2a-sdk[all]"

# 或使用 pip
pip install "a2a-sdk[all]"

3. 按需安装特定功能

您也可以只安装需要的模块，例如仅启用 HTTP 服务器或 PostgreSQL 支持：

功能需求	uv 命令	pip 命令
HTTP 服务器 (FastAPI/Starlette)	uv add "a2a-sdk[http-server]"	pip install "a2a-sdk[http-server]"
gRPC 支持	uv add "a2a-sdk[grpc]"	pip install "a2a-sdk[grpc]"
OpenTelemetry 链路追踪	uv add "a2a-sdk[telemetry]"	pip install "a2a-sdk[telemetry]"
PostgreSQL 驱动	uv add "a2a-sdk[postgresql]"	pip install "a2a-sdk[postgresql]"
SQLite 驱动	uv add "a2a-sdk[sqlite]"	pip install "a2a-sdk[sqlite]"

(注：若使用 pip 且需加速，请在上述命令末尾添加 -i https://pypi.tuna.tsinghua.edu.cn/simple)

基本使用

以下通过官方的 "Hello World" 示例演示如何运行一个远程 Agent 并通过客户端与其交互。该示例基于 JSON-RPC 协议。

第一步：获取示例代码

克隆官方示例仓库并进入目录：

git clone https://github.com/a2aproject/a2a-samples.git
cd a2a-samples/samples/python/agents/helloworld

第二步：启动 Agent 服务端

在第一个终端窗口中运行 Agent 服务。这将启动一个遵循 A2A 协议的本地服务器。

uv run .

(如果使用 pip 环境，请确保已安装依赖后运行 python . 或相应入口脚本)

第三步：运行客户端

打开另一个终端窗口，保持在同一目录下，运行测试客户端与服务端通信：

uv run test_client.py

验证结果

如果配置正确，客户端将向服务端发送请求并收到响应。您还可以使用 a2a-inspector 工具对运行的 Agent 进行更深入的调试和验证。

更多资源：如需查看更复杂的场景（如多轮对话、工具调用等），请访问 a2a-samples 仓库中的 Python 示例目录。