Google发布Gemini API托管代理新功能,支持后台任务与远程MCP

新功能概览
Google 在 Gemini Interactions API 中为 托管代理(Managed Agents) 增添了四大核心能力:
- 后台异步执行:通过
background: true参数将交互转为后台任务,接口立刻返回任务 ID,客户端可轮询或流式获取进度。 - 远程 MCP 服务器集成:支持在沙箱环境中直接调用私有数据库或内部 API,只需在交互时传入
mcp_server工具即可。 - 自定义函数并行:在内置工具之外,开发者可以注册自定义函数,系统在需要本地业务逻辑时会返回
requires_action,由客户端完成后继续执行。 - 网络凭证刷新:提供凭证轮换机制,使用同一
environment_id携带新网络配置即可更新短期访问令牌,保证长期运行的安全性。
这些特性直接回应了开发者对 长时任务、内部系统接入 与 安全凭证管理 的痛点,让代理从实验室走向生产级别。
后台异步执行
传统的 HTTP 长链接在处理耗时任务时极易超时。新方案将任务调度到 Google 云端沙箱,立即返回任务 ID。后续可通过以下两种方式获取结果:
- 轮询:
GET /v1/agents/{id}/status查询状态。 - 流式:使用 WebSocket 或 SSE 持续接收进度事件。
此模型类似于服务器无状态的 任务队列,极大提升了前端响应速度与可靠性。
远程 MCP 服务器集成
MCP(Model Context Protocol)是 Google 为模型提供的统一上下文访问协议。通过在交互请求中加入 tool: { mcp_server: "https://my.internal/api" },托管代理即可在沙箱内安全地向企业内部服务发起请求,而无需自行搭建代理层。Google 建议结合 最小权限原则 与 TLS 双向认证 来保护数据。
自定义函数与凭证刷新
托管代理默认提供代码执行、文件管理、网页搜索等内置工具。开发者现在可以注册自定义函数,例如 processInvoice(data),当模型判断需要本地业务逻辑时,会返回 requires_action,前端负责实际调用并将结果回传。与此同时,凭证刷新机制让 access_token 与 api_key 可以在同一环境中循环更新,只需在下次交互时提供新的 network_config 即可,无需重新创建环境。
快速上手指南
- 安装 SDK:
npm i @google/genai或使用 Python 包google-genai。 - 启用托管代理:在 Google Cloud 控制台创建 Environment,记下
environment_id。 - 调用示例(JavaScript):
const { GeminiClient } = require('@google/genai'); const client = new GeminiClient({apiKey: 'YOUR_KEY'}); const response = await client.interact({ environment_id: 'env-123', background: true, tools: [{mcp_server: 'https://internal.api'}], prompt: '帮我生成本月销售报告并上传到内部系统。' }); console.log('Task ID:', response.id); - 监控与调试:使用 Google Cloud Logging 查看沙箱日志,确保凭证轮换成功。
市场影响
这套完整的托管代理生态链让 生成式 AI 从 对话 向 业务自动化 跨越,尤其适用于客服、数据处理、企业内部工具等场景。随着更多企业采用云原生架构,Google 的这一步骤也为竞争对手设定了新的功能基准。
“托管代理现在可以像微服务一样独立运行,开发者只需关注业务逻辑,而不必担心底层执行环境的可靠性。” — Philipp Schmid,Google DeepMind 开发者关系工程师
如需完整技术细节,请参考 Gemini Interactions API 文档 与 后台执行指南。