资讯模型与产品··来源: Blog·原文 →

Gemini API 托管代理升级:默认 3.6 Flash 并支持环境钩子与预算控制

Google Gemini API 托管代理(Managed Agents)现已默认采用 Gemini 3.6 Flash 模型,并新增环境钩子(hooks)功能,允许开发者在沙箱内拦截、审计或格式化工具调用。同时推出预算控制、定时触发器及免费层级访问,为 AI 代理开发提供更强生产级能力。

Gemini API 托管代理升级:默认 3.6 Flash 并支持环境钩子与预算控制
[广告位 · 上线后接 AdSense]

Gemini 3.6 Flash 成为默认模型

Google 最近给 Gemini API 托管代理来了波大升级。antigravity-preview-05-2026 代理现在默认搭载 Gemini 3.6 Flash 模型,开发者不用改代码就能直接开用。当然了,你也可以通过 agent_config.model 参数手动选模型,选项包括:

  • Gemini 3.6 Flash(默认):推理、编码、工具调用全能型选手
  • Gemini 3.5 Flash:上一代通用代理工作流模型
  • Gemini 3.5 Flash-Lite:专为低延迟和低成本设计

这种灵活的选模机制,让开发者能根据任务复杂度和预算随时调整,相当贴心。

环境钩子:沙箱内的工具调用拦截器

这次更新最炸裂的功能就是 环境钩子,它让开发者在代理执行工具调用前后都能运行自定义脚本。只要在环境里加个 .agents/hooks.json 配置文件,就能玩出各种花样:

安全审计示例:在 code_executionwrite_file 调用前跑个 gate.py 脚本。如果脚本返回 {"decision": "deny", "reason": "..."},工具调用就被拦下了,拒绝原因还会传给模型上下文。

代码格式化示例:所有工具调用后自动执行 auto_lint.py,代码风格立马规整。

钩子支持两种类型:

  • command 类型:在沙箱内执行本地脚本
  • http 类型:向外部端点发送 POST 请求

matcher 字段还支持正则表达式,用 | 匹配多个工具,或者用 * 捕获所有调用,灵活度拉满。

真实案例:金融场景的图像验证

AI 原生投资银行 OffDeal 就是个活生生的例子。他们的 AI 分析师 Archie 经常要在投资文档里插入一堆公司 logo(一份文档动不动就超 30 个),每个 logo 都得符合一堆严苛标准:正确公司、合适尺寸比例、透明背景、白底高对比度等等。

OffDeal 创始人兼 CTO Alston Lin 说:"以前没有钩子功能,我们的验证代码没法在远程沙箱里跑。现在有了 post_tool_execution 钩子,Archie 生成公司列表后,验证流程立马在沙箱内触发——抓取候选图像、执行像素级质量检查、用 Gemini 视觉模型验证每个 logo,最后发布一个只包含审核通过的文件的清单。"

成本控制与自动化能力

免费层级开放

托管代理现在对 免费层级项目敞开了大门,开发者可以用 API 密钥(不用激活计费)尽情实验代理工作流。

预算上限设置

托管代理执行多轮自主循环,复杂任务可能会烧掉不少 token。通过 agent_config 里的 max_total_tokens 参数,你可以设置总消耗上限(输入+输出+思考 token)。达到上限后,执行会安全暂停并返回 status: "incomplete",环境状态保留,你可以通过 previous_interaction_id 传递新预算继续执行。

定时触发器

托管代理还支持 scheduled triggers,帮你自动化周期性代理任务。触发器可以绑定代理、环境和定时规则(具体细节可以参考官方文档)。

技术集成说明

托管代理通过单次 API 调用就能协调推理、代码执行、包安装、文件管理和网络检索,所有操作都在隔离的云沙箱里完成。开发者可以用 TypeScript/JavaScript SDK(@google/genai)或者 Python SDK 进行集成。

如果你在用 AI 编码助手,可以通过下面这行命令快速添加 Gemini Interactions API 技能:

npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

本文基于 Google AI Blog 报道, 由 AiDuo123 AI 编辑翻译改写。原文链接: https://blog.google/innovation-and-ai/technology/developers-tools/expanding-managed-agents-gemini-api-3-6-flash-hooks/

