扩展 Gemini API 中的托管代理：后台任务、远程 MCP 等
我们新增了对后台执行、异步交互、轻松连接远程 MCP 服务器、自定义函数以及凭证刷新等功能的支持。
今天，我们宣布了 Gemini API 中托管代理 (Managed Agents) 的新功能，包括后台执行、远程 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，客户端应用可以使用该ID轮询状态、流式获取进度，或在代理远程完成操作后重新连接。更多详情请参阅后台执行指南。
远程 MCP 服务器集成
现在，您无需编写自定义代理中间件来访问私有数据库或内部API，而是可以直接将受管代理连接到远程模型上下文协议（MCP）服务器。
您可以将远程工具与内置沙箱功能混合搭配使用。在交互时，将 mcp_server 工具与Google搜索或代码执行一同传入，让代理从其安全沙箱中与您的端点通信。在通过外部工具和API扩展代理时，请遵循最佳实践。
自定义函数调用与沙箱工具结合
在本地执行时，您可以将自定义工具与内置沙箱工具一起添加。API使用步骤匹配。内置工具将在服务器上自动运行，而自定义函数则会将交互转换为 requires_action 状态，以便您的客户端执行本地业务逻辑。
网络凭证刷新
访问令牌和短期API密钥会过期。您可以在下一次交互时，通过传入现有的 environment_id 并附带新的网络配置来刷新凭证或轮换密钥。新规则会立即替换旧规则。您的沙箱会保持其文件系统状态、已安装的软件包和克隆的仓库不变。
开始使用受管代理
这些更新将受管代理转变为异步工作器，能够在真实的开发环境中运行，而不会阻塞您的应用程序。