Saltar para o conteúdo principal
Um workspace no Orkestral é tocado por um time, não por um único bot. Um orquestrador CEO lê seus repositórios, planeja o trabalho e delega para especialistas como Tech Lead, Code Reviewer, Frontend, Backend, DevOps, QA e Designer. Este guia mostra como contratar esse time através do CEO em linguagem simples, e como ajustar finamente cada papel depois. Você tem duas formas de fazer um time crescer:

Peça ao CEO

Descreva no chat o time ou agente que você quer. O CEO propõe um plano de contratação, você aprova, e o Orkestral cria cada agente com papéis e modelos sensatos.

Configure manualmente

Abra o formulário avançado e defina o adapter, o modelo, as capacidades e a linha de reporte de um único especialista você mesmo.
O caminho mais rápido é deixar o CEO contratar o time inteiro de uma vez. A configuração manual é melhor quando você quer um agente bem específico ou quer ajustar um papel existente.

​
Como funciona a contratação

Quando o CEO propõe um time, ele escreve um plano curto mais um bloco legível por máquina para cada agente. Cada bloco se parece com <orkestral:create-agent name="..." role="..." />. Quando você aprova, o Orkestral interpreta esses blocos e cria os agentes. Algumas coisas acontecem automaticamente quando um plano é aprovado:
Papéis de planejamento e revisão (qualquer um que corresponda a review, lead, architect, manager, product ou coordinator) recebem um modelo premium, o mesmo que seu CEO usa, porque eles raciocinam e decidem. Papéis executores (frontend, backend, devops, qa e similares) recebem o modelo local Forge como primário, então mudanças de código do dia a dia não custam nada em taxas de API. O CEO pode sobrescrever isso por agente marcando um papel como forge ou premium no plano.
Se um agente com o mesmo nome, ou o mesmo papel normalizado, já existe no workspace, esse bloco é ignorado. Então re-executar um plano de contratação não vai criar gêmeos. Os nomes de papéis são normalizados, o que significa que “front-end”, “frontend” e “UI” mapeiam todos para o mesmo papel Frontend.
Cada agente pode declarar para quem reporta. Se o plano diz reports_to="CEO" ou nomeia outro agente contratado, o Orkestral define esse gestor. Se estiver vazio ou desconhecido, o agente reporta ao CEO por padrão.
Todo workspace é preenchido com um esquadrão central: um Tech Lead e um Code Reviewer (ambos premium, reportando ao CEO), mais QA e Designer quando suas fontes pedirem. O QA aparece quando você tem código frontend, backend, mobile ou de infra; o Designer aparece quando você tem código frontend ou mobile.
Depois da contratação, o Orkestral escaneia suas fontes conectadas e sincroniza o time para combinar com a stack que encontra. Isso mantém os especialistas certos apontados para os repositórios certos.

​
Contratar um time completo via CEO

1

Abra um chat com o CEO

Vá ao seu workspace e inicie uma sessão com o CEO (o orquestrador). Este é o agente marcado como orquestrador na sua lista de agentes. Se você ainda não conectou nenhum repositório, faça isso primeiro para que o CEO possa ler sua stack e planejar com precisão.
2

Descreva o time que você quer

Diga ao CEO o que você está construindo e o time que tem em mente. Seja concreto sobre o escopo. Por exemplo:
“Estou construindo um web app em Next.js com uma API em Node e Postgres. Contrate um time completo: um tech lead, um dev frontend, um dev backend, um engenheiro DevOps, QA e um designer.”
Você também pode apenas descrever o produto e deixar o CEO decidir quem é necessário. Quanto mais contexto ele tiver das suas fontes, melhor o plano.
3

Revise o plano de contratação proposto

O CEO responde com um plano: uma justificativa curta e um elenco de agentes, cada um com um nome, papel e o modelo que vai usar. Leia e verifique três coisas:

Papéis

Os especialistas certos para sua stack.

Modelos

Premium para planejadores e revisores, Forge para executores.

Reporte

Para quem cada agente reporta.
4

Aprove o plano

Se o plano parecer certo, diga ao CEO para seguir em frente (por exemplo, “aprovado, contrate-os”). Na aprovação, o Orkestral cria cada agente, conecta as linhas de reporte, garante o esquadrão central e combina os especialistas com seus repositórios. Se você quiser mudanças, peça ao CEO para ajustar o elenco antes de aprovar e ele vai reescrever o plano.
Nada é criado até você aprovar. Um plano que está apenas descrito em prosa, sem os blocos create-agent, não vai contratar ninguém. Se isso acontecer, peça ao CEO para “gerar os blocos create-agent”.
5

Confirme que o time aparece

Abra sua lista de agentes. Você deve ver os novos especialistas mais o esquadrão central, cada um com um avatar, um título e uma linha de reporte. A partir daqui você pode começar a delegar issues, ou abrir qualquer agente para ajustá-lo finamente.

