Gemini 4 Hydrogen Orchestrator：Carbonが計画し、Hydrogenが実行する仕組み

Gemini 4 Hydrogen Orchestratorは、Google Antigravityで利用できるモデルオプションで、1つのタスク内でプランナー(Gemini 4 Carbon または Argon)とGemini 4 Hydrogenを組み合わせます。プランナーが調査と計画立案を担当し、Hydrogenがコード編集とテスト実行を行い、Hydrogenが問題にぶつかるたびに制御はプランナーに戻ります。Googleによると、Carbonに近い成功率を24%少ないクォータで達成できるとのことです。

以下では、引き継ぎループの仕組み、24%と19%という数字の意味、どのプランで利用できるか、そしてGemini APIで同じ分割構造を自分で構築する方法を解説します。モデルの基礎については、Gemini 4 Hydrogenとは何かをご覧ください。

Gemini 4 Hydrogen Orchestratorとは?

Orchestratorは独立したモデルではなく、Antigravityのモデルセレクターにあるエントリです。Orchestrator (Carbon)を選ぶとGemini 4 Carbonが計画を立て、Gemini 4 Hydrogenが実装します。Orchestrator (Argon)を選ぶと、代わりにGemini 4 Argonが計画を立てます。切り替えは1つの会話の中で、各レスポンス内で自動的に行われます。

Googleは2026年11月12日にこれをリリースしました。Antigravityの発表では、「定型的なタスクのあらゆるステップでフロンティア級の推論モデルを実行すると、ループが遅くなり、フロンティア級のクォータを消費する」という問題点を挙げています。

押さえておくべき3つの事実:

• Antigravity限定です。Gemini APIにOrchestratorのエンドポイントはありません。
• 設定は固定です。thinking levelを設定することはできません。
• 1つのエージェントであり、スウォームではありません。並列エージェントが必要な場合、Antigravityはサブエージェント、/swarm、Boost、Teamworkの利用を案内しています。

OrchestratorはCarbonとHydrogenの間でどのように処理を引き継ぐのか?

Antigravityのモデルドキュメントは、各ターン内で繰り返される4つの動きを説明しています:

1. プランナーが計画を立てる。送信したすべてのメッセージは、まず読み取り専用フェーズから始まります。プランナーはコードベースを調査し、曖昧さを解消し、再計画をトリガーすべき条件も含めて具体的な実装計画を書きます。単純な質問には直接回答します。
2. Hydrogenが作業を行う。ファイル編集の適用、コードの記述、ビルドとテストの実行、そして計画に対する結果の確認を行います。
3. 問題発生時に制御が戻る。検証ステップが2回失敗した場合、インターフェースが予想と異なる動作をした場合、または計画で設計上の判断が未決だった場合、Hydrogenは制御を返します。プランナーは会話の状態を確認し、計画を修復してから実行を返します。
4. プランナーが進捗を確認する。長いタスクでは、実行中にメッセージを送信した場合も含め、Hydrogenが進捗を報告します。プランナーはそれを計画と突き合わせて、終了、継続、または計画の更新を判断します。

真似する価値のある設計判断はステップ1にあります。プランナーが再計画のトリガーを自ら定義するのです。Hydrogenには「停止して質問する」ことを意味する条件のリストが書面で渡されます。

Googleは、静的モデルルーターが長時間のエージェント実行で壊れると述べているのはなぜか?

静的ルーターは最初のプロンプトを読んでタスクの難易度を推測し、完了できると判断した最も安価なモデルにジョブ全体を振り分けます。しかし、エージェントでは珍しくないことですが、タスクの途中で難易度が変化すると、この手法は失敗します。

Googleの言葉を借りると、ルーターは「エージェントの実行が長くなり、タスクの進展とともに発見されることが多い、段階ごとに異なる複雑さが求められるようになると、機能し始めなくなる」のです。依存関係のアップグレードは、ステップ7で破壊的なAPI変更が表面化するまでは些細な作業に見えるかもしれません。安価なモデルを選んだルーターには後戻りの手段がなく、フロンティアモデルを選んだルーターはテストの再実行のたびにフロンティア級の料金を払うことになります。Orchestratorは段階ごとに、双方向で判断します。

24%のクォータ削減と19%の高速化という数字の意味は?

