Google发布Gemini API 3.6 Flash托管代理，加入环境钩子与免费层功能

功能细节与使用示例

1. 默认模型切换至 Gemini 3.6 Flash

import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "审计 package.json 并升级过期依赖。",
  environment: "remote",
});
console.log(interaction.output_text);

上述代码在不改动任何参数的情况下，已自动使用 Gemini 3.6 Flash 完成任务。

2. 环境钩子配置示例

{
  "security-gate": {
    "pre_tool_execution": [{
      "matcher": "code_execution|write_file",
      "hooks": [{
        "type": "command",
        "command": "python3 /.agents/hooks-scripts/gate.py",
        "timeout": 10
      }]
    }]
  },
  "auto-format": {
    "post_tool_execution": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "python3 /.agents/hooks-scripts/auto_lint.py",
        "timeout": 15
      }]
    }]
  }
}

security-gate 在每次代码执行或写文件前运行 gate.py，返回 {\"decision\": \"deny\"} 时会阻止该调用。
auto-format 在工具完成后统一执行代码格式化脚本。

3. 预算上限防止跑单

await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "生成完整的迁移报告。",
  agent_config: { type: "antigravity", max_total_tokens: 10000 },
  environment: "remote"
});

当累计 token 超过 10 000 时，交互会返回 incomplete，并保留当前沙箱状态，可在后续继续。

4. 定时触发示例

# 创建每日 02:00 自动审计任务
POST https://generativelanguage.googleapis.com/v1/projects/PROJECT_ID/agents:createTrigger
{
  "agent": "antigravity-preview-05-2026",
  "environment": "remote",
  "prompt": "审计所有 Python 依赖并生成安全报告。",
  "cron": "0 2 * * *"
}

此触发器会在每日日凌晨 2 点自动启动，同一沙箱会保留上一次的文件系统。

业界案例

OffDeal（AI 原生投行）利用 post_tool_execution 钩子，在生成投资报告时自动调用 Gemini 视觉模型校验公司 logo 的尺寸、透明度与对比度，确保每张图片符合品牌规范。该流水线在沙箱内部完成，避免了外部网络泄漏风险。

对开发者的意义

成本可控：免费层和预算上限让小型团队或个人开发者能够在零成本实验的同时防止意外费用。
安全合规：环境钩子提供了在工具调用前的安全审计能力，满足企业内部代码审计与合规要求。
自动化升级：定时触发结合持久化沙箱，使得日常运维、报告生成等重复性工作可以全程交给 AI 代理完成。

快速上手指南

通过 npm install @google/genai 安装 SDK。
在 Google Cloud 控制台创建 API Key（免费层即可）。
参考官方 Managed Agents Quickstart，配置 .agents/hooks.json 与 agent_config。
使用 Environments API 管理沙箱生命周期，防止资源泄漏。

随着 Gemini API 功能的持续迭代，托管代理正从实验性工具向企业级自动化平台演进，开发者可以在保持成本与安全的前提下，构建更复杂的自研工作流。

Google发布Gemini API 3.6 Flash托管代理，加入环境钩子与免费层功能