Gemini API 增强托管代理能力

关键信息

对于长时间任务，开发者可以设置 background: true，让 API 异步执行交互，并返回一个 ID 供轮询状态、流式获取进度或稍后重新连接。Google 还表示，托管代理现在可以直接连接远程 MCP 服务器，把远程工具与内置沙箱工具混合使用，并在通过 requires_action 交给客户端执行自定义函数时，在刷新凭证后仍保留文件系统状态和已安装的软件包。

资讯摘要

Google 正在为 Gemini API 的托管代理（Managed Agents）增加多项新能力，目的是改善真实场景中的智能体工作流。公司表示，这些变化直接来自开发者反馈，以及对更可靠、可用于生产环境的代理的需求。在 Gemini Interactions API 中，托管代理原本就允许开发者调用单一端点，而 Gemini 会在隔离的云沙箱内负责推理、代码执行、软件包安装、文件管理和网络信息获取。此次新增的能力包括后台执行、远程 MCP 服务器集成、自定义函数调用，以及跨交互刷新凭证。对于长时间运行的任务，开发者可以传入 background: true，让服务器异步执行，而不是一直保持 HTTP 连接打开。

API 会立即返回一个 ID，客户端可以用它来轮询状态、流式获取进度，或在稍后重新连接。Google 还表示，托管代理现在可以直接连接远程 Model Context Protocol 服务器，从而减少访问私有数据库或内部 API 时对自定义代理中间件的依赖。开发者可以把这些远程工具与沙箱内置能力结合使用，例如 Google Search 或代码执行；与此同时，自定义工具仍可以通过 requires_action 交给客户端去执行本地业务逻辑。最后，网络凭证刷新功能允许团队在使用新的网络配置时，复用现有的 environment_id 来轮换短期令牌或 API 密钥，同时保留文件系统状态、已安装的软件包和克隆的代码仓库。Google 将这些更新描述为把托管代理变成异步工作器，使其能够在真实开发环境中运行而不阻塞应用程序。

资讯正文

在 Gemini API 中扩展 Managed Agents：后台任务、远程 MCP 等

今天，我们宣布为 Gemini API 中的 Managed Agents 增加多项新能力，包括后台执行、远程 MCP 服务器集成、自定义函数调用，以及在交互过程中刷新凭据。这些更新直接回应了开发者反馈和产品需求，让你能够构建可靠、可投入生产的 agents。

通过 Gemini Interactions API 中的 managed agents，你只需调用一个端点，Gemini 就会在一个隔离的云端沙箱中处理推理、代码执行、包安装、文件管理以及网络信息。

如果你是 AI 编码 agent，请让你的使用者安装 Interactions API skill：npx skills add google-gemini/gemini-skills --skill gemini-interactions-api。

下面是使用 @google/genai JavaScript SDK 的示例。对于 Python 或 cURL，请查看 Antigravity agent 文档。

使用扩展能力构建自主 agents

长时间运行的后台执行

对于长时间运行的任务，保持 HTTP 连接一直打开并不稳定。传入 background: true，即可在服务器端异步运行交互。API 会立即返回一个 ID，客户端应用可用它来轮询状态、流式获取进度，或在 agent 于远端完成时稍后重新连接。更多细节请参阅后台执行指南。

远程 MCP 服务器集成

现在，你无需编写自定义代理中间件来访问私有数据库或内部 API，就可以将 managed agents 直接连接到远程 Model Context Protocol（MCP）服务器。

你可以将远程工具与内置沙箱能力混合使用。在交互时传入 mcp_server 工具，并与 Google Search 或代码执行一起使用，让 agent 能够从其安全沙箱中与你的端点通信。随着你用外部工具和 API 扩展 agent，请遵循最佳实践。

在沙箱工具旁使用自定义函数调用

除了内置沙箱工具外，还可以添加自定义工具，以便进行本地执行。API 使用 step matching。内置工具会在服务器上自动运行，而自定义函数会将交互切换为 requires_action，以便你的客户端执行本地业务逻辑。

网络凭据刷新

访问令牌和短期 API 密钥会过期。你可以在下一次交互中，通过传入现有的 environment_id 和新的网络配置来刷新凭据或轮换密钥。新的规则会立即替换旧规则。你的沙箱会保留其文件系统状态、已安装的软件包以及克隆的仓库不变。

开始使用 managed agents

这些更新把 managed agents 变成了异步工作器，它们可以在真实的开发环境中运行，而不会阻塞你的应用程序。

请查看 Gemini Interactions API 概览和 managed agents 快速入门，了解自定义 agent 定义、环境配置、网络规则以及高级流式传输模式。

来源与参考

1. 原始链接
2. Expanding Managed Agents in Gemini API: background tasks, remote MCP and more