Gemini API Managed Agents 新增
来自 Google Blog · AI · 期号 2026-07-29
摘要
Google 在 Gemini API 中为 Managed Agents 新增了 3.6 Flash 模型支持，并引入了 Hooks 和 Triggers 机制。Hooks 允许在 agent 执行前后插入自定义逻辑，Triggers 则支持基于事件或时间自动启动 agent。
深读
导读 Google 为 Gemini API 的 Managed Agents 新增了多项生产级能力：默认模型升级为 Gemini 3.6 Flash，引入了可在沙箱内拦截、检查工具调用的环境钩子（Hooks），并增加了预算控制、定时触发器和免费套餐。读完可以了解如何让 agent 在隔离沙箱中安全、可控地执行多步任务，而无需外部编排。 关键信息 - Managed Agents 默认模型从之前的版本升级为 Gemini 3.6 Flash，无需修改代码即可自动生效。开发者也可显式选择 Gemini 3.5 Flash 或 Gemini 3.5 Flash-Lite。 - 新增的 Environment Hooks 允许在 agent 每次工具调用前后执行自定义脚本，支持 pre_tool_execution 和 post_tool_execution 两种事件，可通过正则表达式匹配多个工具。 - 预算控制通过 agent_config 中的 max_total_tokens 参数实现，达到上限后 agent 执行安全暂停，返回 status: "incomplete"，环境状态保留，可通过 previous_interaction_id 继续执行。 - 定时触发器（Scheduled Triggers）支持将 agent、环境、提示词和 cron 表达式绑定为持久化资源，自动按计划执行，且每次运行复用同一沙箱，文件跨执行持久化。 - Managed Agents 现已面向 免费套餐项目 开放，开发者可使用未激活计费的 API key 进行实验。 逐节讲解 默认模型升级与模型选择 Managed Agents 的默认模型已更新为 Gemini 3.6 Flash，这是一个在推理、编码和工具使用上表现均衡的模型。开发者无需任何代码改动，下一次交互会自动使用新模型。同时，API 允许在创建交互时通过 agent_config.model 显式指定模型，例如选择 Gemini 3.5 Flash-Lite 以降低延迟和成本。支持的模型列表包括 Gemini 3.6 Flash（默认）、Gemini 3.5 Flash 和 Gemini 3.5 Flash-Lite。 环境钩子：在沙箱内拦截与审计工具调用 环境钩子是本次更新的核心功能。开发者可以在 agent 的沙箱环境中放置一个 .agents/hooks.json 配置文件，定义在工具调用前后执行的脚本。配置支持按工具名称匹配（支持正则），例如对 code_execution 和 write_file 这类高风险操作设置前置钩子，对全部工具设置后置钩子。钩子脚本返回 {"decision": "deny", "reason": "..."} 即可阻止该工具调用，拒绝理由会传入模型上下文。钩子也支持 HTTP 类…