Saltar para o conteúdo principal
Na primeira vez que você abre o Orkestral, você não cai em um app vazio. Um assistente de onboarding em tela cheia toma conta da janela e conduz você por tudo que o time precisa para começar a trabalhar: quem você é, onde seu código vive, quem é o seu primeiro agente, o que você quer que seja feito e em qual plano rodar. Quando o assistente fecha, você já tem um workspace, uma fonte primária, um agente contratado e (opcionalmente) um repositório recém-clonado, tudo pronto para usar. Esta página explica o assistente de ponta a ponta, tela por tela, incluindo como cada tipo de fonte se conecta e o que acontece depois que você termina.

​
O que é o assistente

O assistente é uma barreira. A cada abertura, o Orkestral verifica duas coisas: se o onboarding foi concluído e se algum workspace existe. Se qualquer um dos dois estiver faltando, o assistente aparece no lugar do dashboard. É por isso que o assistente reaparece se você escolher Refazer onboarding nas Configurações (isso reseta a flag de concluído sem apagar seus workspaces existentes).
O assistente é um overlay fixo em tela cheia. Não há barra de progresso no topo: cada etapa tem seus próprios botões Continuar e Voltar, e a janela continua arrastável pela área da barra de título enquanto você preenche as informações.
O fluxo tem cinco telas, nesta ordem:
  1. Boas-vindas (login opcional no Orkestral Cloud)
  2. Você e seu workspace (seu nome, nome do workspace, onde o código vive, missão)
  3. Seu primeiro agente (nome, adapter, modelo, verificação de ambiente)
  4. O que você quer que seja feito (objetivos)
  5. Plano (Free Local ou Team Cloud, mais o toggle do plano de contratação inicial)

​
Passo a passo

1

Boas-vindas

A primeira tela é uma boas-vindas com a marca sobre um fundo animado de galáxia. Você tem dois caminhos:
  • Entrar no Orkestral Cloud. Isso abre seu navegador para autenticar. O login é concluído na web, depois um deep link reabre o app desktop e devolve a conta (parecido com um handoff de 2FA). Assim que a conta chega, o assistente avança automaticamente e mostra com qual e-mail você está conectado.
  • Pular login. Um link mais discreto de “pular” inicia o assistente sem uma conta. Tudo que é local continua funcionando.
Os links para os Termos e a política de Privacidade ficam na parte de baixo da tela.
Se o navegador não abrir durante o login, o assistente mostra um erro de login e limpa o estado de carregamento para você tentar de novo. O deep link ainda concluirá o login se você terminar de autenticar no navegador.
2

Você e seu workspace

Esta é a tela central de configuração. Ela coleta quatro coisas:
  • Seu nome. Obrigatório.
  • Nome do workspace. Obrigatório. Isso nomeia o workspace em que o time trabalha.
  • Onde seu código vive. Escolha um de três provedores: Pasta local, GitHub ou Azure DevOps. Veja Conectando uma fonte abaixo para cada um.
  • Missão. Uma descrição curta e opcional do que é este workspace. Ela dá contexto aos seus agentes.
Você não pode continuar até que seu nome e o nome do workspace estejam preenchidos. O botão Continuar fica desabilitado até lá.
Escolher uma pasta local ou selecionar um repo preenche automaticamente o nome do workspace a partir do nome da pasta ou do repo se você o deixou em branco, então raramente é preciso digitar duas vezes.
3

Seu primeiro agente

Aqui você cria o agente que lidera o time (pense nele como o CEO ou orquestrador). Você define:
  • Nome do agente. Vem com um placeholder padrão como “CEO”.
  • Adapter. O provedor de IA que move o agente. Os adapters recomendados aparecem primeiro com um selo verde “Recomendado”; clique em Mais tipos de adapter para revelar o restante. Adapters marcados como “Em breve” ficam desabilitados.
  • Modelo. A lista de modelos recarrega sempre que você muda o adapter. Se o seu modelo atual não estiver disponível para o novo adapter, ele cai para o padrão daquele adapter.
  • Config do provedor. Alguns adapters expõem campos extras de configuração (como uma chave de API). Eles aparecem apenas quando o adapter selecionado precisa deles.
  • Nível de autonomia. Um slider que vale para todo o workspace e define quanto o time pode fazer por conta própria.
O agente líder precisa ser capaz de planejar, então o modelo local apenas-executor não pode ser escolhido aqui. Esse modelo é reservado para os agentes executores que você contrata depois.
Use Rodar verificação de ambiente para confirmar que o adapter selecionado funciona na sua máquina antes de fechar. O resultado mostra um status geral de aprovado, aviso ou falha, além de uma lista de verificações individuais com detalhes. Se a verificação lançar um erro, a mensagem aparece inline para você saber exatamente o que corrigir.
4

O que você quer que seja feito