Googleは、Terminal-BenchにおいてOrchestratorが「平均して24%少ないクォータを消費し、19%速く完了しながら、Carbonに近いタスク成功率に到達した」と報告しています。この数字は以下の4つの留保付きで読むべきです:

これらはGoogle自身の環境におけるGoogleの数字であり、あなたのリポジトリへの予測というよりシグナルです。計画が中心のタスクでは節約額は小さく、実行が中心のタスク(40個のパッケージ更新とテスト修正など)ではより大きな節約が見込めるはずです。

ドルベースの論理はAPIの方が分かりやすいでしょう。Gemini 4 Hydrogenの価格は入力100万トークンあたり$1.50、出力100万トークンあたり$7.50です。CarbonはGemini 4 Carbon価格ガイドによると、11月30日までは$2.00/$10.00、12月1日からは$4.00/$20.00です。thinkingトークンは出力として課金されるため、実行ターンをCarbonからHydrogenに移すごとに、そのターンの出力単価は12月価格で62.5%削減されます。

誰がOrchestratorを利用でき、どのプランで使えるのか?

OrchestratorはAntigravity限定で、得られるプランナーはGoogle AIプランによって異なります。2026年11月13日時点のAntigravityドキュメントによると:

無料ユーザーとGoogle AI PlusユーザーはスタンドアロンのHydrogenは使えますが、Orchestratorは使えません。Enterpriseについては、ドキュメントの表とAntigravityの発表に食い違いがあるため、ご自身のモデルセレクターを確認してください。

Antigravity CLIでは、オプション名を引用符で囲んで指定します:

agy --model "Orchestrator (Carbon)"
agy -p "Add input validation to the signup form and run the tests." --model "Orchestrator (Argon)"

プランナーの選び方については、Gemini 4 Carbon vs Argon比較記事でトレードオフを解説しています。

単一モデルではなくOrchestratorを選ぶべきときは?

Googleのドキュメントは、日常業務についてOrchestratorを「推奨デフォルト」と位置付けています:

• Orchestrator:機能開発、バグ修正、リファクタリング、マルチファイルのデバッグ。
• CarbonまたはArgon単独:分散システムの設計、レースコンディションの追跡、マルチリポジトリ移行など、すべてのステップで最大限の深さが必要な作業。
• Hydrogen単独:パッケージ更新、重複コードの削除、ボイラープレート、明確に定義された関数のユニットテスト、ドキュメント、簡単なスクリプト。

経験則:開始前に計画を書くならOrchestrator、すぐに打ち込み始めるならHydrogenです。

Gemini APIで同じ計画/実行の分割を構築するには?

Antigravityの外では、Orchestratorのループを自分で構築します。GoogleのGemini 4 Hydrogenの新機能ガイドはその仕組みを次のように説明しています:「previous_interaction_idを使って、1つのマルチターンセッション内で計画ターンをgemini-4-carbonに、実行ターンをgemini-4-hydrogenにルーティングする」。2つのモデル間でリクエストスキーマの変更は不要です。

「2回失敗したら返す」ルールを再現した最小限のPythonコード:

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

def ask(model, prompt, prev=None, level="high"):
    return client.interactions.create(
        model=model,
        input=prompt,
        previous_interaction_id=prev,
        generation_config={"thinking_level": level},
    )

# 1. Carbon plans (read-only) and writes its own re-plan triggers
plan = ask("gemini-4-carbon",
    "Plan this task as numbered steps. For each step, list the check "
    "that proves it worked and the conditions that require re-planning. "
    "Do not write code yet. Task: " + task)
last = plan.id

for step in parse_steps(plan.output_text):
    failures = 0
    while True:
        # 2. Hydrogen executes the step
        run = ask("gemini-4-hydrogen", f"Implement step: {step}", prev=last)
        last = run.id
        ok, log = apply_and_test(run.output_text)  # your patch + test runner
        if ok:
            break
        failures += 1
        if failures >= 2:
            # 3. Escalate to Carbon to repair the plan
            fix = ask("gemini-4-carbon",
                f"Step failed twice. Test log:\n{log}\nRepair the plan for this step.",
                prev=last)
            last = fix.id
            step, failures = fix.output_text, 0