常见问题

环境钩子与传统 API 回调有何本质区别?
环境钩子运行在 Google 托管的远程沙箱内部,而非客户端或外部服务器。这意味着验证逻辑可直接访问沙箱文件系统、执行环境和工具调用上下文,无需数据传输即可实施安全审计或质量控制,特别适合需要访问临时文件或执行环境状态的场景。
如何选择合适的 Gemini 模型版本?
根据原文描述:Gemini 3.6 Flash(默认)适合需要平衡推理与工具调用的复杂任务;3.5 Flash 适用于常规代理工作流;3.5 Flash-Lite 在成本与延迟敏感场景下最优。建议先用默认模型测试,若遇到成本或性能瓶颈再调整。
预算控制的 max_total_tokens 包含哪些部分?
该参数统计输入 token、输出 token 和思考 token(thinking tokens)的总和。达到上限后任务会暂停但保留环境状态,可通过传递 previous_interaction_id 和新预算继续执行,适合分阶段处理大型任务。
中国开发者使用该服务需注意什么?
原文未提及区域限制,但 Google Cloud 服务通常需稳定的国际网络访问。建议:(1)测试 API 端点连通性;(2)评估数据合规要求(沙箱在 Google 云端运行);(3)关注后续是否推出本地化部署选项。免费层级可用于前期验证可行性。
钩子脚本执行失败会如何处理?
原文提到钩子支持 timeout 参数(示例中设置 10-15 秒),并表示完整的失败处理语义需参考官方文档。通常此类系统会提供超时保护、错误日志记录和可选的失败策略(如跳过钩子继续执行或中止任务),具体行为建议查阅 Google 官方 hooks 文档确认。
[广告位 · 上线后接 AdSense]
标签:#谷歌

相关 AI 工具

文中提到或相关的 AI 工具 — 点进去看适合谁、怎么用、值不值得折腾

浏览全部工具 →

同类资讯 — 由发布时间排序

Windows 11 最新更新破坏 WSL 与 Claude Cowork 功能

Windows 11 最新更新破坏 WSL 与 Claude Cowork 功能

微软确认 Windows 11 九月安全更新 KB5124008 导致基于 Hyper-V 的 Linux 虚拟机中 Plan9 主机文件夹共享失效,直接影响 WSL 和 Claude Cowork 无法读取共享文件夹,应用可能显示"未挂载 Plan9 驱动器共享"错误。微软已将其列为已知问题并正在修复,但暂无补丁或临时解决方案。

行业动态微软
Anthropic工程师警告AI或致人类灭绝 为何仍加速开发

Anthropic工程师警告AI或致人类灭绝 为何仍加速开发

Anthropic研究员Jacob Coxon因担忧递归自我改进AI系统的风险而辞职,该公司安全主管随后表示确信AI可能导致人类灭绝概率超10%。尽管以安全为使命,Anthropic仍在推进自主智能体开发并筹备估值2万亿美元IPO,其"谨慎推进反而更危险"的逻辑引发争议。

行业动态Anthropic
Meta 因 AI 训练数据与人脸识别系统遭集体诉讼

Meta 因 AI 训练数据与人脸识别系统遭集体诉讼

美国伊利诺伊州和加州的多名用户向 Meta 提起集体诉讼,指控其未经同意使用 Facebook 和 Instagram 照片训练未发布的人脸识别系统 NameTag 及生成式 AI 模型 Emu 和 Muse Image,违反州生物识别隐私法。诉讼索赔金额可能达数十亿美元,这是 Meta 继 2020 年和 2024 年生物识别数据和解案后再次面临重大隐私诉讼。

政策与安全Meta
Anthropic 研究员离职警告超级智能风险,恰逢公司筹备 IPO

Anthropic 研究员离职警告超级智能风险,恰逢公司筹备 IPO

Anthropic 一名研究员本周辞职并公开警告,称公司正"直奔自我改进的超级智能,拿我们的生命冒险"。该公司对齐团队负责人甚至联署了这一声明。这一"末日警告"出现的时机敏感——据报道 Anthropic 正在筹备 IPO。TechCrunch 播客深入讨论了这一事件对 AI 安全和行业竞赛的影响。

行业动态Anthropic