Gemini 4 Hydrogen Orchestrator: Como o Carbono Planeja e o Hidrogênio Executa

O Gemini 4 Hydrogen Orchestrator é uma opção de modelo no Google Antigravity que combina um planejador (Gemini 4 Carbon ou Argon) com o Gemini 4 Hydrogen dentro de uma mesma tarefa. O planejador explora e escreve o plano, o Hydrogen edita o código e executa os testes, e o controle volta para o planejador sempre que o Hydrogen encontra dificuldades. Segundo o Google, ele alcança uma taxa de sucesso próxima à do Carbon consumindo 24% menos cota.

A seguir: como funciona o ciclo de transferência de controle, o que significam os números de 24% e 19%, quais planos incluem o recurso e como construir a mesma divisão de papéis com a API do Gemini. Para os fundamentos do modelo, leia o que é o Gemini 4 Hydrogen.

O que é o Gemini 4 Hydrogen Orchestrator?

O Orchestrator é uma entrada no seletor de modelos do Antigravity, não um modelo separado. Escolha Orchestrator (Carbon) e o Gemini 4 Carbon planeja enquanto o Gemini 4 Hydrogen implementa. Escolha Orchestrator (Argon) e o Gemini 4 Argon passa a planejar. As alternâncias acontecem automaticamente dentro de cada resposta, em uma única conversa.

O Google o lançou em 12 de novembro de 2026. O anúncio do Antigravity nomeia o problema: executar um modelo de raciocínio de ponta em “cada etapa de cada tarefa rotineira torna seu ciclo mais lento e queima cota de modelos de ponta”.

Três fatos para ter claro:

• É exclusivo do Antigravity. Não há endpoint do Orchestrator na API do Gemini.
• Tem configuração fixa. Não é possível definir um nível de pensamento nele.
• É um único agente, não um enxame. Para agentes paralelos, o Antigravity indica subagents, /swarm, Boost ou Teamwork.

Como funciona a transferência de controle entre o Carbon e o Hydrogen no Orchestrator?

A documentação de modelos do Antigravity descreve quatro movimentos que se repetem dentro de cada turno:

1. O planejador planeja. Cada mensagem que você envia começa com uma fase somente leitura. O planejador explora a base de código, resolve ambiguidades e escreve um plano de implementação concreto, incluindo as condições que devem disparar um novo planejamento. Perguntas simples são respondidas diretamente.
2. O Hydrogen faz o trabalho. Ele aplica edições em arquivos, escreve código, executa builds e testes e verifica os resultados em relação ao plano.
3. O controle retorna diante de dificuldades. Se uma etapa de verificação falhar duas vezes, uma interface se comportar de forma diferente do esperado ou o plano não tiver definido uma escolha de design, o Hydrogen devolve o controle. O planejador inspeciona o estado da conversa, repara o plano e devolve a execução.
4. O planejador revisa o progresso. Em tarefas mais longas, e sempre que você envia uma mensagem durante a execução, o Hydrogen relata o progresso. O planejador o verifica em relação ao plano e, então, conclui, continua ou atualiza o plano.

A decisão de design que vale a pena copiar está na etapa 1: o planejador escreve seus próprios gatilhos de replanejamento. O Hydrogen recebe uma lista escrita de condições que significam “parar e perguntar”.

Por que o Google diz que roteadores estáticos de modelos falham em execuções longas de agentes?

Um roteador estático lê seu primeiro prompt, estima a dificuldade da tarefa e envia o trabalho inteiro para o modelo mais barato que ele julga capaz de concluí-la. Isso falha quando a dificuldade muda no meio da tarefa — o que é normal para agentes.

Nas palavras do Google, os roteadores “começam a falhar à medida que os agentes passam a executar por mais tempo, exigindo diferentes níveis de complexidade em diferentes etapas, muitas vezes descobertos conforme a tarefa evolui”. Uma atualização de dependências pode parecer trivial até uma mudança disruptiva de API aparecer na etapa 7. Um roteador que escolheu o modelo barato não tem como voltar atrás; um que escolheu o modelo de ponta paga preços de ponta em cada reexecução de teste. O Orchestrator decide por etapa, nos dois sentidos.

O que significam os números de 24% de cota e 19% de velocidade?

O Google informa que, no Terminal-Bench, o Orchestrator “atingiu taxas de sucesso em tarefas próximas às do Carbon enquanto, em média, consumia 24% menos cota e concluía 19% mais rápido”. Leia isso com quatro ressalvas:

São números do Google em execuções do Google — um sinal, não uma previsão para o seu repositório. Tarefas com muito planejamento economizam pouco; as com muita execução (atualizar 40 pacotes e corrigir testes) devem economizar mais.

A lógica em dólares fica mais clara na API. O Gemini 4 Hydrogen custa US$ 1,50 por 1M de tokens de entrada e US$ 7,50 por 1M de tokens de saída. O Carbon custa US$ 2,00/US$ 10,00 até 30 de novembro e, a partir de 1º de dezembro, US$ 4,00/US$ 20,00, conforme o guia de preços do Gemini 4 Carbon. Os tokens de pensamento são cobrados como saída, então cada turno de execução que você migra do Carbon para o Hydrogen reduz a taxa de saída desse turno em 62,5% aos preços de dezembro.

