Saltar para o conteúdo principal
Um workspace é o lar de um projeto, produto ou codebase dentro do Orkestral. Ele agrupa tudo o que sua equipe de IA precisa para trabalhar: as fontes (repos e pastas) que ela lê, os agentes que você contrata, as issues e épicos que você acompanha, e o conhecimento destilado do seu código. Quando você abre um workspace, o app inteiro (o orquestrador CEO, o chat, os boards) opera dentro dele. Esta página orienta você na criação do seu primeiro workspace de ponta a ponta, na escolha da cor de destaque e na alternância entre workspaces depois que você tiver mais de um.
Tudo permanece local. Os workspaces e seus dados ficam em ~/.orkestral na sua máquina. Não há conta para criar nem projeto para enviar a um servidor.

​
O que um workspace contém

Pense em um workspace como uma empresa. O orquestrador (seu CEO) a dirige, e cada parte da empresa tem seu lugar.

Fontes

Os repos e pastas que a equipe lê. Conecte um repo do GitHub, um repo do Azure DevOps ou uma pasta local. Uma fonte é a fonte primária.

Agentes

Sua equipe contratada: o CEO mais especialistas (Tech Lead, Code Reviewer, Frontend, Backend, DevOps, QA, Designer). Cada agente é restrito a este workspace.

Issues

O trabalho, acompanhado como issues e épicos. O CEO planeja aqui e delega tarefas ao especialista certo.

Conhecimento

Um entendimento destilado das suas fontes do qual os agentes se valem para obter contexto. O Orkestral o constrói automaticamente quando você adiciona uma fonte.
Os workspaces são isolados. Agentes, issues e fontes de um workspace nunca vazam para outro. Isso permite manter projetos separados (um app de cliente, um projeto paralelo, uma ferramenta interna) limpos e apartados.

​
Antes de começar

Você só precisa de duas coisas para concluir o assistente:
  • Um nome para o workspace.
  • Um orquestrador (o CEO): um adaptador de IA e um modelo que vai planejar e delegar.
Uma fonte é opcional no assistente. Você pode adicionar repos e pastas depois. Dito isso, conectar uma fonte logo de início permite que o Orkestral analise seu código e proponha uma equipe inicial, deixando o workspace útil imediatamente.
Se você ainda não conectou nenhum adaptador, configure um primeiro para que a etapa do orquestrador tenha algo para escolher. Adaptadores locais mantêm o planejamento e a execução com custo de API de $0.

​
Crie um workspace passo a passo

Quando você não tem nenhum workspace ativo, o Orkestral mostra a tela de entrada listando seus workspaces disponíveis. Clique em New workspace para abrir o assistente de três etapas.
1

Dê um nome e escolha uma cor

Digite um Name claro (por exemplo, o nome do produto ou do repo). O nome é obrigatório, e o botão Next fica desabilitado até você digitar um.Escolha uma cor de destaque na paleta. O padrão é roxo. A cor escolhida tinge o avatar do workspace e se torna a cor de destaque do app sempre que este workspace estiver ativo. Veja Cor de destaque abaixo para a lista completa.
2

Defina o orquestrador (CEO)

O orquestrador é o agente que lê seus repos, planeja e delega aos especialistas.
  • Agent name: tem como padrão CEO. Renomeie se quiser; deixar em branco volta para CEO.
  • Adapter: o provedor que alimenta o orquestrador. Apenas adaptadores capazes de planejar aparecem aqui (adaptadores apenas de execução são filtrados).
  • Model: o modelo para aquele adaptador. Deixe no padrão, ou escolha um modelo específico na lista.
Trocar o adaptador redefine o modelo para o padrão, então confirme o modelo depois de mudar de provedor.
3

Adicione uma fonte (opcional)

Conecte o código no qual a equipe vai trabalhar. Use as abas para escolher um tipo de fonte e então selecione uma. Você pode pular esta etapa por completo e adicionar fontes depois.
Pesquise seus repositórios pelo nome completo (owner/repo) e clique em um para selecioná-lo. O Orkestral o clona para o workspace.
Nesta etapa você também vê Generate the starting team. Quando uma fonte está selecionada, isso fica ativado por padrão: depois que a fonte estiver pronta, o CEO produz um plano de contratação e propõe especialistas com base no que encontra no código. Sem nenhuma fonte selecionada, a opção fica desabilitada (ainda não há nada para analisar).
4

Conclua

Clique em Create workspace. O Orkestral cria o workspace, alterna para ele imediatamente, cria o orquestrador e (se você adicionou fontes) começa a cloná-las ou indexá-las. A primeira fonte que você adicionou se torna a fonte primária.
Para fontes do GitHub e do Azure, a análise de conhecimento e o plano de contratação rodam depois que o repo termina de clonar, então a equipe proposta pode levar um momento para aparecer. Para uma pasta local, isso acontece na hora.

​
A cor de destaque

Cada workspace carrega sua própria cor de destaque, armazenada como um valor hexadecimal no workspace. A paleta no assistente corresponde aos seis temas de destaque do app:

Roxo

#a78bfa, o destaque padrão.

Azul

#60a5fa

Verde

#34d399

Amarelo

#facc15

Laranja

#fb923c

Vermelho

#f87171
A cor faz duas coisas:
  1. Ela tinge o avatar do workspace em todos os lugares onde o workspace aparece (a tela de entrada, o seletor, os cabeçalhos).
  2. Ela define a cor de destaque do app enquanto aquele workspace estiver ativo. Troque de workspace e a cor de destaque de toda a UI muda para combinar com o que você abriu.
Dê a cada workspace uma cor distinta. Como a cor de destaque do app segue o workspace ativo, a cor se torna um sinal de relance de em qual projeto você está, o que ajuda bastante quando você está fazendo malabarismo com vários.

​
Alterne entre workspaces

Depois que você tem mais de um workspace, você se move entre eles de duas formas.
Quando nenhum workspace está ativo, a tela de entrada lista todos os workspaces com seu avatar, um código curto, suas fontes (a primária recebe um badge) e uma contagem de fontes. Clique em uma linha para abri-la. O Orkestral alterna para aquele workspace, aplica sua cor de destaque e leva você à tela inicial.
Dentro do app, o seletor de workspace mostra o workspace atual. Abra-o para ver a lista completa e escolher outro. Um check marca o ativo. Selecionar um workspace diferente troca o contexto ativo e a cor de destaque junto com ele.
O Orkestral lembra do seu último workspace ativo e o reabre na próxima inicialização, para que você volte exatamente de onde parou.

​
Exclua um workspace

Na tela de entrada, passe o mouse sobre uma linha de workspace e clique no ícone de lixeira para excluí-lo. Uma caixa de diálogo de confirmação explica a ação antes de executá-la.
Excluir um workspace remove seus agentes, issues e links de fontes do Orkestral. Seu código real no disco e seus repos remotos não são tocados, mas o trabalho acompanhado do workspace se vai. Não há como desfazer.

​
O que fazer em seguida

Conecte mais fontes

Adicione repos e pastas para que a equipe veja o projeto inteiro. Escolha qual delas é a primária.

Contrate sua equipe

Revise os especialistas propostos pelo CEO, ou adicione agentes você mesmo.

Converse com o CEO

Descreva o que você quer construir. O orquestrador planeja e delega.

Acompanhe o trabalho como issues

Veja as tarefas fluírem pelo board conforme os agentes as assumem.