Google Agent Development Kit(ADK)Python 于 2026-09-25 发布 v2.10.0(changelog 标 2026-09-24):实验性 Skill 生命周期(EPHEMERAL、active-skill 上限、unload_skill,需 ADK_ENABLE_SKILL_LIFECYCLE=1)、MongoDB toolset 向量/混合检索、评测新增 duration/token/model-call 效率指标,并强化 OpenAI reasoning 参数适配与 reasoning token 上报;PyPI google-adk 2.10.0 已同步。

核心要点速览 (Key Takeaways)

  • ✓发布:v2.10.0 同步 PyPI google-adk 2.10.0,文档 adk.dev
  • ✓Skill(实验):`ADK_ENABLE_SKILL_LIFECYCLE=1` 开启 EPHEMERAL 单轮生命周期、active-skill 上限与 opt-in `unload_skill`;卸载后指令从后续请求剔除
  • ✓数据:新增 MongoDB toolset,支持向量检索与 hybrid search,嵌入 agent 流程内直接查库
  • ✓评测:ADK eval 新增 duration 效率指标,并上报 token 消耗与 model call counts,便于压成本与延迟
  • ✓模型:OpenAI reasoning 自动适配请求参数并上报 reasoning tokens;`OpenAIResponsesLlm` 忽略 thinking_config,改用 `OpenAIGenerateContentConfig.effort`;`adk create` 增加 gemini-3.8-flash
🔬

深度技术解析与实战评估

核心背景与行业痛点

多智能体框架要把 Skill/工具目录、向量库检索与评测成本治理绑在同一条 Python 运行时上。痛点集中在:Skill 常驻撑爆上下文、数据库检索要另接一套客户端、评测只看准确率看不到时长/Token/调用次数、OpenAI reasoning 模型参数与 token 口径不一致。Google ADK Python v2.10.0(2026-09-25 发版,changelog 标 2026-09-24)针对这些工程摩擦做了一轮能力补齐。

架构亮点与底层机制

实验性 Skill 生命周期需设置 ADK_ENABLE_SKILL_LIFECYCLE=1:支持 EPHEMERAL(仅一回合)、active-skill 上限、opt-in unload_skill,卸载后指令从后续请求剔除;SkillDiscoveryMode 控制目录披露。新增 MongoDB toolset,在 agent 流程内做向量与 hybrid search。OpenAI 集成迁至 google.adk.integrations.openai(google-adk[openai] extra),自动适配 reasoning 请求参数并上报 reasoning tokens;OpenAIResponsesLlm 忽略 thinking_config,改走 OpenAIGenerateContentConfig.effort。BigQuery protected write 仅允许 dry-run 落在会话匿名数据集的非 SELECT;protected mode 会话改为进程内存,重启/副本不携带临时表。

权威 Benchmark 与实测跑分对比

官方未发布端到端 SWE/AgentBench 分数,但评测面可量化:ADK eval 新增 duration 效率指标,并记录 token 消耗 与 model call counts,便于按成本/延迟做回归。AgentEvaluator.evaluate / evaluate_eval_set 在零用例时改为抛 ValueError,避免空跑假绿。开发者应以自有 eval set 对比开启 Skill 生命周期前后的 token 与调用次数,而不是依赖笼统榜单。

开发者实战落地与开箱指南

安装:pip install -U google-adk==2.10.0(OpenAI 面可加 [openai])。入门见 adk.dev/get-started 与 adk-docs。启用 Skill 生命周期:export ADK_ENABLE_SKILL_LIFECYCLE=1。adk create 模型选项新增 gemini-3.8-flash;遗留 google.adk.flows.llm_flows 下 live-audio 模块已 DeprecationWarning,请迁到 google.adk.live(-W error 测试会失败)。完整变更见 CHANGELOG。