Escolha os tipos de trabalho em que você quer que o time se concentre. As opções são uma grade de seleção múltipla: revisão de código, build, correção de bugs, arquitetura, refatoração, performance, docs, testes, segurança e CI/CD. Os cards selecionados ganham uma marca de check e uma borda destacada. Esses objetivos moldam o time que o Orkestral propõe para você.
5

Escolha um plano

A última tela oferece dois planos:
  • Free Local. Roda inteiramente na sua máquina. Este é o plano selecionável hoje.
  • Team Cloud. Marcado como “Em breve” e desabilitado por enquanto.
Abaixo dos planos há uma caixa de seleção: Rodar o plano de contratação inicial. Deixe-a ligada para que o Orkestral proponha e monte um time inicial logo após o onboarding terminar.O botão Continuar nesta etapa final mostra “Concluir e abrir” em vez de “Continuar”. Pressioná-lo envia tudo.

​
Conectando uma fonte

O seletor “onde seu código vive” na segunda etapa é onde você anexa sua base de código. Os três provedores se comportam de formas diferentes.
Escolha Pasta local, depois digite um caminho ou clique em Escolher para abrir um seletor de pastas nativo. O último segmento do caminho vira o rótulo da fonte (e preenche o nome do workspace se ele estiver vazio).Uma pasta local é registrada imediatamente como uma fonte na sua máquina. Nada é clonado, porque os arquivos já estão no disco, então o onboarding termina sem uma etapa de clonagem para este provedor.
Tanto os repos do GitHub quanto os do Azure são armazenados como “fontes remotas” no rascunho. Você pode selecionar vários de uma vez. Desconectar uma conta limpa os repos selecionados dela do rascunho, para que você nunca termine o onboarding apontando para um repo ao qual não tem mais acesso.

​
A etapa de clonagem

Quando você pressiona Concluir e abrir, o Orkestral primeiro salva suas respostas de onboarding (criando o workspace e o agente líder). Depois, se você escolheu um ou mais repositórios remotos, ele os clona. Um overlay de clonagem em tela cheia aparece com uma marca do GitHub girando e o nome do repo que está sendo clonado no momento. Não há barra de porcentagem de propósito: um git clone --depth 1 raso não reporta progresso confiável, então você recebe um sinal claro de “isto está acontecendo” e o nome do repo no lugar. Nos bastidores, para cada fonte remota o Orkestral:
  • Cria a fonte no novo workspace e espera a clonagem terminar.
  • Marca o primeiro repo como a fonte primária.
  • Dispara a análise de conhecimento sobre o código clonado para que os agentes comecem com contexto real.
Depois que o primeiro repo é clonado, o Orkestral finaliza o workspace contra aquele caminho clonado e, se você deixou o toggle ligado, enfileira o plano de contratação inicial.
Se o onboarding falhar (um erro de clonagem, um erro de criação), o overlay de clonagem fecha e um banner de erro amigável aparece no topo do assistente. O detalhe técnico é registrado no console para depuração. Suas respostas são mantidas, então você pode corrigir o problema e terminar de novo.

​
Quando o onboarding termina

Em caso de sucesso, o Orkestral define o novo workspace e projeto como ativos, reseta o estado do assistente e reproduz uma transição curta de abertura (cerca de 2,6 segundos) antes de revelar o dashboard. A transição mantém um handoff suave sem flash entre o assistente e o app: os dados do dashboard carregam por baixo, depois o overlay some para mostrá-lo. A partir daqui você está no app normal, com um workspace, uma fonte primária e seu agente líder. Bons próximos passos:

Contratar um time

Se você desligou o plano de contratação inicial, monte seu time agora.

Rodar sua primeira tarefa

Dê algo ao time para fazer e veja-o trabalhar.

Conectar mais fontes

Adicione mais repos ou pastas ao mesmo workspace.

Configurações

Ajuste adapters, autonomia e mais. Refaça o onboarding a partir daqui se precisar.

​
FAQ

Sim. A tela de boas-vindas tem um link de pular, e tudo que é local (workspaces, fontes, agentes, o plano Free Local) funciona sem uma conta.
Trocar o provedor na segunda etapa limpa as seleções ligadas aos outros provedores, então você pode mudar de ideia livremente antes de terminar. Depois do onboarding, adicione ou remova fontes do workspace a qualquer momento.
A barreira mostra o assistente sempre que o onboarding não está marcado como concluído ou não há workspaces. Escolher Refazer onboarding nas Configurações reseta a flag de concluído (sem apagar workspaces), o que traz o assistente de volta.
Não. Uma pasta local já está no disco, então não há etapa de clonagem para esse provedor. O overlay de clonagem só aparece para repositórios do GitHub ou Azure.
Ela confirma que o adapter selecionado consegue de fato rodar na sua máquina (por exemplo, que uma CLI está instalada ou que uma chave de API funciona) e reporta aprovado, aviso ou falha com detalhes por verificação, para você pegar problemas antes de terminar.