2026年11月11日時点で、Google Antigravity のスウォームモード(/swarm コマンド)はプレビュー機能であり、1つのプロンプトを Google の Gemini 4 Carbon が率いる協調エージェントチームに変換します。Gemini 4 Carbon は2026年11月10日に一般提供が開始され、/swarm では Carbon が計画・調整・監査を担当し、より高速で軽量なモデルが並列の分離ワークスペースで作業し、敵対的な検証エージェントがすべての変更をテストします。
以下では、チームの編成方法、Google がこの機能で何を構築したか、誰が利用できるか、まだ不明な点、そして Apidog CLI でテストするための API コントラクトをスウォームエージェントに与える方法を解説します。
Google Antigravity の /swarm とは?
/swarm は、Google のエージェントファースト開発プラットフォームである Google Antigravity のプレビューコマンドです。プロンプトを1つ入力するだけで、Antigravity がエージェントチームを立ち上げ、その動きをリアルタイムで追跡できます。Gemini 4 Carbon が最も深い推論を必要とする役割を担い、軽量モデルが並列のビルド作業を行い、検証エージェントが変更が確定する前に各変更をチェックします。
Google は Gemini 4 Carbon の一般提供を発表した投稿の中でこの機能を紹介しました。「プレビュー」と明記されているため、挙動やアクセスルールは変更される可能性があると想定しておくべきです。
Antigravity 自体を初めて知る方は、まず Google Antigravity 初見レビュー と Antigravity 2.0 プラットフォームアップデート をご覧ください。スウォームを支えるモデルについては Gemini 4 Carbon とは? を参照してください。
調査方法に関する注意:このガイドを執筆したマシンでは /swarm へのアクセスができないため、以下の内容はすべて Google の発表に基づいています。実際に手元で実行した結果の説明はなく、/swarm 以外のコマンド構文については一切前提にしていません。
Antigravity のエージェントスウォームはどう仕事を分担するのか?
Antigravity のエージェントスウォームは、仕事を3種類のエージェントに分割します。
- リーダー(Gemini 4 Carbon)。 Google によれば、開発者は Carbon を「アーキテクチャ設計や調整など、最も深い推論を要する役割」や監査に割り当てられます。プロンプトをタスクに分解し、結果を評価します。
- ワーカー(軽量モデル)。 より高速で安価なモデルが「並列の分離ワークスペース」で動作するため、2つのワーカーがタスク実行中に互いのファイルを上書きすることはありません。
- 検証者(敵対的エージェント)。 独立したエージェントが「すべての変更をテスト」します。その役割は、コードを書いたワーカーに同意することではなく、壊れている箇所を見つけることです。

