Gemini API托管代理：3.6 Flash、钩子等新功能

Gemini API的托管代理（Managed Agents）功能迎来重大更新，现在默认使用Gemini 3.6 Flash模型，并引入了环境钩子（Environment Hooks）、预算控制、定时触发器和免费层级访问。这些新能力建立在之前发布的背景任务和远程MCP服务器集成基础之上，旨在帮助开发者构建更可靠、更可控的生产级代理。

托管代理通过Gemini Interactions API，只需一次API调用即可在隔离的云沙盒中协调推理、代码执行、包安装、文件管理和网络检索等操作。对于使用AI编码助手的开发者，可以通过命令npx skills add google-gemini/gemini-skills --skill gemini-interactions-api快速启用Interactions API技能。

Gemini 3.6 Flash成为默认模型

从antigravity-preview-05-2026代理开始，托管代理默认运行Gemini 3.6 Flash模型，无需任何代码更改即可自动升级。开发者也可以通过传递agent_config.model参数显式选择其他模型，例如使用Gemini 3.5 Flash-Lite以降低成本和延迟。支持的模型包括：

• Gemini 3.6 Flash（默认）：推理、编码和工具使用的平衡模型。
• Gemini 3.5 Flash：前代模型，适用于通用代理工作流。
• Gemini 3.5 Flash-Lite：Gemini 3.5系列中延迟和成本最低的模型。

环境钩子：在沙盒内拦截工具调用

环境钩子允许开发者在代理每次调用工具之前或之后运行自定义脚本。通过在环境中添加.agents/hooks.json配置文件，可以定义pre_tool_execution和post_tool_execution事件的处理程序。钩子支持正则表达式匹配工具名称，例如：

• 在code_execution或write_file调用前运行安全审查脚本，如果返回拒绝决策则跳过该工具调用。
• 在所有工具调用后运行自动格式化脚本，以确保代码风格一致。

钩子还支持HTTP类型，可直接向外部端点发送POST请求。AI原生投资银行Offdeal已利用post_tool_execution钩子在远程沙盒中实现自动图像验证，确保公司标识符合质量和格式要求。

成本控制与自动化功能

托管代理现已在免费层级项目中可用，开发者无需绑定支付方式即可体验代理工作流。为避免多轮自主循环消耗过多令牌，可以通过max_total_tokens参数设置预算上限。当达到限制时，执行会安全暂停并返回状态"incomplete"，环境状态保留，开发者可以通过传递previous_interaction_id和新的预算继续执行。

此外，定时触发器（Scheduled Triggers）支持将代理、环境、提示和cron计划绑定为持久资源，自动执行重复任务。每次运行复用同一沙盒，文件可在执行间持久化。

新的环境API（Environments API）允许开发者通过代码列出、检查和删除沙盒会话，例如在断线后恢复环境ID，或在工作流完成后清理沙盒，无需等待7天的TTL。

这些更新将托管代理转变为成本可控、可调度的自主工作者，能够在真实开发环境中独立运行，无需外部编排。开发者可以查阅Gemini Interactions API概览和托管代理快速入门指南，探索自定义代理定义、环境配置、网络规则和高级流式模式。