google/adk-python

这是什么？

核心功能

• 01基于图的 Workflow 运行时，支持路由、循环、重试和状态管理
• 02用于智能体间结构化委派的 Task API
• 03由多个专用智能体组合而成的多智能体层级结构
• 04支持自定义函数、OpenAPI 规范和 MCP 工具的工具生态
• 05工具执行前可进行人工确认
• 06内置开发 Web 界面、命令行工具和评估命令

适用场景

• 构建多智能体应用，由不同的专用智能体处理各自子任务
• 开发基于 Gemini 的智能体，通过 OpenAPI 或 MCP 工具调用外部 API
• 使用可复现的 evalset 文件测试和评估智能体行为
• 将智能体部署为容器到 Cloud Run，或用 Docker 在本地运行

快速上手

1. 1

   从 PyPI 安装稳定版

   pip install google-adk
2. 2

   按 README 示例创建包含 root_agent 的 Agent 文件

3. 3

   在交互式命令行中运行智能体

   adk run path/to/my_agent

使用前须知

• !针对 Gemini 优化，部分功能需要 Google Cloud 或 Gemini 凭证。
• !需要 Python 3.11 或更高版本。
• !main 分支上的开发版本可能包含实验性改动或缺陷。

标签

常见问题

adk-python 是什么？

Google 推出的代码优先 Python 框架，用于构建、评估和部署 AI 智能体，针对 Gemini 优化但不绑定特定模型。 Agent Development Kit（ADK）是一个模块化的 Python 框架，把软件开发的方法引入 AI 智能体的构建。智能体的逻辑、工具和编排都直接用 Python 编写，便于测试和版本管理。框架针对 Gemini 做了优化，同时也支持其他模型和框架。

adk-python 可以免费使用吗？用的什么许可证？

adk-python 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

adk-python 还在维护吗？

活跃维护中。adk-python 最近一次提交是在 2026年10月20日。

adk-python 适合用来做什么？

构建多智能体应用，由不同的专用智能体处理各自子任务 开发基于 Gemini 的智能体，通过 OpenAPI 或 MCP 工具调用外部 API 使用可复现的 evalset 文件测试和评估智能体行为 将智能体部署为容器到 Cloud Run，或用 Docker 在本地运行

adk-python 怎么安装和运行？

从 PyPI 安装稳定版: pip install google-adk 按 README 示例创建包含 root_agent 的 Agent 文件 在交互式命令行中运行智能体: adk run path/to/my_agent

在哪里获取 adk-python？

源代码和安装说明在 GitHub 上：https://github.com/google/adk-python