新裝載器、新工具:Google antigravity-preview-09-2026 改寫託管代理操作檔案的方式
Google 九月的代理版本取代了五月的裝載器:改用行範圍編輯取代整檔重寫、工具參數改為 PascalCase、並新增原生檔案搜尋——舊執行環境將於 10 月 5 日關閉。
2026 年 9 月 17 日,Google 低調地重塑了其 AI 技術堆疊中最關鍵的開發者介面之一:驅動 Gemini API「Interactions API」與 Antigravity 平台的託管代理執行環境。新的代理裝載器 antigravity-preview-09-2026 取代並棄用了五月的 antigravity-preview-05-2026——而且這不是例行的版本號更新,它改變了代理與程式碼實際互動的方式:檔案編輯不再重寫整個檔案、工具參數從 snake_case 改為 PascalCase、代理也首度擁有自己的原生檔案搜尋工具,不必再透過 shell 指令呼叫 grep 與 find。
如果你以建造代理為業,這種發表在 changelog 裡看似不起眼、在生產環境中卻影響深遠的更新,正是值得密切關注的類型。
什麼是託管代理
先說背景。Google 今年稍早在 Gemini API 推出託管代理時,訴求是徹底的簡單:只要一個 API 呼叫,Gemini 就獲得一個專屬的遠端 Linux 沙盒——一台真正存在於雲端、由代理在任務期間獨佔的電腦。模型負責規劃、推理、執行程式碼、管理檔案,不斷循環直到工作完成,開發者完全不需要編排任何基礎設施。中間的「裝載器」(harness)則是兩者之間的那一層:它定義模型可以呼叫哪些工具、這些工具如何參數化、結果如何流回。
裝載器的重要性遠超過多數人的想像。模型能力決定了基準測試分數,但裝載器決定了模型實際上「能做什麼」。而且由於 Google 讓消費端 Antigravity IDE 與對外開放的 API 使用同一套裝載器,裝載器升級會一次擴散到所有地方——從 AI Studio 裡的業餘專案到企業級管線。
9 月 17 日改了什麼
這次版本說明罕見地精準指出誰需要留意,並把使用者分成兩類:
如果你在遠端沙盒上執行(environment: "remote")且只讀取 output_text 或 model_output 步驟:只需更新代理字串,其他什麼都不用改,升級對你來說幾乎無感。
如果你在本機執行工具(local_environment)或解析 function_call 步驟:內建工具已經改變,你的解析程式碼一定會察覺。
具體差異如下:
| 功能 | 05-2026 | 09-2026 |
|---|---|---|
| 建立檔案 | write_file(path, content) | write_to_file(TargetFile, CodeContent, Overwrite, Description) |
| 編輯檔案 | 以 write_file 整檔重寫 | replace_file_content(TargetFile, StartLine, EndLine, TargetContent, ReplacementContent) |
| 讀取檔案 | read_file(path, offset, limit),位元組偏移 | view_file(AbsolutePath, StartLine, EndLine, ContentOffset) |
| 列出目錄 | list_files(path) | list_dir(DirectoryPath) |
| 檔案與程式碼搜尋 | 無,代理須透過 shell 指令 | find_by_name(SearchDirectory, Pattern, MaxDepth) 與 grep_search(SearchPath, Query, IsRegex) |
| Shell 執行 | code_execution(command, timeout_seconds) | 不變 |
| 網頁搜尋 | google_search(queries) | 不變 |
其中兩項轉變特別值得注意。
行範圍編輯是頭條。 在舊裝載器下,代理若要修改 500 行檔案裡的某一行,就必須重寫整個檔案——這種昂貴又容易出錯的模式,任何看過 LLM 用「重新生成整個模組」來修函式、結果悄悄弄壞別處 import 的人都熟悉。新的 replace_file_content 接受起始行、結束行、目標內容與替換內容。這正是成熟工程工具的運作方式:外科手術式的差異修改,而非全盤重新生成。它在編輯密集的任務上降低 token 消耗,更重要的是讓代理的編輯變得可稽核——你可以清楚看到代理究竟動了哪幾行。
原生搜尋工具補上了長久以來的缺口。 過去代理要找一個符號,必須降級到 shell 層執行 grep 或 find 原始指令,解析自由文字輸出,還得祈禱指令不會因引號或權限問題失敗。新的 grep_search(SearchPath, Query, IsRegex) 與 find_by_name(SearchDirectory, Pattern, MaxDepth) 讓檔案系統搜尋成為第一類的結構化工具呼叫。結構化工具意味著結構化的錯誤處理、重試機制,以及——對評估代理框架的人至關重要的——可比較的基準測試。
PascalCase 的參數命名(TargetFile、CodeContent、StartLine)也不只是妝點門面。讓 API 的工具結構描述與 Antigravity IDE 內部的慣例對齊,等於把 Google 自家產品團隊的內部測試與外部開發者使用的介面綁得更緊。當內外部裝載器共用同一套詞彙,某一端的改進就能不經轉譯地落到另一端。
裝載器之下的引擎
九月版裝載器預設原生執行於 Gemini 3.8 Flash——Google 最強的 Flash 級模型,自 9 月 2 日起正式供應,用該公司的話說,是為「長時程軟體工程、自主代理與複雜企業工作流程」而設計。開發者也可以另行設定預設模型。這個搭配有其深意:一個為長時間多步驟工程工作調校的模型,最能受惠於為持續性檔案手術(而非一次性生成)設計的工具。
還有持久性的角度。Google 自家的開發者倡導者描述這個升級後的執行環境提供持久的 Linux 沙盒——代理的環境可以跨步驟存續,而不必每次重建,因此狀態、已安裝的相依套件與中間產物都能在任務生命週期內延續。
期限:10 月 5 日
這次轉移不是可選的。antigravity-preview-05-2026 將於 2026 年 10 月 5 日關閉(已在官方棄用頁面追蹤),只留下十八天的窗口,讓所有解析 function_call 步驟或在本機執行工具的人完成遷移。只消費最終輸出的團隊改個代理字串就能繼續;但擁有自製工具呼叫解析器、日誌管線、或圍繞 snake_case 參數與整檔寫入建立的評估系統的團隊,則有真正的遷移工程要做:每一個以舊結構描述為鍵的解析器、mock 與測試檔都得重新檢視。
這是整個產業仍在學習的一課:在代理時代,棄用週期不只適用於模型,也適用於圍繞模型的工具契約。你的程式碼也許不會直接呼叫 write_file——但如果你解析代理發出的呼叫,結構描述的改變同樣是一次 API 破壞性變更。
為什麼重要
代理裝載器這一層,正在成為 Agentic AI 真正的決戰場。OpenAI 的 Codex、Anthropic 的 Claude Code、Google 的 Antigravity 之間的競爭,越來越不在模型基準分數本身,而在那個讓模型得以在真實程式庫上行動的執行環境品質:它怎麼讀、怎麼改、怎麼搜、怎麼從錯誤中復原。Google 九月的版本就像是對這場競爭的直接回應——把專業開發者工具早已驗證的慣例(差異式編輯、結構化搜尋、明確參數)借過來,推進每一個建立在 Gemini API 上的託管代理的預設體驗。
對開發者來說,結論很直接:如果你解析過 function_call 或在本機執行工具,請在 10 月 5 日前排定遷移;如果你還沒認真看過託管代理,這次的賣點更強了——一個 API 呼叫就能得到持久的 Linux 沙盒、一個為程式碼調校的前沿模型,以及一套終於能流利說出 IDE 語言的工具詞彙。
代理基礎設施裡那些不光鮮的部分——檔案編輯慣例、搜尋原語、參數結構描述——才是代理可靠性真正定輸贏的地方。Google 九月的裝載器升級,正說明了它心裡有數。