Saltar para o conteúdo principal
Um adapter é a ponte entre o Orkestral e um modelo ou agente de código. Quando um agente assume um chat ou executa uma issue, ele roteia o trabalho por meio de um adapter: Claude, Codex, o Forge embutido ou um dos provedores locais. O gerenciador de adapters é onde você vê quais adapters estão prontos para rodar e quais ainda estão a caminho. Esta página explica como a disponibilidade funciona, por que alguns adapters aparecem mas ainda não podem executar e como você configura os provedores e integrações que alimentam seu time.
O Orkestral é local-first. Adapters que encapsulam uma CLI local (como as ferramentas de linha de comando do Claude ou do Codex) rodam na sua máquina. O Forge roda totalmente offline em um modelo local embutido. Nada sobre o seu código sai da sua máquina, a não ser que um adapter que você escolheu faça uma chamada de rede.

​
Por que adapters podem estar disponíveis ou não

Nem todo adapter que aparece no onboarding ou no registro consegue de fato rodar código hoje. Alguns são listados para que você veja o roadmap, mas ainda não estão ligados a um caminho de execução real. O Orkestral trata isso com honestidade: em vez de cair silenciosamente em um binário diferente e fingir que funcionou, um adapter indisponível falha com uma mensagem clara. Os adapters que estão visíveis mas ainda não podem executar são rastreados em um único lugar no processo principal (src/main/services/adapter-availability.ts):

Gemini

Listado como gemini_local. Ainda não disponível para execução.

OpenCode

Listado como opencode_local. Ainda não disponível para execução.

Pi

Listado como pi_local. Ainda não disponível para execução.

Grok

Listado como grok_local. Ainda não disponível para execução.
Quando você tenta usar um desses em um chat ou para executar uma issue, recebe uma mensagem informando que ele não está pronto e apontando para o que funciona hoje:
O provedor ainda não está disponível para execução (em breve). Use Claude, Codex ou o Forge por enquanto.
Se você vir essa mensagem, não fez nada de errado. Reatribua o trabalho ao Claude, ao Codex ou ao Forge e ele vai rodar.

​
O que está disponível hoje

Claude

Modelo premium usado para planejamento e raciocínio. Roteado pela ferramenta de linha de comando do Claude quando instalada.

Codex

Modelo premium para planejamento e raciocínio. Roteado pela ferramenta de linha de comando do Codex quando instalada.

Forge

O executor local embutido (Qwen2.5-Coder). Aplica mudanças de código localmente com custo de API zero.
A divisão de trabalho habitual é simples: adapters premium (Claude, Codex) PLANEJAM e o Forge EXECUTA as mudanças de código localmente por meio do motor determinístico do Fast Apply. Você pode ler mais em Forge e Fast Apply e Escolhendo modelos.

​
Como a disponibilidade é verificada

A disponibilidade tem duas camadas. A primeira é se um adapter está ligado a um caminho de execução (a camada de roadmap acima). A segunda é se a CLI subjacente está de fato instalada na sua máquina.
1

O adapter está registrado

O adapter aparece no onboarding e no registro para que você possa selecioná-lo. O registro por si só não significa que ele pode rodar.
2

O suporte a execução é confirmado

O Orkestral verifica se o adapter tem um caminho de execução real. Adapters no conjunto indisponível (Gemini, OpenCode, Pi, Grok) param aqui e retornam a mensagem de em breve.
3

A CLI é detectada

Para adapters baseados em CLI, como Claude e Codex, o Orkestral procura a ferramenta de linha de comando correspondente na sua máquina. Se o binário estiver ausente, instale-o para que o adapter possa iniciá-lo.
4

O adapter roda

Com suporte a execução e um binário detectado (ou o modelo do Forge embutido), o agente roda o trabalho por meio do adapter.
Instalar a CLI de um provedor não é o mesmo que configurar uma chave de API. A CLI cuida da própria autenticação. Garanta que a ferramenta de linha de comando esteja instalada e logada antes de atribuir trabalho a esse adapter.

​
Configurando provedores e integrações

Adapters cobrem os modelos e agentes de código. Integrações cobrem os serviços externos dos quais seu time lê e nos quais escreve (controle de versão, observabilidade, notificações). Você gerencia isso na página Integrações. A página de Integrações (src/renderer/src/pages/IntegrationsPage.tsx) oferece uma grade pesquisável e filtrável de todos os provedores que o Orkestral conhece. Cada card mostra um nome, uma descrição curta e uma categoria, além de uma ação de configurar ou uma etiqueta de em breve.
1

Abra Integrações

Vá até a página Integrações pela barra lateral.
2

Pesquise ou filtre

Digite na caixa de busca para encontrar por nome ou descrição, ou clique em um Chip de categoria (por exemplo Observabilidade) para reduzir a lista. Escolha Todos para limpar o filtro.
3

Abra um card

Clique em um card ativo para configurá-lo. Cards marcados como em breve estão visíveis mas ainda não são configuráveis.
4

Conecte o provedor

Siga o fluxo do card para autenticar ou colar as credenciais que o provedor precisa.

​
O que você pode configurar hoje

Conecte um host de repositório para que os agentes possam ler código, branches e pull requests. Configurado pelo próprio card na página de Integrações.
Integração de entrada por voz, disponível agora e configurada a partir do card dedicado.
Rastreamento de erros para que os agentes possam trazer issues e stack traces para o contexto. Disponível agora.
Erros, logs e métricas por meio do NerdGraph e do NRQL, agrupados na categoria Observabilidade. Disponível agora.
Incidentes, uptime e logs para investigação, também em Observabilidade. Disponível agora.

​
O que vem em breve

Estes aparecem na grade com uma etiqueta de em breve e ainda não são configuráveis:

Slack

Jira

ClickUp

Google Calendar

Gmail

Notion

A grade de Integrações é bilíngue. Nomes, descrições e categorias seguem o idioma da sua interface, então o mesmo provedor aparece em inglês ou em português do Brasil conforme a sua configuração.

​
Lendo os cards

Cada card na página de Integrações informa o seu estado de relance:
O card mostra uma ação de configurar. Clique nela para abrir o fluxo de conexão e autenticar.

​
Solução de problemas

Você atribuiu trabalho ao Gemini, OpenCode, Pi ou Grok. Eles estão visíveis no roadmap mas ainda não podem executar. Reatribua ao Claude, ao Codex ou ao Forge.
A ferramenta de linha de comando correspondente provavelmente está ausente ou não está logada. Instale a CLI do provedor, autentique-a e tente de novo. Lembre-se de que a CLI cuida do próprio login, separado de qualquer chave de API.
Limpe a caixa de busca e selecione a categoria Todos. Se ainda assim ele não aparecer, é porque ainda não está na grade.
Roteie a execução pelo Forge. Ele roda localmente no modelo embutido e aplica mudanças por meio do Fast Apply sem cobranças de API.

​
O que fazer em seguida

Forge e Fast Apply

Saiba como o executor local aplica mudanças de código com custo zero.

Escolhendo modelos

Decida qual adapter planeja e qual executa.

Contratando seu time

Atribua especialistas e os adapters em que eles rodam.

Conectando fontes

Aponte seus agentes para os repos e pastas em que trabalham.