开源adk-python Releases·原文 2026年11月7日

Google ADK Python 2.14.0发布:执行环境、A2A与评估模块转正

该版本将执行环境、A2A集成、评估和核心运行时模块从实验性状态转为稳定,并新增多次运行评估、工具参数语义匹配、Microsoft Teams与OpenAI Decisions集成;发布说明称 30 节点工作流的 200 轮运行提速 23%、峰值内存降低 9%。

AI解读:Google的adk-python发布v2.14.0(2026-11-04)。发布说明将本次列为主要变化的是:执行环境、A2A、评估和核心运行时模块从实验性转为稳定。

稳定范围包括BaseEnvironment、LocalEnvironment、EnvironmentToolset、DaytonaEnvironment、E2BEnvironment,以及 26 个认证、环境、应用、CLI和缓存模块与 16 项工具集和集成特性。

发布说明称,这些特性转正后,即使用ADK_DISABLE_前缀的环境变量、override_feature_enabled(..., False) 或 --disable_features也无法再禁用它们,并且不会报错或警告。

评估方面新增MultiRunConfig(adk eval --num_runs)和 --parallelism,可并发重复运行同一评估用例并汇总分数或通过率;ToolArgsMatcher支持精确、忽略大小写、数值容差和由LLM支持的语义比对。

性能方面,发布说明称 30 节点工作流的 200 轮运行比此前快 23%,峰值内存低 9%。该数据来自项目方发布的说明,未给出测试环境细节。

破坏性变更包括:Enum类型工具参数改为接收枚举成员而非原始字符串;VertexAiSessionService.create_session仅接受指定会话配置参数;RunSkillScriptTool在环境模式下不再接受自由格式的command,只支持 .py、.sh、.bash脚本。

Google的adk-python发布v2.14.0(2026-11-04)。发布说明称,本次将执行环境与沙箱、A2A集成、评估和核心运行时模块从实验性转为稳定,并新增多轮次评估、语义化工具参数匹配,以及Microsoft Teams和OpenAI Decisions两项集成。

转正范围与禁用行为变化

发布说明列出转为稳定的执行环境类:BaseEnvironment、LocalEnvironment、EnvironmentToolset、DaytonaEnvironment、E2BEnvironment。另有 26 个认证、环境、应用、CLI和缓存模块,以及 16 项工具集和集成特性(含Bigtable、Computer Use、GCS、MCP agent server、Pub/Sub、Spanner等)从实验性转正。

发布说明称,这 16 项特性转正后始终可用:ADK_DISABLE_前缀环境变量、override_feature_enabled(..., False) 和 --disable_features不再能阻止它们,且不返回错误或警告。

评估:多次运行与参数语义匹配

新增MultiRunConfig(adk eval --num_runs)和 --parallelism,可把每个评估用例并发运行多次,并汇总各次运行的分数或通过率。

ToolArgsMatcher用于在评估和EnvironmentSimulation中比对工具调用参数,支持精确匹配、忽略大小写、数值容差和由LLM支持的语义检查。

AgentEvaluator现在可以接收运行时构建的BaseNode或App;--eval_storage_uri可将评估文件存放到只读agents_dir之外。

集成与文件读写

新增TeamsRunner,用于把ADK agent接入Microsoft Teams聊天和频道;新增OpenAIDecisionsClassifier,调用OpenAI Decisions API对工作流与工具准入问题进行分类。MongoDbMemoryService增加向量检索(retrieval_mode="vector" 或 "auto")和TTL过期(memory_ttl_days)。

文件读写方面,BaseEnvironment.read_file_stream在LocalEnvironment、E2BEnvironment、DaytonaEnvironment中分块流式读取,ReadFileTool可按行范围读取而不必整体载入内存。AgentEngineEnvironment支持大文件分块读写,并把超过 570 秒的命令在服务截止时间前标记为超时。ContainerCodeExecutor支持输入和输出文件。

破坏性变更与兼容性

Enum类型工具参数现在以枚举成员形式传入,而非模型发出的原始字符串。发布说明称,对普通Enum,arg == "value"、以字符串为键的字典查找、对字符串做match、json.dumps和字符串方法将不再可用;可调用的require_confirmation仍接收原始值(除非启用FUNCTION_TOOL_ARG_VALIDATION)。

VertexAiSessionService.create_session的额外关键字参数被限制为display_name、ttl、expire_time、labels及其驼峰别名;传入http_options、session_state、sessionId、wait_for_completion等会抛出ValueError。

RunSkillScriptTool在SkillToolset环境下不再接受自由格式的command,模型改为传args、short_options和positional_args;脚本只支持 .py、.sh、.bash。发布说明称,这关闭了一个可被提示注入的模型执行任意shell命令的漏洞。

性能与数据存储变化

发布说明称,长多轮工作流运行更快、内存更少:一个 30 节点工作流的 200 轮运行提速 23%,峰值内存降低 9%。该数据由项目方发布,未附测试环境细节。

DatabaseSessionService新建的PostgreSQL JSON列使用json而非jsonb,已有jsonb表不迁移并继续工作;依赖jsonb专有操作符或GIN索引的外部查询在新表上不可用。FirestoreSessionService将事件负载存为JSON字符串,现有会话可继续加载,但本版本写入的会话在回滚到 2.13.0 或更早版本后无法读取。

信息来源