Google 在 Gemini API 中提供的托管式 Agent 运行能力,单次 API 调用即可在隔离云端沙箱里协调推理、代码执行、包安装、文件管理与网页检索。2026 年 7 月 28 日升级默认模型为 Gemini 3.6 Flash,并加入环境钩子、Token 预算上限、定时触发器与免费层。 定价:价格暂未公开。编辑评分:⭐ 4.5。
Gemini API Managed Agents 是什么?
Gemini API Managed Agents 是 Google 在 Gemini API 中提供的托管式 Agent 运行能力,开发者通过一个 API 调用即可在隔离的云端沙箱里协调推理、代码执行、包安装、文件管理与网页检索。它脱胎于 2026 年 6 月 22 日 GA 的 Interactions API,并在 7 月 7 日加入后台任务与远程 MCP 集成,7 月 28 日又迎来一次重大升级(默认模型换为 Gemini 3.6 Flash、加入环境钩子、Token 预算上限、定时触发器与免费层)。它和 Google ADK 互补:ADK 偏代码优先的本地构建,Managed Agents 偏云端托管、免自建编排的生产部署。
核心功能
- 隔离沙箱执行:单次 API 调用在远程沙箱里跑代码、装包、读写文件、抓网页。
- 环境钩子(Hooks):在沙箱里 pre/post tool execution 时机运行自定义脚本,可拦截、阻断、lint 或审计工具调用。
- Token 预算上限:用 max_total_tokens 限制输入+输出+思考总消耗,超限返回 incomplete 并保留环境状态以便续跑。
- 定时触发器(Cron):把 agent、环境、prompt、cron 表达式绑定为持久资源,每次复用同一沙箱、文件可跨次保留。
- 免费层与多模型:免费层项目可用 API Key 直接试;默认 Gemini 3.6 Flash,也可选 3.5 Flash / 3.5 Flash-Lite。
版本/套餐对比
| 维度 | 免费层 | 付费/绑定计费项目 |
|---|---|---|
| 访问 | API Key 即可,无需活跃计费 | 标准 Gemini API 计费 |
| 模型 | Gemini 3.6 Flash 默认 | 同左,可指定其他模型 |
| 限额 | 约 10 请求/分、1500/天 | 按用量计费 |
(模型单价参考:3.6 Flash 输入 $1.50/百万 token、输出 $7.50/百万 token;Agent 平台本身无独立公开定价。)
值不值得用?
优点:把 Agent 治理(钩子、预算、定时)做成平台能力,省去自建编排层;免费层降低了试水门槛;默认模型效率更高、单价更低。缺点:生态相对 Google 系绑定;SDK 目前没有 hookable fetch;仍需要团队自己定义权限与审查流程。结论:在 Vertex/Gemini 生态里做生产级 Agent,这是目前最省心的落地方式。
使用建议
先用免费层起一个沙箱 Agent、挂上 hooks.json 体验合规闸门。生产环境务必设置 max_total_tokens 防止失控循环,用 cron 触发器替代外部调度器做周期任务。
适合谁用?
- 推荐:Google Cloud / Gemini 生态开发者、需要可治理生产 Agent 的团队。
- 可考虑:想用托管 Agent 跑定时任务、文件处理的个人开发者。
- 不推荐:强依赖 OpenAI/Anthropic 体系、希望完全自托管编排的团队。