Um framework de agentes é uma biblioteca com que você constrói. O harness é outra coisa: todo o código, a configuração e a lógica de execução que não é o modelo. Não são sinônimos, e confundir os dois faz você mexer na alavanca errada. A LangChain resume a relação numa fórmula, Agente = Modelo + Harness. Escolher framework não é engenheirar harness.
O termo que todo mundo troca
Quatro palavras andam juntas e viram sinônimo na conversa: modelo, wrapper, framework e harness. Não são a mesma coisa. O modelo é o LLM cru, prevê o próximo token e mais nada. Um wrapper é cola fina, um script que formata o prompt e chama a API. Um framework é a biblioteca com que você escreve o loop do agente. E o harness é o conjunto inteiro em volta do modelo: regras, ferramentas, memória, gates, verificação. Quando alguém pergunta 'qual framework usar', quase sempre está fazendo a pergunta errada. A decisão que importa é qual harness você vai construir.
A prova está em como as ferramentas se descrevem
Repare em como cada ferramenta se nomeia. A LlamaIndex se chama 'the framework for Context-Augmented LLM Applications'. A CrewAI, 'open-source framework for orchestrating autonomous AI agents'. A AutoGen, 'a framework for building AI agents'. Framework é a categoria delas, e está certo: é biblioteca pra construir. Já a LangChain usa outra palavra pro resultado: chama o create_agent de 'a minimal, highly configurable agent harness' e resume tudo em Agente = Modelo + Harness. A Anthropic segue igual: 'The Claude Agent SDK is a powerful, general-purpose agent harness' (novembro de 2025). Framework é o que você usa; harness é o que você monta.
Modelo, wrapper, framework, harness, agente
| Termo | O que é | Exemplo |
|---|---|---|
| Modelo | O LLM cru. Prevê o próximo token, sem estado, ferramentas ou memória. | gpt-5.2, Claude, Gemini |
| Wrapper | Cola fina em volta de uma chamada de API. Não é engenharia, é um invólucro. | Um script que só formata o prompt e chama a API |
| Framework | A biblioteca com que você escreve o loop do agente. | LangChain, LlamaIndex, CrewAI, AutoGen |
| Harness | Todo o código, a configuração e a lógica de execução que não é o modelo. | Regras, ferramentas, gates, memória e verificação em volta do modelo |
| Agente | O resultado: o modelo somado ao harness rodando em loop. | Agente = Modelo + Harness (fórmula da LangChain) |
O framework é a ferramenta com que você constrói o harness
Nada disso quer dizer que framework é ruim. É a ferramenta com que você constrói o harness, e uma boa biblioteca economiza semanas. O erro não é usar framework. O erro é achar que escolher um resolve o problema. Nicolas Bustamante coloca bem: 'The harness is no longer a wrapper around the model' (Model-Harness-Fit, maio de 2026). Ou seja, o harness deixou de ser cola fina e virou engenharia de verdade. Framework te dá as peças. O harness é o que você faz com elas, e é onde o agente passa ou falha em produção.
Onde a diferença vira trabalho de verdade
Na prática, o harness que quase todo mundo vê primeiro é o de código: Claude Code, Cursor, agentes que leem repositório e rodam teste. É aí que a diferença fica concreta. O framework você importa; o harness você engenheira em volta dele. A camada de código a gente entrega pronta com o capivaOS, o harness open-source sobre o Claude Code. Se você ainda está decidindo qual é qual, comece pela definição em O que é um AI Harness.
Perguntas frequentes
Qual a diferença entre um AI harness e um framework de agentes?▼
Framework é biblioteca pra construir o agente: você importa e escreve o loop com ela (LangChain, LlamaIndex, CrewAI e AutoGen se autodescrevem como frameworks). Harness é o conjunto inteiro em volta do modelo: o código, a configuração e a lógica de execução que não são o modelo. Você constrói o harness usando o framework, não escolhe um no lugar do outro.
O harness é a mesma coisa que um wrapper?▼
Não. Um wrapper é cola fina: um script que formata o prompt e chama a API. O harness é engenharia: regras, ferramentas, memória, gates e verificação projetados em volta do modelo. Nicolas Bustamante resume: 'The harness is no longer a wrapper around the model' (maio de 2026).
O que significa Agente = Modelo + Harness?▼
É a fórmula da LangChain (Vivek Trivedy, março de 2026): o agente é o modelo somado ao harness que roda em volta dele. A LangChain chama o próprio create_agent de 'a minimal, highly configurable agent harness'. A fórmula é da LangChain; a disciplina de projetar o harness, chamada harness engineering, foi nomeada por Mitchell Hashimoto.
Frameworks de agentes são ruins, então?▼
Não. Framework é a ferramenta com que você constrói o harness, e uma boa biblioteca poupa semanas de trabalho. O ponto não é evitar framework, é parar de tratar a escolha do framework como se resolvesse o problema. O trabalho de verdade é engenheirar o harness.
O que conta como parte do harness e não do modelo?▼
Tudo o que não é o LLM: o prompt de sistema e as regras, as ferramentas e permissões, a memória entre sessões, os quality gates, a verificação e a lógica de orquestração do loop. A Anthropic descreve o Claude Agent SDK como 'a powerful, general-purpose agent harness' (novembro de 2025), justamente por incluir toda essa camada.
Devo perguntar 'qual framework' ou 'qual harness'?▼
Comece pela segunda pergunta. Framework é uma decisão de biblioteca, reversível e menor. Qual harness você constrói (quais regras, ferramentas, gates e memória) é a decisão que define se o agente funciona em produção. Escolher framework não é engenheirar harness.
Você escolhe o framework. O harness você engenheira, e é ele que decide se o agente funciona.