开源adk-python Releases·原文 2026年10月2日

Google ADK Python发布v2.11.0:支持优雅取消、工具确认与SQLite记忆服务

ADK Python v2.11.0于 2026 年 10 月 1 日发布,新增执行取消、工作流工具确认、中途咨询另一模型的ModelConsultTool和内置SQLite记忆服务,并包含一项破坏性变更:Dev UI运行时配置改由服务器提供,不再写入安装包。

AI解读:Google的ADK Python发布了 2.11.0 版,时间点选在 10 月 1 日。这次更新主要解决两件事:让长时间运行的Agent任务能被人为体面地停下,以及让工作流里的工具调用在敏感操作前先等用户点头。

最实用的变化是执行取消。你可以给Runner、Workflow和节点传一个abort_signal,用它主动停止运行;如果客户端断开连接,/run_sse也会自动取消对应的执行。这对跑LLM任务的人来说很有用——以前HTTP连接断了任务可能还在烧钱,现在至少有一条官方的刹车路径。

另一个值得注意的新东西是ModelConsultTool:允许Agent在任务中途去问另一个模型,但每轮对话和整个会话都有调用预算限制,不是随便问。配套的还有内置SQLite记忆服务,用sqlite:// 作为记忆服务URI就能把Agent记忆存在本地数据库里,对不方便接外部服务的场景更友好。

破坏性变更也要留意:Dev UI的runtime-config.json不再写进安装包,改由Web服务器按请求动态提供。如果你改过或读过那个文件,现在得改用 --logo-text和 --logo-image-url来设置logo,配置从服务器拉取。升级前最好确认自己的部署脚本没有依赖旧路径。

其余更新包括MCP SDK 2.x的现代协议连接路径、工具确认在工作流中通过RequestInput暂停等待用户批准、BigQuery工具在CMEK要求下运行等。完整变更列表很长,涉及不少bug修复和插件行为调整,建议升级前阅读release notes。

Google的Agent Development Kit(ADK)Python版本v2.11.0于 2026 年 10 月 1 日发布,对比v2.10.0带来多项功能更新和一项破坏性变更。

执行取消:给Runner、Workflow和节点加刹车

此版本新增执行取消能力。开发者可以向Runner、Workflow以及节点传入abort_signal,从而优雅地停止一次运行。根据发布说明,/run_sse现在会在客户端断开连接时取消对应的运行。相关细节参见ADK文档中的runner abort单元指南。

  • abort_signal可传给Runner、Workflow和Nodes(提交ef5bbcf,关联issue #4796)。
  • cli中将abort_signal连接到 /run_sse,在客户端断开时触发取消(提交 3d73603)。
  • 取消时会合成abort事件和函数响应(提交da65851)。
  • 调用方被取消时,会取消正在进行的工具调用(提交f0dd560)。

工作流中的工具确认:暂停等待用户批准

工具节点现在会像LlmAgent一样,通过RequestInput暂停以等待用户批准,而不是把错误传递到下游。同时修复了在工具确认请求之前持久化同级工具结果的问题,并且保留与失败节点同一时间片内完成的兄弟节点的输出。

  • 工具节点通过RequestInput暂停等待用户批准(提交ce132b9)。
  • 在同级工具确认请求前持久化工具结果(提交 67d3e49,关联issue #6732)。
  • 保留与失败节点同一tick内完成的兄弟节点输出(提交 2c759e9)。

ModelConsultTool:任务中途咨询另一个模型

新增ModelConsultTool,允许Agent在任务执行中途咨询另一个模型,调用受到per-turn和per-session预算限制。发布说明提到有相应的开发者指南和示例agent。新增了模型咨询的会话上下文交接层,并让advisor模型在不带工具的情况下被调用。

  • ModelConsultTool受每轮和每会话预算上限约束(提交 84cc99a)。
  • 新增模型咨询会话上下文交接层(提交b2da4c6)。
  • 顾问模型在model_consult中不使用工具调用(提交 28c47b5)。
  • 将model_consult顾问提示打包为单个用户内容块(提交ecb429c)。

SQLite记忆服务:本地数据库保存Agent记忆

新增内置SQLite记忆服务,可将Agent记忆保存在本地SQLite数据库中。使用sqlite:// 形式的记忆服务URI即可选用该服务。此外还新增了一个示例,将记忆配置预加载到指令中。

  • SQLite记忆服务可通过sqlite:// 记忆服务URI选用(提交 9625b06)。
  • 新增示例,将记忆配置预加载到指令中(提交fdf1b7f)。
  • 修复SQLite迁移报告实际迁移事件的问题(提交 31e5358,关联issue #7298)。

MCP SDK 2.x:可选现代协议连接路径

新增一条可选的现代协议连接路径,用于通过MCP SDK 2.x连接MCP服务器。此外还修复了多个MCP相关问题,包括检测位于dispatcher之后的失效MCP会话、在adk web下加载已验证的MCP toolset,以及从MCP _meta传递grounding元数据。

  • 新增MCP SDK 2.x的现代协议连接路径(提交e738c26)。
  • 检测transport位于dispatcher后的失效MCP会话(提交 8632980)。
  • 在adk web下加载已验证的MCP toolset(提交f44d512,关联issue #6735)。
  • 从MCP _meta传递grounding元数据(提交 0960104,关联issue #6081)。

破坏性变更:Dev UI运行时配置改由服务器提供

此版本有一项破坏性变更。Web服务器现在按请求提供 /dev-ui/assets/config/runtime-config.json,不再将runtime-config.json写入安装包。如果你曾编辑或读取该文件,需要使用 --logo-text和 --logo-image-url设置logo,并从服务器获取配置。发布说明注明提交 3722746。

  • Dev UI运行时配置不再写入安装包,改由服务器按请求提供(提交 3722746)。
  • 设置logo改用 --logo-text和 --logo-image-url命令行参数。
  • 配置需从服务器获取,而非读取本地文件。

信息来源