Saltar para o conteúdo principal
O adapter Gemini conecta o Orkestral ao Gemini CLI do Google para que um agente possa usar modelos Gemini no planejamento. Como os outros adapters de provedores premium, o Gemini conduz o trabalho de raciocínio e delegação. O Forge local incluído executa as alterações de código de fato, sem custo de API.
Id do tipo de adapter: gemini_local. Nome de exibição: Gemini CLI. Ele executa um binário gemini local na sua máquina, então seu código e seus prompts vão direto para a CLI que você instalou.

​
O que é

O adapter Gemini é um wrapper fino em torno do Google Gemini CLI (@google/gemini-cli). O Orkestral detecta a CLI no seu PATH, valida suas credenciais do Google e permite escolher um modelo Gemini ao contratar ou configurar um agente. Você o seleciona durante o onboarding ou ao editar um agente em Configurações.

​
Requisitos

Antes de selecionar o adapter Gemini, confirme que você tem o seguinte.

Gemini CLI instalado

O binário gemini precisa estar no seu PATH. Instale-o com npm i -g @google/gemini-cli.

Node.js

O Gemini CLI roda sobre Node.js, então um runtime Node recente precisa estar disponível.

Credenciais do Google

Defina GEMINI_API_KEY ou aponte GOOGLE_APPLICATION_CREDENTIALS para um arquivo de conta de serviço.

Acesso à rede

Os modelos Gemini rodam na nuvem, então a CLI precisa de acesso de saída ao Google.
Se nem GEMINI_API_KEY nem GOOGLE_APPLICATION_CREDENTIALS estiverem definidos, o teste de ambiente reporta um aviso e as execuções podem falhar. Defina ao menos um antes de depender do adapter.

​
Como configurar

1

Instale o Gemini CLI

Execute npm i -g @google/gemini-cli em um terminal e confirme que funciona com gemini --version.
2

Autentique com o Google

Exporte GEMINI_API_KEY com sua chave de API ou defina GOOGLE_APPLICATION_CREDENTIALS com o caminho de um arquivo JSON de conta de serviço do Google. Garanta que a variável esteja visível para o ambiente que inicia o Orkestral.
3

Selecione o adapter

No onboarding (ou ao editar um agente), abra a grade de adapters e escolha Gemini CLI. Os adapters são listados na ordem do registro, então o Gemini aparece junto com as outras CLIs locais.
4

Escolha um modelo

Escolha um modelo Gemini na lista de modelos (veja abaixo). Use Default para manter o modelo que sua CLI estiver configurada para usar.
5

Configure as opções

Opcionalmente ative o toggle de sandbox ou defina um caminho de comando personalizado, então salve.
6

Teste o ambiente

Execute o teste de ambiente para o adapter. O Orkestral verifica o binário, a versão da CLI e suas credenciais do Google, e reporta aprovação, aviso ou falha para cada item.

​
Modelos

O adapter expõe uma lista fixa de opções de modelo. Escolha uma ao configurar o agente.
Id do modeloRótuloNotas
defaultDefaultUsa o modelo configurado na CLI.
gemini-2.5-proGemini 2.5 ProMaior nível de capacidade da lista.
gemini-2.5-flashGemini 2.5 FlashMais rápido e mais barato.
gemini-2.5-flash-liteGemini 2.5 Flash LiteVariante Flash mais leve.
gemini-2.0-flashGemini 2.0 FlashGeração anterior do Flash.
gemini-2.0-flash-liteGemini 2.0 Flash LiteVariante mais leve do 2.0 Flash.
Se você não tem certeza de qual modelo usar, comece com Default. Ele transfere a escolha para o que quer que seu Gemini CLI já esteja configurado para chamar.

​
Opções de configuração

O adapter expõe dois campos de configuração. Você os define no formulário de configuração do adapter ao selecionar Gemini CLI.
​
sandbox
toggle
padrão:"false"
Quando habilitado, o Orkestral passa --sandbox para a CLI. Use isto para rodar o Gemini em seu modo sandbox. Desligado por padrão.
​
command
text
padrão:"gemini"
Override para o comando ou caminho usado para invocar a CLI. Deixe em branco para usar gemini do seu PATH, ou defina um caminho completo ou um nome de comando alternativo.

​
Capacidades e limites

O Gemini conduz o planejamento de um agente. O Forge local realiza as edições de arquivos. Isso mantém o custo de execução em zero no lado da API, deixando o Gemini cuidar do raciocínio.
O adapter aciona um processo gemini local. Tudo o que a CLI pode fazer (e quaisquer limites que ela tenha) se aplica aqui. O Orkestral não inclui a CLI para você.
Os próprios modelos Gemini rodam na infraestrutura do Google. Seus prompts e qualquer contexto que a CLI envie saem da sua máquina e vão para o Google.
O teste de ambiente verifica três coisas: o binário gemini está no PATH, a CLI responde a --version (dentro de um curto timeout) e ao menos uma variável de credencial do Google está presente. Uma credencial ausente é um aviso, não uma falha rígida.

​
Solução de problemas

O Orkestral não conseguiu localizar o binário gemini. Instale-o com npm i -g @google/gemini-cli, então reabra o Orkestral para que ele herde o PATH atualizado. Se você o instalou em um local personalizado, defina a opção command com o caminho completo.
O binário existe mas não respondeu a gemini --version dentro do timeout. Execute gemini --version você mesmo em um terminal para ver o erro real e confirme que a instalação não está quebrada.
O teste avisa quando nem GEMINI_API_KEY nem GOOGLE_APPLICATION_CREDENTIALS estão definidos. Exporte um deles no shell que inicia o Orkestral. No macOS, apps de GUI podem não enxergar variáveis definidas apenas no seu perfil de shell, então defina-as onde o ambiente de inicialização possa lê-las.
Um teste de ambiente aprovado confirma que a CLI e as credenciais existem, não que as credenciais sejam válidas ou que o modelo escolhido esteja disponível para sua conta. Verifique seu projeto Google, o faturamento e o acesso aos modelos, então tente o modelo Default para descartar um problema específico de modelo.
O toggle de sandbox apenas adiciona --sandbox à invocação da CLI. Se algo funciona sem ele mas não com ele, a diferença vem do próprio sandbox do Gemini CLI, não do Orkestral. Desative o toggle para voltar ao comportamento padrão da CLI.

​
Relacionados

Visão geral dos adapters

Como os adapters de provedores e o Forge local dividem planejamento e execução.

Forge local

O executor incluído que aplica alterações de código sem custo de API.