Google 更新 Gemini API 托管 agent：antigravity-preview-09-2026 harness 上线，Files API 与 Credentials API 同日可用

2026 年 9 月 17 日，Google AI Studio 宣布 Gemini API 的托管智能体产品 Managed Agents 完成一轮更新：agent harness（代理运行框架）升级为 antigravity-preview-09-2026，把 agent 的工具与行为向 Antigravity Coding Agent 靠拢，当天即在 Interactions API 与 AI Studio 可用，运行于 Gemini 3.8 Flash，模型可按每次 interaction（一次交互调用）配置。这则更新也发布在上，完整细节以形式发在下。

与 harness 一起推出的还有两个新 API：Files API 负责把数据送进 agent 环境再把结果取出来；Credentials API 让 agent 能以受控方式使用用户已有的服务，从 MCP（Model Context Protocol，模型上下文协议）服务器到第三方 API。按公告的说法，单次 API 调用即可得到一个在 Gemini API 托管的隔离 Linux 沙箱中推理、执行代码、管理文件并浏览网页的 Gemini agent，沙箱跨轮次持久；旧版 harness antigravity-preview-05-2026 将于 2026 年 10 月 5 日弃用。

一次调用，一个跨轮次持久的 Linux 沙箱

按公告的描述，开发者发一个 prompt（提示词），agent 会规划、执行、观察结果并循环，直到任务完成。agent 配备的工具包括：

code_execution：在沙箱里运行 bash，Python、Node、git 以及终端里能做的事一条命令可达；
文件系统工具：通过 environment 启用，可读取、写入、编辑、搜索和列出文件；
google_search 与 url_context：负责联网检索与读取网页；
约 135,000 token（词元）处的自动上下文压缩，让长会话得以继续；
自定义函数工具与远程 mcp_server 工具，用于接入开发者自己的系统。

公告给出的示例任务是：克隆 pallets/click 仓库，找出所有仍在使用已弃用 autocompletion 参数的位置，迁移到 shell_complete，运行测试套件，并写一段 CHANGELOG。官方对这套机制还有一处说明：Interactions API 把对话上下文（用 previous_interaction_id 续接）与环境状态（文件、已安装的包、沙箱状态，用 environment 指定）当作两个独立维度跟踪，二者可以单独替换——清掉对话但保留文件，或保留对话但换一个新沙箱，都是合法用法。

Managed Agents 此前已经存在。2026 年 5 月 19 日，Google ，当时的 harness 是 antigravity-preview-05-2026，底层模型为 Gemini 3.5 Flash；再往前，2025 年 12 月，Google 把 Deep Research 接入 Gemini API，称之为平台上的第一个托管 agent。本次更新，就是把 5 月那套 harness 换成了 09-2026 版。

模型按次可换，配置能存成托管 agent

harness 的行为通过 agent_config 配置：model 更换底层 Gemini 模型，max_total_tokens 限制一次运行最多消耗多少 token，tools 决定 agent 能用什么。这些配置既可以随每次 interaction 内联传入，也可以用 agents.create() 存成一个托管 agent，之后按 id 调用。

公告举的例子是一个「便宜的研究 agent」：底层模型换成 gemini-3.5-flash-lite，max_total_tokens 设为 500,000，工具只留 google_search 和 url_context，任务是找出近 12 个月被引最多的 5 篇 speculative decoding（推测解码）论文，并给出标题、发表场合、一句话论断和链接。

Google 主账号同日在 X 上发布的补充称，新 harness 「原生运行在 Gemini 3.8 Flash 上——这是我们目前最强的推理与编码模型」，并且「可以随时更换模型选择」。「最强」是 Google 的自评。

官方口径的改进数字：缓存与文件编辑

公告列出的三组改进数字均由 Google 自报：

长对话的缓存命中率：多轮编码与研究任务提升 7%，长问答运行提升 16%；
按内部评测口径，文件编辑的输出 token 减少 40%；
同样按内部评测，多轮软件工程与研究任务的完成率最多提升约 8%。

兼容性方面，公告称在 antigravity-preview-05-2026 上能跑的请求无需改动即可在新 harness 上运行。需要留意的是 step 事件（agent 每一步执行产生的事件）里的工具名变了：文件工具现在上报为 view_file、write_to_file 和 replace_file_content，凡按工具名过滤事件的代码都要相应更新。公告没有为这些数字附上第三方验证结果。

Files API：第一次调用返回 environment_id

Files API 解决的是文件进出 agent 环境的问题。公告的描述是：agent 会创建文件、处理文件——你递给它的一个 CSV、它写的一份报告、它克隆的一个仓库。第一次 interaction 创建沙箱并返回 environment_id；此后可以列出环境里有什么、向其中上传、下载单个文件或整个目录。

公告的示例分三步：先把 q3_sales.csv 放进环境，让 agent 在 /workspace/output/dashboard.html 生成一个内联全部 CSS 和 JS、不发起外部请求的单文件 HTML 仪表盘，内容包含分地区营收、前 10 名产品和月度环比趋势；再用 files.list() 列出生成的文件及大小；最后用 files.download() 把 dashboard.html 单独取回本地。

环境是持久的，下一轮 interaction 可以接着用：用 files.upload() 上传 q4_sales.csv，带上 previous_interaction_id 继续对话，让 agent 在仪表盘里加一节 Q3 与 Q4 的对比。

Credentials API：沙箱里只放占位符

Credentials API 把 Gemini API 最初的 secrets（机密凭证）支持扩展成完整 API。按公告的说法，开发者用 credentials.create() 注册一次凭证，Google 加密存储，并且只在你定义的目的地把凭证送上线路，从而避免每次请求都带明文 token。

支持三类凭证：bearer_token，用于接受 Authorization header 的 MCP 服务器和 API，header 名称与前缀均可配置；environment_variable，供 agent 在沙箱里用 curl、requests 或 SDK（软件开发工具包）调用的服务，作用范围受 trusted_domains 约束；oauth2，面向会发放 refresh token 的提供商，Google 会在 access token 过期前刷新，若提供商发来轮换后的 refresh token 也一并保存。

凭证可以放在三个位置：挂到一个远程 mcp_server 工具上，Gemini API 调用该服务器时自动加上 Authorization header；绑定到沙箱里的环境变量，容器拿到的只是占位符，egress（出站）代理在流量离开沙箱时替换为真实值；或者为特定域名创建出站 header 改写规则。

公告强调的安全性质是：凭证不存在于环境中——不在内存里、不在 stdout 里、也不在模型的上下文里。如果 agent 被诱导把 $SLACK_BOT_TOKEN 发往 trusted_domains 之外的主机，代理看到的会是未被替换的占位符，请求直接返回 403。示例里，GitHub 走远程 MCP 服务器（api.githubcopilot.com/mcp），由 API 注入 bearer token；Slack 则用环境变量凭证，配合 slack.com 及其子域名的 allowlist（域名允许列表）。

定价不变，旧 harness 的请求将被重定向

迁移安排集中在公告结尾：现在就可以通过 Python SDK、JavaScript SDK 或 REST 换到 antigravity-preview-09-2026，定价不变。

到 10 月 5 日，antigravity-preview-05-2026 弃用生效，此后发往它的请求会被重定向到更新后的 harness，调用地址无需更改，Google 表示会在 changelog 里跟踪这一日期。从 9 月 17 日公告发布到弃用生效，调用方有不到三周的迁移窗口。