Gemini API 托管代理更新：后台任务、远程 MCP 与凭证刷新
Google 在 2026 年 7 月 7 日为 Gemini API 的 Managed Agents 增加了一组面向长任务和外部工具的新能力，包括后台执行、远程 MCP 服务器、自定义函数调用以及运行期间的凭证刷新。
Managed Agents 通过 Interactions API 工作。应用提交一项任务后，Google 可以在隔离的远程环境中完成推理、代码执行、软件包安装、文件管理和网络访问，再返回任务过程与最终结果。
四项更新分别解决什么
后台执行
长任务不再需要一直维持 HTTP 连接。请求设置为后台运行后，接口会立即返回任务 ID；客户端可以轮询状态、读取进度，或稍后重新连接。这更适合代码分析、资料整理和批量文件处理。
远程 MCP
托管代理可以连接获得授权的远程 MCP 服务器，在隔离环境中使用企业内部工具。这样可以减少为每个数据源编写专用代理层的工作，但不代表所有 Gemini 模型都已经支持远程 MCP，接入前仍要检查具体模型和代理的兼容表。
自定义函数
内置的搜索和代码执行工具可以在服务端完成；遇到业务系统的自定义函数时，任务会进入等待状态，由客户端执行本地逻辑，再把结果送回代理。付款、发信、删除数据等高影响操作适合放在这一层保留人工确认。
凭证刷新
短期访问令牌过期后，可以在保留原有远程环境和文件状态的情况下更新网络凭证。这样不必因为密钥轮换而重新运行整项任务。
数据保存需要单独注意
当前 Interactions API 默认保存交互，以支持后台任务、服务端上下文和过程追踪。Google 文档列出的默认保留期为：付费层 55 天，免费层 1 天；付费项目可以在 AI Studio 中选择更短的 7、14、28 或 55 天窗口，也可以通过 API 删除记录。
如果设置 store=false，可以改为无状态方式，但后台执行和通过 previous_interaction_id 延续对话将不可用。处理客户数据或内部代码前，需要先根据业务合规要求决定是否允许服务端保存。
上线前的实际检查
- 为远程网络访问设置明确的域名白名单；
- 给每个 MCP 工具分配最小权限和短期凭证；
- 为任务设置最大运行时间、预算和失败重试次数；
- 对外部写入操作增加客户端审批；
- 保存任务 ID和环境 ID，但不要把 API Key 写进日志；
- 使用一组真实任务测试成本、正确率和中断恢复。
托管环境减少了自建代理执行器的基础设施工作，但权限、数据保留和费用控制仍由应用方负责。它更适合边界清楚、可以追踪和验收的工作流，不适合直接获得无限制的生产权限。
参考资料
- Google：Expanding Managed Agents in Gemini API
- Gemini API：Interactions API
- Gemini API：Managed Agents Quickstart
本文依据 Google 官方公告和开发文档独立整理。封面图片来自 Google 官方公告，版权归 Google 所有，仅用于报道和技术说明。
