Googleは2026年9月17日、Gemini APIの管理型エージェント antigravity-preview-09-2026 を公開しました。旧 antigravity-preview-05-2026 は10月5日に停止予定です。モデル名を置き換えるだけで済む実装と、ツール契約の変更が必要な実装を最初に分けることが移行の近道です。
① 旧 `05-2026` は2026年10月5日に停止予定です。
② リモート環境で `output_text` だけを読む実装は、エージェント名変更が中心です。
③ ローカルツールやstep解析は、ツール名・PascalCase引数・行範囲編集へ対応します。
Googleのリリースノートでは、environment: "remote" で output_text または model_output stepだけを読む場合、エージェント文字列以外は変わらないと説明しています。一方、local_environment で組み込みツールを自前実行する場合や、function_call stepを直接解析する場合は互換性の確認が必要です。
| 機能 | 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) | PascalCase引数へ |
| 検索 | 専用ツールなし | find_by_name / grep_search | shell依存を減らせる |
| shell | code_execution | 変更なし | 既存の制限を維持 |
| Web検索 | google_search | 変更なし | 検索結果の検証は継続 |
特にファイル編集は「全ファイル再生成」から「行範囲置換」へ変わります。競合を減らせる一方、行番号が古い、対象内容が変わった、改行コードが異なるといった失敗を正しく扱う必要があります。
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-09-2026",
input="リポジトリを分析し、テスト結果を要約してください。",
environment="remote",
)
print(interaction.output_text)管理型Antigravity AgentはPublic Previewです。09-2026は標準でGemini 3.8 Flashを使い、リモートLinuxサンドボックスでコード実行、ファイル操作、Web閲覧を行います。基盤モデルは agent_config で変更できますが、移行とモデル変更を同時に行うと差分原因が分かりにくくなるため、別段階にします。
| ケース | 期待する動作 | 危険な実装 |
|---|---|---|
| 対象行が変化済み | 競合として停止し、再読取 | 別の行を黙って上書き |
| 同じ要求を再送 | 二重変更しない | 同じコードを重複挿入 |
| 範囲外パス | allowlistで拒否 | 絶対パスを無条件許可 |
| テスト失敗 | 変更を未承認として保持 | 失敗してもPR作成・公開 |
| 途中で予算到達 | incompleteを記録し、明示的に継続 | 完了として後続処理 |
incomplete 率公式ガイドでは複雑なAgent処理が数百万トークンへ達する可能性を示し、max_total_tokens で上限を設定できます。上限到達時は status: "incomplete" となり、環境と文脈を引き継いで次のinteractionで継続できます。途中状態を成功として扱わないことが重要です。
Preview版を無人の本番更新へ直結しないでください。
サンドボックスは隔離を助けますが、外部API、MCP、認証情報、リポジトリへの書込み権限を渡せば副作用は外へ出ます。出力と操作を人または決定論的ルールで検証します。
管理型Agentは、Agent loop、Linux環境、ファイル・Web・コード実行を一つのAPIで提供します。その便利さと引き換えに、アプリは自然言語の出力だけでなく「ツール契約」と「副作用」に依存します。モデル名とツールschemaを直接業務ロジックへ散らさず、adapter、契約テスト、権限allowlist、実行予算を標準部品にすることが、次回のPreview更新を軽くします。
10月5日の旧版停止、Public PreviewからGAへの条件、ツールschemaの安定化、サンドボックス計算資源の課金開始、保存済みAgentとtriggerの移行方法を確認します。移行完了条件は「新名称で動く」ではなく、旧名ゼロ、破壊的操作の承認、予算上限、失敗アラート、ロールバックが揃うことです。
最終確認日：2026年9月21日