Frameworks de Agentes Criam Fluxos de Trabalho. Produção Necessita de Recibos de Execução.
Todos estão comparando frameworks de agentes: LangGraph, CrewAI, AutoGen, OpenAI Agents SDK, Claude Code, Codex, roteadores MCP, harnesses personalizados.
Essa comparação é importante, mas perde a camada que começa a causar problemas assim que a demonstração funciona.
O framework cria o fluxo de trabalho. Ele não responde automaticamente:
- o que está instalado e em execução localmente?
- quais ferramentas, servidores MCP, habilidades e provedores estão montados?
- qual repositório, arquivos ou estado do espaço de trabalho estavam em escopo?
- o que o agente mudou?
- quais ações criaram efeitos colaterais?
- quais ações exigiram aprovação, aviso, redação, bloqueio ou revisão?
- que evidências vieram de testes, avaliações, rastros ou verificações de navegador?
- o que pode ser refeito, retomado, revertido ou limpo com segurança?
Essa é a camada que estamos construindo o Armorer: um plano de controle local em torno dos agentes.
A divisão na qual estamos convergindo:
- Armorer: sessões, trabalhos, inventário de ferramentas, configuração, aprovações, registros de execução e recuperação
- Armorer Guard: decisões rápidas em tempo de execução sobre chamadas de ferramentas propostas e transições de saída de modelo/ferramenta
O objetivo não é substituir frameworks de agentes. É tornar os agentes operáveis uma vez que eles existam.
O artefato ao qual continuo voltando é um recibo de execução.
Um recibo de execução de agente útil deve capturar:
- o agente/aplicativo, versão e configuração
- as ferramentas montadas, servidores MCP, habilidades e provedores
- o espaço de trabalho/repositório/arquivos em escopo
- pontos de verificação antes e depois da execução
- chamadas de ferramentas e efeitos colaterais
- decisões de aprovação e revisão
- evidências de teste/avaliação/verificação
- estado de tentativa, retomada, reversão e limpeza
Sem isso, depurar execuções de agentes se torna uma arqueologia de transcrições.
Com isso, operar agentes começa a parecer mais como operar software novamente.
Repositórios:
- Armorer: https://github.com/ArmorerLabs/Armorer
- Armorer Guard: https://github.com/ArmorerLabs/Armorer-Guard
Perguntas para as quais adoraria receber feedback:
- Qual é o recibo de execução mínimo útil para uma sessão de agente?
- Quais eventos de aprovação deveriam se tornar parte da história de primeira classe?
- Onde os metadados de MCP/ferramenta devem parar e a política de tempo de execução começar?
- Que ação de recuperação você gostaria que seu harness de agente expusesse após uma execução ruim?
Empresas brasileiras que adotam frameworks de agentes precisam de um controle eficaz sobre suas operações para evitar problemas de execução. A implementação de recibos de execução pode facilitar a auditoria e a recuperação de processos, aumentando a eficiência operacional.
