Gemini API Managed Agents 新增后台执行、远程 MCP 与自定义函数等能力
Expanding Managed Agents in Gemini API: background tasks, remote MCP and more
Google 为 Gemini API 的 Managed Agents 新增后台执行、远程 MCP 服务器集成、自定义函数调用与凭证刷新功能。后台执行通过传入 `background: true` 异步运行任务,立即返回 ID 供轮询状态或流式获取进度。Managed Agents 可直接连接远程 MCP 服务器,无需自定义代理中间件,并能与内置沙箱工具(如 Google 搜索、代码执行)混合使用。自定义函数调用支持本地执行业务逻辑,内置工具自动在服务端运行。凭证刷新通过传递现有环境 ID 和新网络配置完成,沙箱内文件系统、已安装包和仓库保持不变。这些更新旨在帮助开发者构建可靠的生产级 AI 智能体。
Managed Agents 这次更新解决了异步执行和远程工具调用的痛点,让 Gemini 代理能真正跑在后台,对已经在用 Gemini API 做产品的开发者属于必读更新。
我们正在新增对多项能力的支持,例如用于异步交互的后台执行、便捷连接远程 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,就可以将托管智能体直接连接到 远程 Model Context Protocol(MCP)服务器。
你可以将远程工具与内置沙箱能力混合搭配使用。在交互时传入一个 mcp_server 工具,与 Google Search 或代码执行一起使用,让智能体从其安全沙箱中与你的端点通信。在通过外部工具和 API 扩展智能体时,请遵循 最佳实践。
自定义函数调用与沙箱工具并行使用
在用于本地执行的内置沙箱工具之外,添加 自定义工具。API 使用步骤匹配。内置工具将在服务器上自动运行,而自定义函数会将交互转换为 requires_action,以便你的客户端执行本地业务逻辑。
网络凭据刷新
访问令牌和短期 API 密钥会过期。你可以在下一次交互时,通过传入现有的 environment_id 并附带新的 网络配置 来刷新凭证或轮换密钥。新规则会立即取代旧规则。你的沙箱会保留其文件系统状态、已安装的软件包和已克隆的代码仓库,不受影响。
开始使用托管智能体
这些更新将托管智能体转变为异步工作者,它们可以在真实的开发环境中运行,而不会阻塞你的应用程序。
查看 Gemini Interactions API 概览 和 托管智能体快速入门,以探索自定义智能体定义、环境配置、网络规则和高级流式模式。
来源:Google Blog:AI(RSS) · blog.google