项目简介
Agent Development Kit (ADK)[1] 是 Google 开源的 Python 智能体开发工具包，采用 code-first 路线，面向构建、评估与部署复杂 AI Agent 应用。ADK 2.0 已全面转向基于图（Graph）的工作流运行时，支持路由、扇出/扇入、循环、重试、状态管理、动态节点与人机协同等编排能力，并提供 Task API 实现结构化 Agent 间委派。
项目在 GitHub 上拥有约 2 万 Star，Apache-2.0 协议，与 Gemini、Vertex AI 及多种第三方 LLM 后端深度集成，适合从原型验证到生产部署的全链路 Agent 开发。官方文档见 adk.dev[2]。
版本亮点
1. 默认模型切换至 Gemini 3 Flash Preview（破坏性变更）。 LlmAgent 未显式指定 model= 时，默认模型从 gemini-2.5-flash 改为 gemini-3-flash-preview，以应对 2026-10-16 起 gemini-2.5-flash 的下线计划。若需保持旧行为，请显式设置 model="gemini-2.5-flash"；DEFAULT_LIVE_MODEL 未变。
2. 适配 Google GenAI SDK v2.0.0（破坏性变更）。 interactions_utils.py 中基于回合的辅助函数重命名（如 convert_contents_to_turns → convert_contents_to_steps），术语从 "turns" 统一为 "steps"。直接调用这些工具函数的代码需同步更新。
3. OpenTelemetry 可观测性增强。 新增 AutoTracingPlugin 支持自动埋点；原生输出 gen_ai.client.* 指标；压缩摘要现包含思考过程与工具调用记录，便于生产环境追踪 Agent 行为与性能。
4. Live 与多 Agent 协作改进。 修复 Gemini 3.1 Flash Live 协议 1007 错误；Live 响应支持 turn_complete_reason 以捕获安全相关信息；A2A 转换可区分「需输入」与「需鉴权」状态；新增 RubricBasedMultiTurnTrajectoryEvaluator 用于多轮轨迹评估。
5. 工具链与安全加固。 标准化 request_input 工具支持 Agent 主动澄清；RestApiTool 与 OpenAPIToolset 暴露 httpx_client_factory；修复 GCS Skill 解压 Zip Slip、Agent Builder 路径遍历、FastAPI/Starlette CVE-2026-48710 等多项安全问题；MCP 初始化挂起与任务组泄漏亦已修复。
快速开始
通过 pip 安装或升级至 v2.2.0：
# 安装最新版 ADK
pip install -U google-adk==2.2.0
# 或从源码安装
git clone https://github.com/google/adk-python.git
cd adk-python
git checkout v2.2.0
pip install -e ".[dev]"
创建一个简单的 LLM Agent（若需沿用旧默认模型，显式指定 model）：
from google.adk.agents import LlmAgent
from google.adk.runners import InMemoryRunner
agent = LlmAgent(
name="assistant",
model="gemini-2.5-flash", # 或省略以使用 gemini-3-flash-preview
instruction="You are a helpful assistant.",
)
runner = InMemoryRunner(agent=agent)
response = runner.run("Hello, what can you do?")
print(response)
部署至 Agent Engine 时可使用新增的触发源选项：
adk deploy agent_engine --trigger_sources=pubsub,http YOUR_AGENT_PATH
适用场景
正在使用 ADK 2.x 构建多 Agent 工作流的团队。 若你的应用依赖 LlmAgent 默认模型或 interactions_utils 中的回合转换函数，升级前务必阅读破坏性变更说明并做回归测试；Live 对话、A2A 互操作与 OpenTelemetry 监控的用户可直接受益于本版本的稳定性与可观测性改进。
评估、部署与运维 Agent 平台的工程师。 新增的 Rubric 多轮轨迹评估器、BigQuery Agent Analytics 可靠性修复，以及 API Server 在客户端断开时中止运行（避免资源泄漏），使 ADK 更贴近生产级 Agent 平台的运维需求；安全补丁覆盖 OAuth、文件工具与依赖 CVE，建议尽快升级。
引用链接
[1]Agent Development Kit (ADK): https://github.com/google/adk-python
[2]adk.dev: https://adk.dev/2.0/