これはよく知られたパターン(高コストなプランナー、安価な並列実行者、独立したチェッカー)を、たった1つのコマンドから組み上げられるようにしたものです。
分離が重要なのは、1つの作業ツリーを並列エージェントが共有すると衝突するからです。あるエージェントが関数の名前を変更している間に、別のエージェントがまだその関数を呼び出している、といった事態が起こります。敵対的な検証者が重要なのは、コードを書いたエージェントは自分がすでに考えたパスしかテストしない傾向があるからです。
Google は /swarm で何を作ったのか?
Google の発表では3つのデモが紹介されています。これらは Google 自身のショーケースであり、独立したテストではありません。
| デモ | Carbon が制作したと Google が説明する内容 | Google が挙げたツール |
|---|---|---|
| マウンテンビューキャンパスゲーム | 「GBike に乗ったペリカン」として Google のマウンテンビューキャンパスを探索するオープンワールド3Dゲーム | Antigravity /swarm |
| Google Merchandise Store | 「2つのプロンプトで、5つのアートディレクション案を提案しながら」再構想されたストア | Carbon(Google の投稿) |
| コーナーホールのフォルテピアノ | トロントのコーナーホールの3Dモデル内に配置された、1780年頃の Stein-Schule フォルテピアノの演奏可能なモデル。「座席ごとの空間音響」付き | 「Google Antigravity のマルチエージェントループ」 |
/swarm と明示的にクレジットされているのはゲームのデモのみです。フォルテピアノのデモは Antigravity のマルチエージェントループによるものであり、近いけれど同じ主張ではありません。これらを引用する際はこの区別に注意してください。
誰が Antigravity スウォームモードを利用できるのか?
アクセスに関する Google の公式説明を、出典付きでまとめます。
| 項目 | 詳細 | 出典 |
|---|---|---|
| Carbon GA 日 | 2026年11月10日 | |
| モデル ID | gemini-4-carbon |
|
/swarm のステータス |
Google Antigravity でプレビュー | |
| 一般ユーザー向けアクセス | Google AI Ultra サブスクライバー全員に、Antigravity、Gemini アプリ、Search の AI Mode で順次提供 | |
| 開発者向けアクセス | Google AI Studio の Gemini API と Gemini for business(有料の開発者・企業向け) | |
| 導入時の API 価格 | 100万トークンあたり 入力 $2 / 出力 $10 | |
| 2026年11月30日以降の価格 | 100万トークンあたり 入力 $4 / 出力 $20 | Google(脚注) |
| デフォルトモデル | 「ソフトウェアエンジニアリングとナレッジワークの大部分において、Argon が依然として理想的な選択肢」 |
Google がまだ語っていないこと
発表ではいくつかの疑問が未解決のままです。Google が公式に文書化するまで、これらに確信を持って答えるブログや動画は疑ってかかるべきです。
- エージェント数の上限。 スウォームあたりのエージェント数の上限は明示されていません。
- プラン。 Google は Carbon が Antigravity の AI Ultra サブスクライバーに展開されると述べていますが、
/swarmプレビューを具体的にどのプランが受けられるかは言及していません。 - ワーカー用モデルの選択。 Google は「より高速で軽量なモデル」と述べるのみで、モデル名は挙げていません。
- 利用制限。 スウォーム固有のクォータやレート制限は公表されていません。
- 一般提供時期。
/swarmがプレビューを卒業する日程は未定です。
Gemini 4 Carbon のスウォームはいくらかかるのか?
Google がはっきり述べているのは1点:Carbon はトークンを多く消費する、ということです。発表によれば、Carbon は Argon より「徹底的に探索し、深く推論し、長時間の検証ループを実行するために多くのトークンを使用する」とのことです。スウォームはこれを増幅させます。リーダーが計画し、すべてのワーカーの出力をレビューし、すべての検証者のレポートを読むためです。
実務上の3つのポイント:
- 2026年11月30日まで、トークン単価は Argon と同一。 Carbon の導入価格は100万トークンあたり入力 $2・出力 $10 で、Argon と同じです。12月1日からは $4・$20 に変わります。この値上げについては Gemini 4 Carbon 料金解説 で詳しく扱っています。
- 単価が同じでも請求額は同じではない。 Carbon がタスクあたりより多くのトークンを使うなら、トークン単価が同一でも Carbon 主導のジョブは Argon のジョブより高くつきます。
- サブスクリプション vs API。 スウォームの使用量が Google AI Ultra プランにどう計上されるかは公表されていないため、プレビュー期間中は利用状況ページをこまめに確認してください。
編集の大半を軽量ワーカーに振り分ければ、Carbon のトークンは計画と監査に使えます。これは Google のガイダンス(Argon を普段の仕事に、Carbon を難しい部分に)とも一致します。Gemini 4 Carbon vs Argon の比較記事でその境界線を解説し、Gemini 4 Carbon vs Claude Fable 5.2 では Anthropic のモデルと比較しています。
Antigravity を経由せず Carbon を直接呼び出したい場合は、Gemini 4 Carbon API ガイド が最初のリクエストを説明し、Gemini 4 Argon API ガイド はより安価なデフォルトモデルを扱っています。
スウォームにコントラクトを与える:OpenAPI 仕様 + Apidog CLI テスト
検証エージェントの良し悪しは、テストの基準となる「正しさ」の定義次第です。スウォームが API を構築・変更するなら、与えられる最も強力な定義は OpenAPI 仕様と実行可能なテストです。そうすれば「検証済み」は、別のモデルが diff を読んで承認したことではなく、エンドポイントが実際のリクエストに合格したことを意味します。

