Antigravity 舊版 API 10/5 列定停用：誰要改、怎麼試新版？附官方入口與遷移對照

排程每天都在跑，卻可能因為一個舊版 agent 名稱突然失敗。如果你用 Gemini API 的 Antigravity Agent 自動整理網頁、執行程式或處理檔案，現在值得搜尋一下設定裡有沒有 antigravity-preview-05-2026。Google 已把它的停用日列為 2026 年 10 月 5 日，替代版本是 antigravity-preview-09-2026。

這是既有停用計畫到達列定日期的提醒：替代版本已於 9 月 17 日發布。本文依台灣時間 10 月 5 日查核的官方文件整理，沒有實測舊端點是否已停止回應。停用時程頁也註明，表列日期為最早可能停用日，確切日期會另行通知使用者；官方未在這些頁面提供切換時刻。

先判斷：這次跟你的工作有關嗎？

有在程式或排程中指定 antigravity-preview-05-2026：需要檢查遷移。
只使用 Antigravity IDE，沒有呼叫這個 Gemini API Agent：這則公告的對象是 API 識別名稱，不能據此認定整個 IDE 停用。
還沒用過：可先看官方快速開始，了解代管 Agent 如何把搜尋、程式執行與檔案工作串成一個任務。

它能做什麼？把一個指令接成多步驟工作

Antigravity Agent 透過 Interactions API 與 Google AI Studio 提供服務，可在 Google 代管的 Linux 沙盒中執行程式、管理檔案與搜尋網頁。例如官方入門案例會要求 Agent 寫程式產生前 20 個費氏數列數字、存成檔案，再讀回結果。這讓初次測試有一個容易核對的目標，不必一開始就接正式工作資料。

先試新版：官方入口與三個必要欄位

文章上方的「直接試用」連到 Google AI Studio；登入後的可用功能與額度，以你的帳號及專案為準。要用程式測試，點「Antigravity Agent 快速開始」。官方範例的重點是三個欄位：agent 指定新版、environment 使用 remote 建立沙盒，input 寫清楚要完成的任務。

Google 官方快速開始文件截圖：首個請求的三個欄位是 agent、environment 和 input；新版名稱為 antigravity-preview-09-2026。此為文件畫面，非執行成功的實測紀錄。來源：Google AI for Developers，Managed agents quickstart（CC BY 4.0；裁切，未改內容）。

只讀雲端最終輸出：先更新 agent 名稱

Google 更新紀錄指出，若使用 environment: "remote"，而且程式只讀 output_text 或 model_output 步驟，遷移時更新 agent 字串即可。把 antigravity-preview-05-2026 換成 antigravity-preview-09-2026 後，仍建議先跑一個小任務，確認自己的輸出處理與後續流程正常。

自行執行工具或解析回傳：工具介面也要一起改

若流程使用 local_environment，或會讀取 function_call 步驟，就要同步檢查內建工具介面。官方這次調整了工具名稱、參數大小寫與檔案編輯方式；沿用舊版處理邏輯，可能無法正確接住新版要求。主要差異如下：

Google 2026 年 9 月 17 日更新紀錄中的工具遷移對照表，節錄建立、修改、讀取檔案與列目錄四項。注意新版工具名稱、PascalCase 參數及按行範圍修改的差異。來源：Google AI for Developers，Release notes（CC BY 4.0；裁切，未改內容）。

建立檔案由 write_file 改為 write_to_file，需對照 TargetFile、CodeContent、Overwrite、Description 等參數。
修改檔案改用 replace_file_content；處理邏輯要能接住行範圍替換，不能一律把內容當成整份檔案覆寫。
讀取檔案由 read_file 改為 view_file；列目錄由 list_files 改為 list_dir。新增 find_by_name 與 grep_search 可供搜尋。
官方列出的 code_execution 與 google_search 介面維持不變。

改完名稱，怎麼知道真的接通？

建議用一個可回復的小測試驗收：在測試沙盒建立文字檔、改動其中一行、讀回內容，再檢查最後輸出。若你的程式會解析 function_call，也要確認工具名稱、參數大小寫及回傳內容都能被接住。這是遷移檢查建議，本文沒有替讀者執行 API，也沒有驗證舊端點當下是否已停用。

免費層能用，仍要控制整段任務的用量

新版仍屬預覽服務，免費與付費 Gemini API 專案都可使用，免費層有用量與速率限制。預設底層模型是 Gemini 3.8 Flash，也能透過 agent_config 選擇模型。費用依模型 token 與工具使用量計算；預覽期間，沙盒運算資源暫不收費。這不代表整個 Agent 任務都免費。

一次請求可能反覆推理與呼叫工具，不能直接當成一則聊天的成本。可以在 agent_config 設定 max_total_tokens 控制單次互動的 token 用量，但這是盡力遵守的上限，實際用量可能略超出，且不計入快取 token；它也不是美元金額的硬上限。

開始接正式工作前的限制

Antigravity Agent 仍屬預覽服務，功能與資料結構可能改變。
目前支援文字與圖片輸入，不支援把音訊、影片或文件直接當作這類輸入。
不支援 structured outputs；file_search、computer_use 與 google_maps 也尚未支援。
max_output_tokens 等部分生成參數會回傳 400 錯誤；Agent 的用量控制需依文件使用 max_total_tokens。

這次最實際的第一步，是找出程式裡的舊 agent ID，再依「只讀雲端輸出」或「自行處理工具」選擇檢查範圍。先讓一個小任務完整跑通，再切換既有排程，會比直接改完字串就放著跑更容易發現問題。