Gemini API Antigravity Agent移行ガイド：05-2026停止前に確認する変更点
Gemini APIのAntigravity Agent 05-2026は2026年10月5日に停止予定です。09-2026へagent IDを替えるだけで済む条件と、function_call・local_environmentを使う場合のtool名・引数・ファイル編集方式の変更を整理します。
公開 2026.09.26 / 更新 2026.09.26
この記事のポイント
- 停止予定日は2026年10月5日。現行Docsが案内する後継はantigravity-preview-09-2026
- remote sandboxでoutput_textまたはmodel_outputだけを読むなら、agent ID以外の変更は不要
- function_callやlocal_environmentを使う場合は、PascalCase引数とファイル操作toolの差分を反映する
- プレビュー環境として、network、credential、出力確認、token budgetも移行時に見直す
先に結論：停止日までにagent IDとtool利用形態を確認する
Gemini APIのAntigravity Agentでは、旧版antigravity-preview-05-2026が2026年10月5日に停止予定です。Googleの2026年9月17日の更新は、後継をantigravity-preview-09-2026として案内しています。2026年9月26日時点で残りは9日です。最初にコード、設定、保存済みagentのbase_agentを検索し、どの実行形態で使っているかを分けてください。
使い方によって必要な移行範囲が違う
| いまの使い方 | 09-2026で必要な対応 | 見落としやすい点 |
|---|---|---|
| environmentがremoteで、output_textだけを読む | agentをantigravity-preview-09-2026へ変更 | 保存済みagentのbase_agentも確認する |
| remoteだがinteraction.stepsのfunction_callも読む | agent IDに加えtool名・引数・parserを更新 | 引数名のcaseと編集toolの意味が変わる |
| local_environmentでtoolを実行する | ID、tool呼び出し、結果parserを更新 | 旧tool名を前提にした実装・fixtureが残っていないか調べる |
| model_outputだけを読む | Googleの案内上、agent ID以外の変更は不要 | model_output以外のstepを同じ処理で読んでいないか確認する |
切り分けの境界は、出力全体を読むかtool実行のstepまで解釈するかです。remote sandboxで最終出力だけをアプリへ渡している構成は小さな変更で移れます。一方、function_callを独自handlerへ流す実装やlocal_environmentは、tool契約がアプリの一部なので、名前だけ置換して完了にしないでください。
function_callを処理するならtool契約を更新する
GoogleのRelease notesでは、09-2026のbuilt-in toolsは引数がsnake_caseからPascalCaseへ変わり、file編集は全体を書き換える方式から行範囲の置換へ変わったと説明されています。function_callを保存・振り分け・再実行するコードは、次の対応を基準に見直します。
| 操作 | 05-2026 | 09-2026 |
|---|---|---|
| file作成 | write_file(path, content) | write_to_file(TargetFile, CodeContent, Overwrite, Description) |
| file編集 | write_file(path, content)で全体を書き換え | replace_file_content(TargetFile, StartLine, EndLine, TargetContent, ReplacementContent) |
| file読取 | read_file(path, offset, limit)でbyte offsetを使う | view_file(AbsolutePath, StartLine, EndLine, ContentOffset) |
| directory一覧 | list_files(path) | list_dir(DirectoryPath) |
| 名前・code検索 | built-in検索toolなし | find_by_name(SearchDirectory, Pattern, MaxDepth) / grep_search(SearchPath, Query, IsRegex) |
| shell実行 | code_execution(command, timeout_seconds) | 変更なし |
| web検索 | google_search(queries) | 変更なし |
tool名だけでなく、引数オブジェクトのfield名、read offsetの意味、編集範囲の扱いまで確認します。たとえば旧版のwrite_fileによる全体置換を、新版のreplace_file_contentへ名前だけ変えると、対象行と置換内容を渡す契約を満たせません。呼び出し側の型、function_callを受けるhandler、ログ表示、保存済みfixtureを一緒に更新します。
漏れを作らない移行手順
- repository、環境設定、example、CI設定、保存済みagent定義から05-2026のagent IDとbase_agentを検索する
- output_text・model_outputだけを読むのか、interaction.steps/function_callも扱うのかを呼び出し箇所ごとに分類する
- function_callを使う箇所は新しいtool名・PascalCase引数・file編集の範囲指定に合わせ、独自parserとhandlerを更新する
- 使い捨てのsandboxで、最終出力、tool呼び出し、失敗時のstatus、継続処理を確認する
- tool結果と変更fileを人がレビューしてから、本番のtaskや外部連携へ戻す
プレビュー中のnetwork・credential・費用を再確認する
09-2026もmanaged agentsの公開プレビューです。Googleはsandboxが既定で外向きnetworkへ接続でき、allowlistで接続先を制限または無効化できると説明しています。agentから利用できるcredentialはその権限全体を使われる前提で選び、短命かつ最小権限のものにします。生成fileや外部serviceの更新は、結果を確認してから人が適用してください。
料金はGemini model tokenとtool利用に基づく従量制です。長いagent loopでは一つのrequestでも複数回の推論とtool実行が起きます。max_total_tokensはtoken budgetを制限する設定ですが、Googleはbest-effortと説明しているため、上限だけを予算管理の代わりにせず、interactionごとのusageとtool利用を確認してください。
Antigravity Agent移行のFAQ
antigravity-preview-05-2026はいつ停止しますか？
Googleのdeprecationsページでは、2026年10月5日が停止予定日として掲載され、後継はantigravity-preview-09-2026です。移行直前に同ページで日付を再確認してください。
output_textしか使わない場合もtoolを直す必要がありますか？
environmentがremoteで、output_textまたはmodel_outputだけを読む構成なら、GoogleのRelease notesはagent ID以外の変更は不要と案内しています。function_callや別のstepを解析していないか、実際の呼び出し経路を確認してください。
05-2026から09-2026へ変えると公開ベータは終わりますか？
終わりません。GoogleのAgents overviewはmanaged agentsをPublic Previewとして案内しています。新しいagent IDへ移行した後も、schema・tool・提供条件が変わる可能性を前提にします。
file編集は以前と同じ全体書き換えですか？
09-2026ではreplace_file_contentが行範囲を指定して置換する方式です。対象file、開始・終了行、置換対象、置換後の内容を受け取るhandlerへ更新します。
関連記事
- Codexのフルアクセスは危険？許可していい作業・止めるべき作業
Codexのフルアクセスは、何でも任せてよい設定ではありません。許可してよい作業、止めるべき作業、.envやAPIキーの扱いを先に分けておくための安全ガイドです。