失敗は、壊れたリクエストとレスポンスの正確な内容とともにワーカーへ返されます。
Apidog CLI で Antigravity エージェントにテストを実行させる
Apidog CLI を使えば、エージェントが仕様をインポートし、テストケースを書き、ターミナルから実行できます。出力は JSON なのでエージェントが読めます。手動でクリック操作する必要はありません。一度セットアップすれば、あとはエージェントが作業します。
インストールとログイン:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
近道として、エージェントに「https://apidog.com/apidog-cli-installation-guide.md を読んで Apidog CLI をセットアップして」と指示する方法もあります。このガイドはエージェント向けに書かれています。Antigravity 固有の手順については Antigravity での Apidog CLI の使い方 を参照してください。
次に、エージェントに次の1つのプロンプトを与えます:
Import ./openapi.yaml into Apidog project <projectId> on a new AI branch.
For every endpoint in the spec, create a test case that asserts the status code
and the response schema. Run all cases against environment <envId> and report
each failure with the request, the expected schema and the actual response.
エージェントは何かを書く前に各ペイロードスキーマを読み込み、次のようなコマンドを実行します:
apidog branch create --project <projectId> --type ai --name "ai/20261111-from-main-swarm-contract" --from main
apidog import --project <projectId> --format openapi --file ./openapi.yaml --branch "ai/20261111-from-main-swarm-contract"
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json --branch "ai/20261111-from-main-swarm-contract"
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261111-from-main-swarm-contract" -e <envId> -r cli,json
上記のフラグはすべて、Apidog CLI 2.2.12 の apidog <cmd> --help によるものです。AI ブランチにより、エージェントが書いた変更はレビューするまでメインブランチに入りません。これは一度に多くのエンドポイントに触れるスウォームに適した仕組みです。
スウォームと組み合わせる際に効果的な習慣が2つあります:
- 検証者の基準をコードではなく実行結果に向ける。 プロンプトで、diff の見た目にかかわらず、
apidog runの失敗を変更の失敗として扱うよう検証エージェントに指示します。 - レポートは機械可読のままにする。
-r jsonを使えば、エージェントは構造化された失敗情報を適切なワーカーにルーティングできます。後から Apidog アプリで実行結果を確認したい場合は--upload-reportを追加してください。
同じ apidog run ... -r junit コマンドは CI にも組み込めるため、スウォームがテストに使ったコントラクトをパイプラインがそのまま強制できます。セットアップ方法は CI/CD パイプラインでの Apidog CLI を参照してください。Apidog の Free プランは最大4ユーザーまで利用可能で、サイドプロジェクトで試すには十分です。
単一エージェントの代わりに /swarm を使うべきときは?
スウォームは幅の広い仕事に使いましょう。API・フロントエンド・マイグレーションに同時にまたがる機能や、サイレントバグのコストが高いビルドなどが該当します。5分でレビューできるような小さな修正は、単一エージェント(おそらく Argon 上)のままにしておくべきです。
FAQ
Google Antigravity の /swarm は無料か?
Google は /swarm の無料枠について発表していません。Google によれば、Gemini 4 Carbon は Antigravity の Google AI Ultra サブスクライバーに展開されており、Gemini API 経由で有料の開発者が利用できます。どのプランに /swarm プレビューが含まれるかは明示されていません。
Antigravity スウォームのエージェントはどのモデルで動くのか?
Google の Gemini 4 Carbon がリーダー役(アーキテクチャ、調整、監査)を担います。並列ワーカーは「より高速で軽量なモデル」が実行すると Google は述べていますが、モデル名は挙げられていません。
スウォームは何個のエージェントを実行できるのか?
Google は上限を公表していません。発表では「協調的なエージェントチーム」と説明されるのみで、数値は示されていません。
/swarm は自分の API テストと連携できるのか?
Google は組み込みの API テスト連携について説明していません。それでもエージェントにコントラクトを与えることはできます。OpenAPI 仕様と、エージェントが Apidog CLI で実行するテストを用意すれば、検証者の合格は「エンドポイントが仕様どおりのレスポンスを返した」ことを意味します。
Gemini 4 Carbon は Antigravity のデフォルトモデルなのか?
Google は Carbon ではなく Argon を、ほとんどのソフトウェアエンジニアリングとナレッジワークに適した選択肢として位置付けています。Carbon はより難しいタスク向けで、探索と検証に多くのトークンを使います。エージェント用途でフロンティアモデルを比較している場合は、Claude Fable 5.2 API ガイド もう1つの選択肢として参考になります。
