carregando o terminal…
Cole a API key. Tudo gratis (free tier).
// aba Provedores de IA — conteúdo chega no E3
// aba Telemetria / Uso — conteúdo chega no E4
// aba Segurança — conteúdo chega no E5
Modelos e agentes do mesh.
OrquestrAI é um cockpit de fábrica de software: você descreve o que quer, agentes de IA especializados planejam, constroem e revisam, e nada roda na VPS sem a sua palavra final. Este manual é organizado por tarefa e descreve só o que existe hoje.
Sem escolher nada, o OrquestrAI usa modelo gratuito. Se você escolher um modelo pago, o servidor pede autorização antes de enviar, mostrando o modelo e o custo máximo daquela mensagem. Cancelar não envia nem cobra.
O que foi gasto, por modelo e por projeto, fica em Painel › Telemetria.
MAS no seletor de modo.Enter envia · Shift+Enter quebra linha.
Botão Projetos no cabeçalho. Cada card mostra custo real, docs, DNA, estado da construção e o olho de Preview quando há site.
Botão Objetivos no cabeçalho. Registre o que precisa ficar pronto no projeto e a evidência esperada. O objetivo em aberto aparece no cabeçalho e entra no contexto do Chat e do MAS como critério de aceite; ele não substitui guardas, LAVE nem a sua confirmação. Quando você o valida (atendido ou não), ele sai do contexto.
O objetivo escrito na criação do projeto fica no DNA: é o briefing que os agentes recebem em toda run. Ele não vira sozinho um registro em Objetivos. Se a lista estiver vazia, a tela mostra o objetivo do DNA e o botão Usar o objetivo do DNA, que copia o texto para o formulário; ele só é registrado quando você clica em Salvar objetivo.
A conversa é do projeto ativo: cada projeto tem a sua. Ao trocar de projeto o cockpit abre a conversa daquele projeto; ao voltar, a anterior reaparece. Conversas de antes do isolamento aparecem como antigas · sem projeto, somente leitura. Modo CHAT: uma IA responde direto, com a Base de Conhecimento do projeto no contexto. Escolha o modelo no seletor (filtros Todos/Free, botão Atualizar lê o catálogo vivo dos provedores).
Perguntas sobre o projeto (“o que o app já faz?”, “liste os arquivos”, “tem algum erro?”): o Chat lê o projeto sozinho, só leitura, e responde com o estado real do app. Você não precisa rodar nenhum comando. Alterar algo continua passando pelo BLOCO e pela sua confirmação. Com modelo pago, a leitura só acontece se couber no valor que você autorizou para a mensagem; se não couber, o pedido de leitura aparece como BLOCO, para você executar.
📎 anexa arquivos de texto (até 200 KB) no campo da mensagem. O microfone é um lugar reservado: ditado por voz ainda não existe.
Modo MAS: o Planejador lê o objetivo e propõe quais agentes rodam; o piso Estrategista → Memorialista → Relator nunca é removido. O Revisor entra sempre que há BLOCO executável para revisar; sem bloco ele é dispensado, sem custo. Os outros (Explorador, Auditor, Detetive, Codificador, Validador, Testador, Métrico) entram conforme a tarefa. Agente não convocado aparece como dispensado (não executou, não custou). Erro é o agente falhando; indisponível é o provedor/modelo fora do alcance. Nenhum dos três vira concluído. Os agentes recebem o objetivo ativo do projeto, as ferramentas reais do executor e os blocos que você vetou, com o motivo.
O Relator é a voz oficial no chat; o detalhe técnico fica nos cards e no terminal.
/construir <pedido>: gera uma página nova no projeto ativo (Static HTML). Custo típico: cerca de US$ 0,12 (média dos últimos 30 dias).Comandos no campo de mensagem, que funcionam com o seletor em Chat ou em MAS:
/mas <pedido>, /audita <alvo> e /investiga <alvo> mandam o pedido para os agentes, mesmo com o seletor em Chat./construir <pedido>: página nova (acima)./revert e /revert x_…: desfazer uma execução (seção própria abaixo).O custo real de cada chamada aparece em Painel → Telemetria.
Ao criar um projeto a Fábrica abre sozinha ao lado da grade: agente ativo ao vivo, progresso em unidades reais, custo, duração, executados e pulados. No fim: Abrir Preview (site; a geração costuma levar de 30 segundos a 2 minutos após a run) ou 👁 ABRIR APP (Aplicação Full Stack: a lateral mostra código gerado, build, banco, publicação e Preview, e só diz pronto quando o app está no ar), e → Ir para o projeto. Se a lateral disser consultando o estado…, o servidor não respondeu naquele instante: ela tenta de novo sozinha e não conclui nada até conseguir ler. O custo mostrado é o da run dos agentes; a geração do site é cobrada à parte e aparece em Painel › Telemetria.
Sites de vitrine (loja, padaria, institucional) saem com ilustrações desenhadas pela própria Fábrica — não são fotografias e não representam o produto real. Ferramentas e cadastros saem sem imagem decorativa. Enviar fotos suas para o site ainda não é possível pelo cockpit.
Todo BLOCO passa por 4 passos antes de rodar:
⛔ Vetar (no card, dois toques + motivo): rejeita esta versão do bloco em definitivo. Ela não poderá ser executada e o motivo volta ao próximo plano do MAS. 👍/👎 (grupo opinião): avaliam a qualidade da resposta e contam no score do agente que a produziu. Não executam, não vetam e não liberam nada: um 👎 não é veto. O voto fica gravado na execução daquele bloco (preparada ou executada); sem execução, o cockpit responde sem execução. Ordem do card: ▶ EXECUTAR · 💬 EXPLICAR · ⧉ COPIAR · opinião 👍/👎 · ⛔ VETAR, com o veto afastado de propósito. 💬 EXPLICAR lê e explica o bloco sem executar nada.
Dois terminais (desde 28/09). O terminal do cockpit abre dentro do projeto ativo, somente leitura e sem internet, num container próprio com a identidade do projeto: serve para olhar (ls, cat, grep). Para mudar arquivos, peça um BLOCO no Chat — ele tem intenção, snapshot e /revert. O Root (Painel › Root) é root no servidor, fora de qualquer projeto e sem desfazer: só para administrar a máquina. Os dois exigem o 2FA do terminal (código do aplicativo; o acesso vale 120 s para conectar) além do login, e cada sessão fica na trilha de auditoria. No terminal do projeto, clique ▶ CONECTAR na barra; se a sessão cair, ↻ RECONECTAR pede um código novo. No Root, marque a caixa e clique ▶ ABRIR (2FA); ele não tem Reconectar.
Antes de executar, o sistema lê o bloco e recusa o que não consegue entender com segurança (por exemplo, um caminho montado na hora, um comando guardado numa variável ou uma escrita fora do projeto), dizendo por quê. Peça o bloco com o caminho escrito por extenso.
O que passa por essa leitura roda com uma garantia a mais: o sistema guarda o estado de tudo o que o bloco pode alterar no projeto (conteúdo, permissões e links), fora do alcance do bloco, e depois mede o que mudou de fato — inclusive o que a leitura não previu, que aparece como escrita não prevista. É isso que o /revert desfaz. Se não consegue guardar esse estado (projeto grande demais, hardlink ou arquivo especial), recusa sem executar nada. Arquivos da plataforma (fases, publicação, documentos) não são alterados pelo bloco nem pelo desfazer. Uma execução por vez em cada projeto: enquanto uma roda, a outra é recusada (nada é executado) — execute de novo quando a primeira terminar.
Se uma execução desfaz o que outra, já autorizada, tinha feito, aparece o aviso amarelo ALTERAÇÃO ANTERIOR DESFEITA, dizendo qual foi. Ele só informa e não bloqueia: pode ser exatamente o que você pediu.
/revert no campo do Chat: desfaz a última execução do projeto ativo que ainda tem o que desfazer./revert x_…: desfaz uma execução específica, pelo id que aparece no resultado (serve também para refazer, desfazendo uma reversão).O desfazer também é guardado: o estado de antes dele fica salvo e ele entra na trilha de auditoria com um id próprio. Por isso dá para refazer. Quando o projeto contém algo que não dá para copiar (hardlink, arquivo especial), a confirmação avisa antes que aquele desfazer não poderá ser refeito.
Se um desfazer for interrompido (queda, erro de disco), o projeto fica travado até ele terminar: /revert mostra Concluir a reversão. Se o próprio registro do desfazer estiver danificado, o sistema recusa e explica — aí a correção exige intervenção de quem opera o servidor. Se o estado depois de uma execução não pôde ser medido, a confirmação oferece Restaurar tudo ao estado anterior e diz exatamente o que isso inclui.
O sistema recusa quando não consegue provar que desfazer é seguro. Isso acontece quando o arquivo mudou depois daquela execução (desfazer apagaria esse trabalho) ou quando a execução é antiga demais para ter o registro do estado final. Nesses casos ele explica, não mexe em nada e não pula para outra execução no lugar.
O olho (no cabeçalho e no card) abre o que o projeto produziu, numa origem separada do cockpit: o site, no Site Estático; o app publicado, na Aplicação Full Stack (apagado quando o app não está no ar — ele não finge estar online). O que roda no preview não enxerga a sua sessão. Depois de uma execução que muda o site, recarregue o preview para ver o resultado. Depois de uma execução que mudou o projeto, o chat mostra Ver Preview (abre exatamente a página alterada; com várias, ▾ lista as outras) e Reverter (o mesmo desfazer do /revert, só daquela execução, com confirmação). O olho do card abre sempre a página inicial.
Botão Lições. Os agentes recebem as fichas mais relevantes do projeto em toda chamada (rodapé KB mostra consultas reais e cobertura). Ao fim de cada run o Memorialista pode propor uma lição; ela entra na fila com o projeto e a run de origem e só vira conhecimento quando você aprova. Lição de um projeto não vaza para outro.
Aprovar não é ativar. Com a base no modo governado, os agentes recebem só as lições ATIVAS: depois de aprovar, abra “Estado e decisões” no card, Comprove com evidência e Ative. O resumo no topo da lista diz quantas lições há na base e quantas chegam aos agentes agora.
Botão Elenco. Titulares rodam no pipeline; reservas ficam disponíveis. Usar numa reserva a promove a titular com o modelo escolhido; ela entra no pipeline depois de Treinar (prompt do sistema). Novo cadastra um agente; cadastrar não é promover. O modelo de cada agente mora no card dele. O selo v1.0, v1.1… ao lado do nome é a versão da definição do agente: sobe quando o texto dele muda e é salvo em Cadastrar (o Treinar só sugere; trocar o modelo não muda a versão). A versão anterior fica guardada.
Painel › Telemetria: custo por projeto, por agente e por chamada, com modelo, tokens e latência. Os cards de projeto e as chips do ✨ mostram o mesmo número. Nada é estimado quando o provedor informa o uso real. O resumo (últimos 30 dias, avisos de cobertura e totais) fica sempre à vista; Custos por projeto, por agente e por modelo abrem com um clique.
Login com e-mail/senha + TOTP (sessão de 24 h). O terminal pede um segundo código a cada conexão: escopo e validade diferentes por desenho. O Root é root no servidor; o do cockpit é confinado ao projeto. Painel › Segurança mostra e gerencia o 2FA (ativar, rotacionar, desativar) sem sair do cockpit. Chaves de provedor ficam cifradas no servidor e nunca voltam para a tela.
Provedores (chave, Testar, modelos), Telemetria, Segurança, este Manual, Estado, Lições e Root. O Estado mostra, em Sistema e Produto, saúde, checks, backup, executor, roadmap, entregas e o que falta fechar, e diz quantas entregas e créditos leu para montar a conta.
/revert.