[ AUTONOMOUS SYSTEMS // 03 ]•ZERO-TRUST AGENT RUNTIME•CRYPTOGRAPHIC GOVERNANCE

Orquestração de Agentes: Self-Hosted Human-in-the-Loop Governance

Um espaço de trabalho auto-hospedado projetado para colaboração simbiótica entre humanos e agentes de IA, estabelecendo fronteiras de segurança intransponíveis para custos, segredos e operações críticas.

BY VINICIUS PONTUAL — DISTRIBUTED SYSTEMS & SECURITY ARCHITECT
STATUS: FASES 1-4 CONCLUÍDAS // RUST + POSTGRESQL + DOCKER + NEXT.JS
[ MULTI-SERVICE ZERO-TRUST DEFENSE TOPOLOGY ]LEAST PRIVILEGE INVARIANTS
SERVICE 01GATEWAY VAULT

Cofre de chaves de provedor. Reserva prévia de custos de token.

SERVICE 02CORE SERVER

Controle RBAC, sessões criptográficas e API HTTP para a web.

SERVICE 03ENGINE WORKER

Execução do loop de agente, interrupção de ações irreversíveis.

SERVICE 04PYTHON SANDBOX

Container isolado: sem rede, filesystem read-only, limites de CPU/RAM.

DATABASEHASH-CHAINED LOG

Log de auditoria append-only imutável via triggers SQL.

FIG 1.0: DISTRIBUTED PROCESS ISOLATION BOUNDARIES (GATEWAY, SERVER, ENGINE, SANDBOX, DB)[ SECURITY ARCHITECTURE ]
Key Vault IsolationZero-Leak Gateway
Budget GuardPre-Reserved Caps
Action InvariantHuman Approval
Audit ImmutabilityHash-Chained Log

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çoPortaResponsabilidade de Segurança
gateway8081Cofre encriptado de chaves, limites de uso e proxy de despacho para provedores de fronteira.
server8090Gerenciamento 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.
sandbox8095Container isolado para execução de scripts Python com limites rígidos de memória, CPU e sem rede.
web3000Interface 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:

01 / Isolamento de Rede Zero: O container Python opera com --network none, impedindo exfiltração de dados ou conexões com servidores externos de comando e controle.
02 / Filesystem Read-Only: O sistema de arquivos interno é montado em modo somente-leitura com limites rígidos de RAM, processos simultâneos e timeout por execução.
03 / Provedor Mock E2E: Para validação sem custos de tokens, o ambiente inclui um provedor mock determinístico capaz de simular respostas, loops orçamentários e disparar aprovações interativas para o painel web.

05. Especificações & Comandos Operacionais

Ferramentas de linha de comando e suítes de verificação de segurança:

Comando CLIPropósito Operacional
server migrateAplica 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 workerInicializa o processador de tarefas, mediações de aprovação e cancelamentos.
scripts/attack-suite.shValida que todos os cenários documentados em ATTACKS.md permanecem bloqueados.
TEST STACK E2E: docker compose -f compose.dev.yaml up -d && scripts/e2e-stack.sh start
SUÍTE DE ATAQUES: bash scripts/attack-suite.sh && cargo test --workspace
// ENGINEERING DOSSIERS

Explore More Projects

All Projects →