Quem pode usar o Orchestrator e em quais planos?

O Orchestrator é oferecido apenas no Antigravity, e o planejador que você recebe depende do seu plano do Google AI. De acordo com a documentação do Antigravity, lida em 13 de novembro de 2026:

Usuários gratuitos e do Google AI Plus têm acesso ao Hydrogen independente, mas não ao Orchestrator. Para Enterprise, a tabela da documentação e o anúncio do Antigravity divergem, então verifique o seu próprio seletor de modelos.

No CLI do Antigravity, passe o nome da opção entre aspas:

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

Em dúvida entre os planejadores? Nossa comparação entre Gemini 4 Carbon e Argon aborda essa escolha.

Quando escolher o Orchestrator em vez de um único modelo?

A documentação do Google descreve o Orchestrator como o padrão “recomendado” para o trabalho do dia a dia:

• Orchestrator: desenvolvimento de funcionalidades, correção de bugs, refatoração e depuração em múltiplos arquivos.
• Carbon ou Argon sozinhos: trabalhos em que cada etapa exige profundidade máxima, como projetar sistemas distribuídos, caçar condições de corrida ou migrações entre múltiplos repositórios.
• Hydrogen sozinho: atualizações de pacotes, eliminação de duplicações, boilerplate, testes unitários de funções bem definidas, documentação e scripts rápidos.

Regra prática: se você escreveria um plano antes de começar, use o Orchestrator. Se simplesmente começaria a digitar, use o Hydrogen.

Como construir a mesma divisão planejar/executar com a API do Gemini?

Fora do Antigravity, você constrói o ciclo do Orchestrator por conta própria. O guia What’s new in Gemini 4 Hydrogen do Google descreve o mecanismo: “Direcione os turnos de planejamento para gemini-4-carbon e os turnos de execução para gemini-4-hydrogen em uma única sessão de múltiplos turnos usando previous_interaction_id.” Nenhuma alteração no esquema de requisições é necessária entre os dois modelos.

Uma versão mínima em Python que replica a regra “falhou duas vezes, devolva o controle”:

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 e apply_and_test contêm a lógica de build e teste do seu repositório. Quatro pontos para acertar:

• Defina níveis de pensamento por papel. O Carbon tem padrão medium e limite máximo high. O Hydrogen tem padrão high e adiciona xhigh.
• Mantenha o estado no servidor. O previous_interaction_id transporta o histórico entre os modelos, e o cache implícito dá 95% de desconto em entradas repetidas. store=false bloqueia isso.
• Torne o escalonamento explícito. Copie os gatilhos do Orchestrator para o prompt do planejador.
• Registre os tokens por turno. O objeto usage informa total_thought_tokens separadamente, permitindo ver qual papel está gastando.

Formatos de requisição e autenticação estão no nosso guia da API do Gemini 4 Hydrogen.

Se você preferir não montar o ciclo manualmente, o Google informa que o SDK do Antigravity permite conectar agentes Hydrogen e Carbon com controle programático sobre os papéis. Na demonstração, agentes Hydrogen fazem triagem de issues e escrevem código, enquanto um agente Carbon fica com as refatorações e as verificações de segurança.

Teste a transferência Carbon para Hydrogen com o Apidog CLI

Um orquestrador feito à mão quebra na transferência: um ID de modelo errado, um previous_interaction_id perdido ou um nível de pensamento que o Carbon rejeita. Deixe seu agente de codificação (Claude Code, Codex, Cursor) construir um teste de duas etapas com o Apidog CLI e executá-lo.

Configure uma única vez:

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

Depois dê um prompt ao seu agente:

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.

O agente lê o esquema, valida o payload, escreve o cenário e o executa:

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}

O relatório JSON mostra lado a lado o consumo de tokens de cada papel. Adicione -r junit e a mesma execução entra no CI, de modo que uma mudança de ID de modelo ou uma transferência quebrada faça o build falhar; o guia de CI/CD do Apidog CLI mostra o pipeline, e o Apidog CLI no Claude Code cobre a configuração do agente. O plano gratuito do Apidog cobre até 4 usuários.

Perguntas frequentes (FAQ)

O Gemini 4 Hydrogen Orchestrator está disponível na API do Gemini? Não. É uma opção do seletor de modelos do Google Antigravity. Na API, você alterna entre gemini-4-carbon e gemini-4-hydrogen por conta própria com o previous_interaction_id.

Posso definir um nível de pensamento para o Orchestrator? Não. Ele executa com configuração fixa. Selecione Carbon, Argon ou Hydrogen diretamente se precisar de um nível específico.

Preciso do Google AI Ultra? Para o Orchestrator (Carbon), sim. Assinantes pagos do Google AI Pro recebem o Orchestrator (Argon). Usuários gratuitos podem usar o Hydrogen sozinho; veja nosso guia gratuito do Gemini 4 Hydrogen.

O Orchestrator economiza dinheiro na API? A mesma divisão de papéis economiza: os turnos de execução são cobrados aos US$ 7,50 por 1M de tokens de saída do Hydrogen em vez dos valores do Carbon. O guia de preços do Gemini 4 Hydrogen tem a tabela completa.