Vertex AI Extensions 将于 11 月 26 日关闭：Agent Platform 三条迁移路径详解

Google 于 2026 年 5 月 26 日悄然宣布弃用 Vertex AI Extensions，并将硬性关闭日期定为 2026 年 11 月 26 日——正好六个月后。对于在代码解释器、Google Search 或自定义 Extension 之上构建了 Agent 工作流的工程团队来说，这是一次有真实截止时间的强制架构迁移。以下是变更内容、重要原因及迁移方法。

发生了什么

Vertex AI Extensions 是一个托管运行时层，允许 Gemini 模型在生成请求中调用预构建或自定义工具服务器。三种主要 Extension 类型为：

• 代码解释器——在对话中执行 AI 生成代码的托管沙箱
• Google Search——注入模型上下文的有基础检索
• 自定义 Extension——用户定义的 OpenAPI 规范工具，在 Vertex 中注册

Google 现已将这些功能迁移到 Gemini Enterprise Agent Platform（前身为 Reasoning Engine / Agent Engine），即其新一代托管 Agent 运行时。Extensions API 将在 2026 年 11 月 26 日之后停止接受请求，此后不设任何宽限期。

对 AI 工程团队的影响

Vertex AI Extensions 通常是企业级 Gemini 部署中的粘合层。使用以下场景的团队均受影响：

1. 数据科学或金融工作流中的代码执行——替换代码解释器 Extension 需要多步 SDK 变更，而非简单的配置切换。
2. 带 Google Search 基础的 RAG 流水线——Search Extension 正被 Agent Platform SDK 中的原生 Gemini 基础功能和 GoogleSearch 工具取代。
3. OpenAPI 规范自定义工具——自定义 Extension 需要迁移到 Agent Platform 的 FunctionTool 或 MCPTool 模式，包括重新注册 Schema 定义并更新调用逻辑。

基于 Extension 的方案将编排逻辑置于 Vertex 的托管层。Agent Platform 将控制权转向 Agent Development Kit（ADK），这意味着需要编写更多代码，但也带来更强的可移植性。

三条迁移路径

代码解释器 → Agent Platform 代码执行沙箱

直接替代方案是 ADK 中的 AgentEngineSandboxCodeExecutor 或 google-genai SDK 中的 code_execution 工具，两者均运行隔离的有状态沙箱。从运营角度看，主要区别在于：沙箱资源名称现在需要单独预配并在运行时传入。运行大量并行会话的团队应评估沙箱池化策略和会话生命周期管理。

Google Search Extension → 原生 Gemini 基础功能

GoogleSearch 工具现在是 Gemini 生成请求中的一等参数。对于通过 Extensions API 路由以获取网络基础答案的团队，切换到 SDK 中的 tools=[types.GoogleSearch()] 可消除额外的网络跳转和 Extension 注册开销。对于使用 Vertex AI Search（企业语料库）的团队，等效方案是 VertexAISearch。

自定义 Extension → Agent Platform 函数 / MCP 工具

自定义 Extension 定义为在 Vertex 控制台中注册的 OpenAPI 规范。Agent Platform 的等效方案包括 FunctionTool（内联 Python 函数）、OpenAPITool（外部 OpenAPI 规范）或 MCPTool（Model Context Protocol 服务器）。MCPTool 路径可移植性最强——如果您已通过 MCP 暴露工具，迁移基本上只是注册表更新。具有复杂请求/响应 Schema 的自定义 Extension 则需要进行 Schema 映射工作。

路由与成本角度

如果您的团队通过 TheRouter 的 OpenAI 兼容网关路由到 Google，弃用本身不会改变路由配置——模型 ID 和端点行为不受影响。变化的是路由层上游的工具调用架构。

迁移也是一个好时机，重新评估 Agent 的工具调用是否需要完全在 Vertex 托管运行时内部完成。ADK 专为 Vertex 原生部署设计，但需要提供商可移植性的团队——针对 Anthropic、OpenAI 或 DeepSeek 运行相同 Agent——可能更倾向于提供商无关的工具调用层。

关键决策：ADK 与提供商无关编排

11 月 26 日前的行动清单

1. 审计 Extension 使用情况——在 Vertex AI 控制台列出所有已注册的 Extension，并将其映射到三种类别。具有复杂认证流程的自定义 Extension 迁移耗时最长。
2. 测试代码解释器替代方案——ADK 沙箱执行器与 code_execution 工具具有不同的会话语义。验证工作负载的状态保持需求。
3. 优先迁移 Search Extension——工作量最小；对大多数工作负载而言，GoogleSearch 工具是一行 SDK 变更。
4. 验证自定义 Extension Schema 映射——OpenAPI 到 FunctionTool 的转换在 Schema 边界情况（可空联合、allOf/anyOf 模式）可能静默失败。用代表性输入进行测试。
5. 更新可观测性钩子——Extension 在 Vertex 日志中产生独立的审计记录。Agent Platform 的日志格式不同，需更新监控查询。

11 月 26 日截止日期给团队约五个月时间。听起来很充裕，但考虑到 Q3 工程节奏的典型放缓以及预发布和负载测试，现在启动审计才是正确时机。

参考资料

• Vertex AI Extensions 弃用公告
• 迁移指南：Extensions → Agent Platform