01. The Autonomy Dilemma: Governance & Security Invariants
Delegar tarefas de engenharia e operações a agentes de IA sem limites determinísticos expõe organizações a riscos severos: vazamento acidental de chaves de API, estouro descontrolado de orçamentos de LLMs e execução inadvertida de comandos destrutivos em ambientes de produção.
O projeto Orquestração de Agentes foi desenvolvido para solucionar essa assimetria por meio de cinco garantias invioláveis construídas no nível da infraestrutura:
- Isolamento Criptográfico de Chaves: Chaves de provedores de IA (Anthropic, OpenAI, Gemini) residem unicamente no cofre do Gateway. O servidor web, o mecanismo de execução e o sandbox nunca têm acesso a nenhuma chave mestra ou de provedor, recusando-se a inicializar caso detectem segredos em seu ambiente.
- Pré-Reserva Estrita de Orçamento: Gastos nunca ultrapassam tetos estabelecidos por espaço de trabalho, por agente e por tarefa individual. Cada chamada de modelo pré-reserva seu custo máximo antes da execução. Se o saldo for insuficiente, a tarefa é congelada e aguarda liberação administrativa.
- Pausas Obrigatórias para Ações Irreversíveis: Ferramentas marcadas pelo desenvolvedor como de alto impacto (ex: exclusão de banco de dados, emissão de ordens, envio de e-mails em massa) suspendem a execução do agente até que um operador humano aprove ou rejeite a operação.
02. Architectural Multi-Service Topology
A plataforma é particionada em processos Rust independentes com permissões SQL granulares no PostgreSQL:
| Serviço | Porta | Responsabilidade de Segurança |
|---|---|---|
| gateway | 8081 | Cofre encriptado de chaves, limites de uso e proxy de despacho para provedores de fronteira. |
| server | 8090 | Gerenciamento de contas, sessões __Host-cookie, RBAC e aplicação de migrações SQL. |
| engine worker | — | Execução de passos dos agentes, mediação de ferramentas e interrupção por aprovação. |
| sandbox | 8095 | Container isolado para execução de scripts Python com limites rígidos de memória, CPU e sem rede. |
| web | 3000 | Interface em Next.js com Content Security Policy estrita (nonce por requisição). |
“O que acontecerá no mundo real é definido pelos engenheiros na especificação da ferramenta, nunca pela alucinação do modelo de linguagem. Princípio do menor privilégio aplicado a cada linha de código.”— Vinicius Pontual, Modelo de Ameaças & Governança
03. Financial Guardrails & Immutable Audit Trail
A governança financeira e a transparência operacional são tratadas como invariantes matemáticas:
// 01: Pré-Alocação de Saldo MáximoDiferente de sistemas que contabilizam tokens após a resposta, o Gateway bloqueia previamente o custo do pior cenário (teto máximo de tokens de saída). Se o modelo devolver menos tokens, a diferença é creditada instantaneamente.
// 02: Triggers de Auditoria Encadeados por HashToda e qualquer mutação no PostgreSQL (criação de usuários, alteração de orçamentos, aprovações, execuções) dispara triggers que gravam em uma tabela append-only. Cada linha computa o hash criptográfico do registro anterior, impossibilitando adulteração retroativa.
// 03: Identificação Nominal de OperadorNenhuma alteração é anônima. Cada aprovação ou alteração de permissão armazena o hash de identidade e a assinatura do operador responsável.
04. Python Sandbox & Provedor Mock para Testes E2E
Para assegurar que agentes não possam explorar o sistema operacional host, ferramentas analíticas de código executam dentro de um micro-sandbox Docker:
--network none, impedindo exfiltração de dados ou conexões com servidores externos de comando e controle.05. Especificações & Comandos Operacionais
Ferramentas de linha de comando e suítes de verificação de segurança:
| Comando CLI | Propósito Operacional |
|---|---|
| server migrate | Aplica migrações SQL e estabelece as senhas das roles de serviço. |
| server create-admin EMAIL "NOME" | Cria o primeiro administrador do workspace (senha via stdin). |
| engine worker | Inicializa o processador de tarefas, mediações de aprovação e cancelamentos. |
| scripts/attack-suite.sh | Valida que todos os cenários documentados em ATTACKS.md permanecem bloqueados. |
docker compose -f compose.dev.yaml up -d && scripts/e2e-stack.sh startbash scripts/attack-suite.sh && cargo test --workspace