Gemini API Managed Agents 支持自托管环境：Agent 的 shell 和文件工具可跑在你自己的沙箱里，只需出站 HTTPS，官方给出 Cloud Run、Cloudflare、Daytona、E2B、Modal、Vercel 等 8 种接入示例

核心背景与行业痛点

Google 在 9 月推出 Gemini API Managed Agents：一次调用 Antigravity Agent，就会配一台 Google 托管的临时 Linux 沙箱，让 Agent 在里面写代码、跑命令。问题是很多企业的代码、私有包和数据不能离开自己的网络，也想自己控制出网策略，托管沙箱就成了落地门槛。Anthropic、Mistral 等厂商也都在做托管 Agent，“执行层放在哪里”正是各家竞争的焦点。

架构亮点与底层机制

自托管环境把执行层拆了出来：Google 继续负责 Agent 循环、模型调用和交互流；你的 worker 通过 leaseInteractions 接口主动拉取任务，在 --root-dir 内执行工具，再把结果和心跳交回。文件类工具被限制在根目录内，阻止 .. 和符号链接越界。生产推荐 poll + serve 模式：控制面持有密钥，每次交互新起一个只拿到短期 lease token 的沙箱，结束即销毁。

权威 Benchmark 与实测跑分对比

这是基础设施能力，官方未公布性能或成本跑分。按 Daytona 的说法，每次交互新起沙箱会多出几秒启动时间；长驻 worker 则没有这段等待，文件还能跨交互保留。

开发者实战落地与开箱指南

安装开源 gemini-api CLI（Go，Apache 2.0），用 API key 调 POST /v1beta/environments 创建 self_hosted 环境，并立刻保存 environment_key。在沙箱里运行 gemini-api environments connect --environment-key ... --root-dir /workspace，然后在 interactions.create 里传入环境 id。官方警告：local 模式会在本机直接执行 bash，只适合临时测试；正式使用要放进容器或 VM，以非 root 运行，并屏蔽云元数据地址。