Python 示例

本页介绍用于演示 A2A Protocol 功能的 Python 示例代码。

代码结构

示例代码分为三个主要子目录:

  • Common: 包含所有示例 Agent 和应用程序使用的通用代码,用于通过 HTTP 实现 A2A 通信。
  • Agents: 包含使用多种框架编写的示例 Agent,这些 Agent 执行示例任务并使用工具。它们都使用了通用的 A2AServer
  • Hosts: 包含使用 A2AClient 的主机应用程序。包括:
    • 一个简单的 CLI (命令行界面),演示与单个 Agent 完成任务。
    • 一个 Mesop Web 应用程序,可以与多个 Agent 通信。
    • 一个编排器 Agent,将任务委派给多个远程 A2A Agent。

先决条件

  • Python 3.13 或更高版本
  • UV

运行示例

要运行示例,您需要启动一个(或多个)Agent A2A 服务器和一个主机应用程序。

以下示例演示如何运行 LangGraph Agent 和 Python CLI Host:

  1. 导航到目录: (假设在仓库根目录)
    # 请根据您的本地代码结构调整此路径
    cd path/to/your/a2a-protocol/samples/python
  2. 运行 Agent: (在一个终端窗口中)
    uv run agents/langgraph
  3. 运行 Host: (在 另一个 终端窗口中)
    uv run hosts/cli

请查阅 AgentsHosts 子目录下的 README 文件,了解更多可用的 Agent 和 Host 以及它们的具体运行方式。


注意: 这些是示例代码,并非生产级别的库。