ADK-Python v1.29.0（2026-04-10）· MCP Registry 鉴权与 Bash 加固

【DreamAI梦幻智能导读】

ADK-Python（Google adk-python）是一套面向 Python 的代码优先型开源 Agent 工具包，用于构建、评测与部署可编排工具与模型的智能体，典型用户为需要在本地或 Google Cloud/Vertex 上落地 Agent 工作流的开发者与平台工程师。

v1.29.0 在 MCP 工具集 与 鉴权 上增量最大：Agent Registry 场景下可为 MCP 工具集配置 auth_scheme/凭据并补充 HTTP 头，同时提供注册自定义 auth provider 的公开 API；运行侧新增 EnvironmentToolset/LocalEnvironment，并对 BashTool 增加 shell 元字符拦截、子进程资源上限与更稳健的进程组/超时管理。另有 Vertex AI Session Service 对 raw_event 与自定义 session id 的调整、BigQueryLoggerConfig 的 view_prefix、CLI 的 Easy GCP 支持，以及一批 A2A、live、评测与遥测相关的修复。条目顺序与 GitHub Release 一致，细节见下文与参考资料¹。

版本概览

完整更新日志

功能

Agent Registry/MCP 工具集：为 MCP toolset 增加鉴权方案（auth scheme）与凭据支持，便于安全接入受保护 MCP Server。

BashTool：新增能力以拦截 shell 元字符，降低意外命令注入面。

BashTool：子进程支持可配置的资源上限。

BigQueryLoggerConfig：新增可配置 view_prefix。

Vertex AI Session Service：支持自定义会话 session id。

SKILL.md：增加 Description 列并更新术语表述。

ADK CLI：增加 Easy GCP 相关支持。

SecretManagerClient：支持区域化 endpoint（regional endpoint）。

Agent Registry：支持为模型配置端点（model endpoints）。

auth：提供公开 API，用于向凭据管理器注册自定义 auth provider。

auth：将 consent_nonce 传递给 Agent Frontend。

auth：MCP 工具支持附加 HTTP 头。

bigquery：为 ADK BQ Toolset 增加一方 ADK Skills（1P Skills）。

environment：新增 EnvironmentToolset，覆盖文件读写与命令执行类能力。

environment：新增 LocalEnvironment，用于本地命令执行与文件 I/O。

BashTool：实现更稳健的进程组管理与超时行为。

live：补充说明在 v1.28.1 已加入的 gemini-3.1-flash-live-preview 的 live 支持。

InMemorySessionService：支持对会话采用浅拷贝（shallow-copy）选项。

在线程池执行路径上传播上下文（context）。

公共代码与示例：在缺少 token 时尝试刷新凭据。

Vertex AI Session Service：移除对 raw_event 字段的既有使用方式（为后续读写语义调整铺路）。

skill：标准化 skill 相关工具并让脚本参数更灵活。

支持 AgentRegistry 关联（association）。

支持从 Visual Builder 加载 agent，并配合 BigQuery 记录日志。

AgentTool：支持传播 grounding 元数据。

RunSkillScriptTool：支持短选项与位置参数。

Vertex AI Session Service：在 append 与 list 事件路径上使用 raw_event 字段。

Vertex AI Session Service：使用 raw_event 存储事件数据（与上条配合形成新的持久化语义）。

修复

默认支持的传输列表加入 A2ATransport.http_json。

SseConnectionParams 增加 httpx_client_factory 支持。

adk：BigQuery 分析插件中对凭据做脱敏（redact）。

API 客户端初始化：ExpressMode 与 GCP 项目配置互斥，避免逻辑冲突。

adk web 服务端避免一次性加载全部 agent。

在同一调用周期内缓存 BaseToolset.get_tools() 结果。

cli：当 Agent Engine 部署配置文件路径无效时明确失败。

对 skill toolset 关闭工具缓存。

/builder 禁止附带参数，并在 CLI 帮助中提示 Web UI 使用风险。

修复 events_iterator 空赋值问题。

environment：修正包引用。

修复 RemoteA2AAgent 深拷贝（deepcopy）相关错误。

RemoteA2aAgent 初始化：支持传入首选传输、protocol 版本与鉴权 HTTP 头。

为流式 LLM 响应处理中的 FunctionCall 生成 ID。

deep_merge_dicts：合并列表行为修正。

内存会话服务：在循环开始前将字典键值评估为隔离快照序列。

评测中间数据：纳入子 agent 最终响应等中间事件。

live：处理会话恢复与 GoAway 信号（关联 #4996）。

将 BigQueryAgentAnalyticsPlugin 的导入移入 get_runner_async 以降低副作用。

ADK 内 UI 控件合并逻辑更安全。

Express mode 小幅修复。

call_llm span 与回调同步。

tools：canonical_tools 中对 toolset 错误更稳健（关联 #3341）。

v0 schema 中截断 error_message 以避免 VARCHAR 溢出（关联 #4993）。

更新 toolbox-adk 与 toolbox server 版本。

代码重构

将 SecretManagerClient 迁移至 google.adk.integrations.secret_manager 包。

A2aAgentExecutor 去除对 session events 的依赖。

文档

adk：清理 remote triggers README 中的内部引用。

更新 MCP Toolbox 文档站 URL。

参考资料

1. Google ADK-Python v1.29.0 Release（¹）：https://github.com/google/adk-python/releases/tag/v1.29.0^[3]  
2. v1.28.0…v1.29.0 对比与变更条目：https://github.com/google/adk-python/compare/v1.28.0...v1.29.0^[4]  
3. PyPI google-adk 包与项目元信息：https://pypi.org/project/google-adk/^[5]  
4. MCP Toolbox Python SDK 与 ADK 集成说明：https://mcp-toolbox.dev/sdks/python-sdk/adk/^[6]  
5. 社区文章：ADK 结合 Firestore 远程 MCP 的实践（背景阅读）：https://dev.to/gde/agentic-firestore-smarter-agents-with-adk-and-google-remote-firestore-mcp-3nj3^[7]

关于作者和DreamAI

https://docs.dingtalk.com/i/nodes/Amq4vjg890AlRbA6Td9ZvlpDJ3kdP0wQ^[8]

关注微信公众号“AI发烧友”，获取更多AI技术文档及IT开发运维实用工具与技巧

引用链接