A2A Python 教程:构建、运行与调用智能体

A2A Python 教程:构建、运行与调用智能体

这个系列用 Python SDK 带你分 8 步构建、运行并调用一个 A2A 智能体:从最小的 echo 服务器开始,直到接入大语言模型示例的流式与多轮交互。

开始之前先选好路径——并留意「免密钥」的边界到哪里为止:

  • 标准库路径只需要 Python。本地首次回复示例 用纯 Python 标准库在 loopback 回显服务器上完成一次请求与回复——不需要 SDK、API key、模型或任何账号。
  • **SDK 路径到第 6 步同样免密钥。**本系列运行官方 a2a-samples 中的 helloworld 智能体:克隆固定提交、以钉定版本(a2a-sdk==1.3.0)安装 SDK,到第 6 步 在 loopback 上完成首次请求与回复——依然不需要 API key、模型或账号。环境搭建 给出全部命令。本站于 2026-11-14 按该固定提交与固定包版本(Python 3.12)实际验证过本文步骤,但不构成对更新上游版本的兼容保证。
  • **第 7 步开始不再如此。**LangGraph 示例需要 Gemini API key 和它自己的一组依赖;如果你的目的地在那里,直接阅读流式传输与多轮交互 。

完成后,你会跑通一个 echo A2A 服务器、用客户端调用它,并在基于 LangGraph 的示例中看到流式与多轮交互的工作方式。刚接触协议本身?先读什么是 A2A 协议 。

  1. 教程介绍
  2. 环境搭建
  3. 智能体技能与卡片
  4. 智能体执行器
  5. 启动服务器
  6. 与服务器交互
  7. 流式传输与多轮交互
  8. 下一步探索

示例代码均来自官方 a2a-samples 仓库。其他语言的教程见教程指南 。