Agent Development Kit (ADK)

这是一个开源的、代码优先（code-first）的 Python 框架，用于构建、评估和部署具有高度灵活性和可控性的复杂 AI Agent。

重要链接： 文档、示例、Java ADK、Go ADK 及 ADK Web。

Agent Development Kit (ADK) 是一个灵活且模块化的框架，它将软件开发原则应用于 AI Agent 的创建。它旨在简化 Agent 工作流程的构建、部署和编排，从简单任务到复杂系统皆可胜任。虽然 ADK 针对 Gemini 进行了优化，但它与模型无关、与部署环境无关，并兼容其他框架。

---

🔥 更新日志

• 自定义服务注册：添加了服务注册表，提供了一种通用方式来注册自定义服务实现，以便在 FastAPI 服务器中使用。详见简要说明。 (391628f)

• 回滚 (Rewind)：增加了将会话回滚到之前调用时间点的能力 (9dce06f)。

• 新增 CodeExecutor：引入了新的 AgentEngineSandboxCodeExecutor 类，支持使用 Vertex AI Code Execution Sandbox API 执行 Agent 生成的代码 (ee39a89)。

✨ 核心功能

• 丰富的工具生态：利用预构建工具、自定义函数、OpenAPI 规范、MCP 工具或集成现有工具，赋予 Agent 多样化的能力，所有这些都与 Google 生态系统紧密集成。

• 代码优先开发：直接在 Python 中定义 Agent 逻辑、工具和编排，以实现极致的灵活性、可测试性和版本控制。

• Agent 配置：无需编写代码即可构建 Agent。查看 Agent 配置 功能。

• 工具确认：提供 工具确认流程 (HITL)，可以通过明确的确认和自定义输入来保护工具的执行。

• 模块化多 Agent 系统：通过将多个专业 Agent 组合成灵活的层级结构，设计可扩展的应用程序。

• 随处部署：轻松容器化并将 Agent 部署到 Cloud Run，或利用 Vertex AI Agent Engine 进行无缝扩展。

🚀 安装

稳定版本（推荐）

你可以使用 pip 安装最新稳定版的 ADK：

pip install google-adk

版本发布周期大约为两周一次。对于大多数用户，推荐使用此版本，因为它代表了最新的官方发布。

开发版本

Bug 修复和新功能会首先合并到 GitHub 的 main 分支。如果你需要使用尚未包含在官方 PyPI 发布版中的更改，可以直接从 main 分支安装：

pip install git+https://github.com/google/adk-python.git@main

注意：开发版本直接从最新的代码提交构建。虽然它包含了最新的修复和功能，但也可能包含稳定版中不存在的实验性更改或 Bug。主要用于测试即将到来的更改或在正式发布前获取关键修复。

🤖 Agent2Agent (A2A) 协议与 ADK 集成

为了进行远程 Agent 间的通信，ADK 集成了 A2A 协议。 参考此 示例 了解它们如何协同工作。

📚 文档

探索完整文档，获取关于构建、评估和部署 Agent 的详细指南：

• 文档

🏁 功能亮点

定义单个 Agent：

from google.adk.agents import Agent
from google.adk.tools import google_search

root_agent = Agent(
    name="search_assistant",
    model="gemini-2.5-flash", # 或你首选的 Gemini 模型
    instruction="You are a helpful assistant. Answer user questions using Google Search when needed.",
    description="An assistant that can search the web.",
    tools=[google_search]
)

定义多 Agent 系统：

定义一个包含协调者 Agent（coordinator）、问候者 Agent（greeter）和任务执行 Agent 的多 Agent 系统。