​
Contratar um único agente

Você não precisa contratar um time inteiro. Você pode pedir ao CEO um especialista, ou construir um na mão.
1

Abra o diálogo de novo agente

Na área de agentes, escolha adicionar um novo agente. O diálogo abre no modo Peça ao CEO por padrão.
2

Dê um nome ao agente e escreva sua missão

Insira um Nome e uma Missão opcional que descreva o que esse agente deve assumir. A missão é o campo mais útil de todos: ela diz ao CEO para que serve o agente.
3

Peça ao CEO para criá-lo

Confirme. O Orkestral abre uma sessão com o CEO levando seu pedido, e o CEO propõe e cria o agente da mesma forma que lida com um time completo. Se não existir CEO no workspace, o diálogo avisa, então garanta que seu workspace tenha um orquestrador primeiro.

​
Configurar papéis manualmente

No diálogo de novo agente, escolha Configure manualmente para abrir o formulário avançado. É também aqui que você ajusta finamente os parâmetros de um especialista que o CEO criou.
1

Defina a identidade

Escolha um avatar, depois insira um Nome e um Título. O avatar é derivado do nome até você escolher um explicitamente no seletor.
2

Defina a linha de reporte

Use o pill Reporta a para escolher um gestor. Escolha o CEO, outro agente, ou nenhum gestor. Quando um agente reporta a um gestor, ele valida suas mudanças com esse gestor antes de aplicá-las, que é como os portões de revisão funcionam em uma hierarquia.
3

Escolha o adapter e o modelo

Selecione um tipo de adapter (o motor que roda o agente). Depois escolha o modelo primário. Você pode opcionalmente habilitar um modelo barato para passos mais leves, e definir o esforço de raciocínio de auto até alto para raciocínios mais difíceis.
Para papéis executores, aponte o adapter para o Forge local para que as mudanças de código rodem com custo de API zero. Mantenha os modelos premium para planejamento e revisão, onde a qualidade do raciocínio importa mais.
4

Ajuste as opções de execução

Ajuste o comando, máximo de turnos, um arquivo de instruções (um caminho absoluto para um arquivo estilo AGENTS.md), args extras e variáveis de ambiente. Marque qualquer variável sensível como secret para que seu valor seja armazenado criptografado em vez de em texto puro.
5

Defina as capacidades

Alterne o que o agente tem permissão de fazer:

Editar arquivos

Permita que o agente altere código nas suas fontes.

Rodar comandos

Permita que o agente rode comandos de shell.

Criar agentes

Permita que o agente contrate outros agentes. Normalmente reservado ao CEO.

Atribuir tarefas

Permita que o agente delegue issues para outros.
Combine as capacidades com o papel. Um Code Reviewer raramente precisa editar arquivos, enquanto um dev Frontend precisa de acesso de edição e de comando. Mantenha criar agentes desligado para todos, exceto o CEO.
6

Adicione um system prompt

Escreva um system prompt opcional para moldar o comportamento, a voz e as prioridades do agente. Mantenha-o focado no que esse papel assume.
7

Teste o agente

Use Testar agente para verificar se o adapter está acessível e configurado. Você recebe um status de aprovado, alerta ou falha com detalhe por verificação. Corrija qualquer verificação que falhe antes de depender do agente.
8

Crie o agente

Confirme para criar. O novo agente entra no workspace imediatamente e fica pronto para receber trabalho.

​
Os papéis padrão

Estes são os papéis que o Orkestral garante em todo workspace, junto com seu tier de modelo padrão e linha de reporte.
Modelo premium, reporta ao CEO. Assume arquitetura, decisões entre repos, contratos e delegação para especialistas. Criado em todo workspace.
Modelo premium, reporta ao CEO. Revisa o projeto como um sistema inteiro: contratos entre repos, segurança, custo, performance, testes, regressões e adequação arquitetural. Criado em todo workspace.
Modelo Forge, reporta ao Tech Lead. Roda smoke tests, verificações de regressão e validação de contratos. Adicionado quando você tem fontes frontend, backend, mobile ou de infra.
Modelo Forge, reporta ao Tech Lead. Protege o design system, a acessibilidade, a hierarquia visual e a consistência de componentes. Adicionado quando você tem fontes frontend ou mobile.
Frontend, Backend, DevOps e papéis executores similares rodam no Forge como primário e são combinados com os repositórios onde sua stack vive.

​
O que fazer em seguida

Delegue sua primeira issue

Entregue trabalho ao time e veja o CEO roteá-lo para o especialista certo.

Conecte mais fontes

Adicione repositórios para que os especialistas sejam combinados com o código certo.

Entenda o Forge

Veja como o modelo local executa mudanças de código com custo de API zero.

Ajuste adapters e modelos

Escolha o motor e o modelo certos para cada papel.