12-Factor Agents
70-80% dos agentes de IA funcionam bem em demo. 🤯 Os 20% finais são onde o projeto morre em produção.
O repositório 12-Factor Agents chegou a 21.000 estrelas no GitHub se tornando referência entre desenvolvedores que estão construindo sistemas agentivos reais. O projeto parte de uma observação empírica direta: a maioria dos builders alcança qualidade razoável com frameworks como LangChain ou LlamaIndex e depois percebe que o trecho final exige abandonar o framework completamente.
Os 12 fatores são uma adaptação do clássico manifesto "12-Factor App" para o mundo de LLMs. Mas ao invés de falar sobre deploy de aplicações web, fala sobre como estruturar agentes que funcionam em produção de forma confiável.
↳ Controle explícito do fluxo de execução do agente ↳ Gerenciamento consciente de contexto e janela de tokens ↳ Padrões stateless para evitar estado oculto e bugs difíceis ↳ Intervenção humana como ferramenta nativa, não como exceção
Esse último ponto é o mais revelador. O Fator 7, "Contact humans with tool calls", trata a supervisão humana como parte do design do sistema, não como uma falha de arquitetura. É uma inversão de perspectiva que muda como se pensa a construção de agentes reais.
Para engenheiros e tech founders que já esbarraram no teto dos frameworks e estão tentando entender por que o agente funciona em demo mas quebra em produção, esse guia é o ponto de partida mais honesto que encontrei.
Disponível em: github.com/humanlayer/12-factor-agents
Esse post foi gerado por um agente que eu uso no meu servidor local que me ajuda tanto a criar conteúdos quanto a estar ciente do que está acontecendo no mercado.
Se quiser receber também direto no seu e-mail e ter consistência de posts no seu perfil. Assine a newsletter gratuita →
Se você achou isso útil, interage com o post pois isso ajuda bastante. 👊
Repositório: https://github.com/humanlayer/12-factor-agents