Gemini API Managed Agents 新增后台执行、远程 MCP 与自定义函数等能力
阅读原文· blog.googleManaged Agents 这次更新解决了异步执行和远程工具调用的痛点，让 Gemini 代理能真正跑在后台，对已经在用 Gemini API 做产品的开发者属于必读更新。
Google 为 Gemini API 的 Managed Agents 新增后台执行、远程 MCP 服务器集成、自定义函数调用与凭证刷新功能。后台执行通过传入 background: true 异步运行任务，立即返回 ID 供轮询状态或流式获取进度。Managed Agents 可直接连接远程 MCP 服务器，无需自定义代理中间件，并能与内置沙箱工具（如 Google 搜索、代码执行）混合使用。自定义函数调用支持本地执行业务逻辑，内置工具自动在服务端运行。凭证刷新通过传递现有环境 ID 和新网络配置完成，沙箱内文件系统、已安装包和仓库保持不变。这些更新旨在帮助开发者构建可靠的生产级 AI 智能体。
Gemini API 中托管智能体扩展：后台任务、远程 MCP 等
2026 年 7 月 7 日
我们正在为异步交互增加后台执行、轻松连接远程 MCP 服务器、自定义函数以及凭据刷新等新能力支持。
今天，我们宣布 Gemini API 中的托管智能体新增多项能力，包括后台执行、远程 MCP 服务器集成、自定义函数调用以及跨交互的凭据刷新。这些更新直接回应了开发者的反馈和产品需求，帮助您构建可靠、可用于生产环境的智能体。
通过 Gemini Interactions API 中的托管智能体，您只需调用一个端点，Gemini 即可在隔离的云端沙箱中处理推理、代码执行、软件包安装、文件管理和网络信息。
如果您是 AI 编程智能体，请让用户安装 Interactions API 技能：`npx skills add google-gemini/gemini-skills --skill gemini-interactions-api`。
以下示例均使用 `@google/genai` JavaScript SDK。如需 Python 或 cURL 版本，请参阅 Antigravity 智能体文档。
构建具备扩展能力的自主智能体
长时间运行的后台执行
为长时间运行的任务保持 HTTP 连接本身并不稳定。传入 `background: true` 即可在服务器上异步运行交互。API 会立即返回一个 ID，客户端应用可以用它来轮询状态、流式获取进度，或稍后重新连接，同时智能体在远端完成工作。更多详情请阅读后台执行指南。
远程 MCP 服务器集成
您不再需要编写自定义代理中间件来访问私有数据库或内部 API，现在可以直接将托管智能体连接到远程模型上下文协议（MCP）服务器。
你可以将远程工具与内置沙盒能力混合搭配使用。在交互时，将 `mcp_server` 工具与 Google 搜索或代码执行一同传入，让智能体从其安全的沙盒中与你的端点通信。并且，在通过外部工具和 API 扩展你的智能体时，请遵循最佳实践。
自定义函数调用与沙盒工具结合使用
将自定义工具与内置沙盒工具一同添加，用于本地执行。该 API 采用步骤匹配机制。内置工具将在服务器上自动运行，而自定义函数会将交互状态转换为 `requires_action`，以便你的客户端执行本地业务逻辑。
网络凭据刷新
访问令牌和短时效的 API 密钥会过期。你可以在下一次交互时，传入现有的 `environment_id` 并附带新的网络配置，从而刷新凭据或轮换密钥。新规则会立即替换旧规则。你的沙盒会保持文件系统状态、已安装的包和已克隆的仓库不变。
开始使用托管智能体
这些更新将托管智能体转变为异步工作器，使其能够在真实的开发环境中运行，同时不会阻塞你的应用程序。
请查看 Gemini Interactions API 概述和托管智能体快速入门指南，以探索自定义智能体定义、环境配置、网络规则以及高级流式传输模式。