# 4. Carbon reviews the finished work
review = ask("gemini-4-carbon", "Review the completed work against the plan.", prev=last)

parse_stepsとapply_and_testには、あなたのリポジトリのビルドとテストのロジックを記述します。押さえるべき4つのポイント:

• 役割ごとにthinking levelを設定する。Carbonはデフォルトmedium、上限highです。Hydrogenはデフォルトhighで、xhighも追加されています。
• 状態をサーバー側に保持する。previous_interaction_idがモデル間で履歴を受け渡し、暗黙的キャッシュにより繰り返し入力が95%割引になります。store=falseはこれを無効化します。
• エスカレーションを明示的にする。Orchestratorのトリガーをプランナーのプロンプトに組み込みましょう。
• ターンごとにトークンを記録する。usageオブジェクトはtotal_thought_tokensを別途報告するため、どの役割が消費しているか分かります。

リクエスト形式と認証についてはGemini 4 Hydrogen APIガイドをご覧ください。

ループを手作りしたくない場合は、GoogleによるとAntigravity SDKを使えば、役割をプログラム的に制御しながらHydrogenエージェントとCarbonエージェントを連携させられるとのことです。Googleのデモでは、Hydrogenエージェントがイシューのトリアージとコーディングを担当し、Carbonエージェントがリファクタリングとセキュリティチェックを担当しています。

Apidog CLIでCarbonからHydrogenへの引き継ぎをテストする

自作オーケストレーターが壊れるのは引き継ぎの瞬間です:間違ったモデルID、欠落したprevious_interaction_id、Carbonが拒否するthinking levelなど。Apidog CLIでコーディングエージェント(Claude Code、Codex、Cursor)に2ステップのテストを構築させて実行しましょう。

一度だけセットアップします:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

そして、エージェントに1つのプロンプトを渡します:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Build a test scenario with two steps against POST /v1beta/interactions,
both sending the x-goog-api-key header:
1. Planner: model "gemini-4-carbon", thinking_level "high", input asks for a
   3-step plan. Assert status 200, status "completed", non-empty output and a
   usage object. Extract $.id into plannerId.
2. Executor: model "gemini-4-hydrogen", thinking_level "medium",
   previous_interaction_id {{plannerId}}, input "Do step 1 of the plan".
   Assert the same checks. Log total_input_tokens, total_thought_tokens and
   total_output_tokens for both steps. Run it and summarize failures.

エージェントはスキーマを読み、ペイロードを検証し、シナリオを書いて実行します:

apidog environment create gemini --project <projectId> \
  --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario create --project <projectId> --name "carbon-to-hydrogen"
apidog test-scenario update <scenarioId> --project <projectId> --file scenario.json
apidog test-scenario run <scenarioId> --project <projectId> -e <envId> \
  -r cli,json --out-file handoff-{GENERATE_TIME}

JSONレポートには各役割のトークン消費が並んで表示されます。-r junitを追加すれば同じ実行をCIに組み込め、モデルIDの変更や引き継ぎの不具合がビルド失敗として検出されます。パイプラインの詳細はApidog CLI CI/CDガイド、エージェントのセットアップはClaude CodeでのApidog CLI活用を参照してください。ApidogのFreeプランは最大4ユーザーまで利用できます。

FAQ

Gemini 4 Hydrogen OrchestratorはGemini APIで利用できますか?いいえ。Google Antigravityのモデルセレクターのオプションです。APIでは、previous_interaction_idを使って自分でgemini-4-carbonとgemini-4-hydrogenを切り替えます。

Orchestratorにthinking levelを設定できますか?いいえ。固定設定で実行されます。特定のレベルが必要な場合は、Carbon、Argon、Hydrogenを直接選択してください。

Google AI Ultraが必要ですか?Orchestrator (Carbon)には必要です。有料のGoogle AI Proの契約者はOrchestrator (Argon)を利用できます。無料ユーザーはHydrogenを単独で使えます。詳しくはGemini 4 Hydrogen無料ガイドをご覧ください。

OrchestratorはAPIでコストを節約できますか?同じ分割構造なら節約できます。実行ターンがCarbonの単価ではなくHydrogenの100万出力トークンあたり$7.50で課金されるためです。全表はGemini 4 Hydrogen価格ガイドにあります。