项目简介
Agent Development Kit（ADK）是 Google 开源的 Python 智能体开发工具包，采用 code-first 设计理念，帮助开发者构建、评估和部署复杂的 AI Agent 系统。ADK 提供灵活的 Agent 编排能力，支持多 Agent 协作、工具调用、会话管理以及与 Gemini 等模型的深度集成，是构建生产级 AI 应用的重要基础设施。
ADK Python 在 GitHub 上拥有近 2 万 Star，发布节奏约为双周一次。项目同时维护 1.x 稳定分支与 2.x 新一代架构，1.34.x 系列面向仍在 1.x 生态上运行的生产环境，提供持续的安全修复与兼容性补丁。
版本亮点
修复 Gemini 3.1 Live 中 grounding metadata 被静默丢弃的问题。 在使用 Gemini 3.1 Live 实时对话时，模型返回的 grounding metadata（用于标注信息来源与检索依据）此前会被框架静默丢弃，导致开发者无法获取完整的引用上下文。本次修复确保 grounding 数据正确透传，便于构建可溯源的实时 Agent 应用。
修复 Gemini v3.1 输入/输出转录完成事件。 实时语音场景下，输入与输出转录的 finished 事件触发逻辑存在缺陷，可能导致 UI 状态不同步或流式响应提前结束。此版本对齐了 Gemini v3.1 的事件语义，转录生命周期回调更加可靠。
MCP 工具报错时不再导致会话意外断开。 当 Agent 调用 MCP（Model Context Protocol）工具发生错误时，旧版本会直接丢弃整个会话。修复后，工具层错误被正确隔离处理，Agent 会话得以保持，开发者可以捕获错误并重试或降级，显著提升 MCP 集成的稳定性。
快速开始
ADK Python 要求 Python 3.10 及以上版本，推荐使用虚拟环境安装：
# 创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 安装指定版本
pip install google-adk==1.34.2
# 如需评估、集成等扩展能力
pip install "google-adk[extensions]==1.34.2"
安装完成后，可通过 ADK CLI 快速验证：
# 查看 ADK 版本
adk --version
# 启动 Web 调试界面（需配置 Google API Key）
export GOOGLE_API_KEY="your-api-key"
adk web
如需从源码安装最新开发版：
git clone https://github.com/google/adk-python.git
cd adk-python
pip install -e .
适用场景
Gemini Live 实时语音 Agent 开发者。 如果你正在基于 Gemini 3.1 Live 构建语音对话、实时转录或多模态交互应用，本次修复直接影响 grounding 数据可用性与转录事件回调，建议尽快升级以避免生产环境中的静默数据丢失。
集成 MCP 工具链的 Agent 工程团队。 通过 MCP 协议连接外部工具（数据库、API、文件系统等）的 Agent 应用，在工具调用失败时不再因会话崩溃而丢失上下文，适合需要高可用工具编排的企业级场景。仍在 1.x 分支上的团队可平滑 patch 升级，无需迁移至 2.0 架构。
