Glossário · Inteligência Artificial
Harness (de IA)
Definição
Harness de IA é a camada de software que envolve um modelo de linguagem e o transforma em agente, controlando o ciclo de trabalho, as chamadas de ferramentas, o contexto, as permissões, a memória e o ambiente de execução, como acontece no Claude Code, no Codex CLI e no modo agente do Cursor.
- Agent harness
- Harness de agente
- Harness de IA
- Estrutura de agente
- Cluster
- Inteligência Artificial
- Classificação
- Tecnologia
- Nível
- Avançado
O que é harness?
Harness é a estrutura de software que fica em volta de um LLM e permite que ele trabalhe como agente. O modelo, sozinho, recebe um texto e devolve outro texto. Quem transforma essa resposta em ação é o harness: ele lê o que o modelo pediu, executa a ferramenta, devolve o resultado e chama o modelo de novo.
O termo ganhou força com os agentes de IA de programação, como Claude Code, Codex CLI e o modo agente do Cursor. Nesses produtos, boa parte da diferença percebida pelo usuário não vem do modelo, e sim de como o harness organiza o trabalho.
Como funciona na prática?
Um harness típico cuida de seis frentes:
- Ciclo: repete pensar, agir e verificar até a tarefa terminar ou precisar de ajuda.
- Ferramentas: oferece ao modelo ações como ler arquivos, buscar na web, rodar comandos ou acessar sistemas, muitas vezes via MCP.
- Contexto: decide o que entra na janela de contexto, resume o histórico longo e descarta o que não serve mais.
- Permissões: define o que o agente faz sozinho e o que exige aprovação humana.
- Memória: guarda instruções e aprendizados entre sessões, em arquivos ou bancos de dados.
- Ambiente isolado: executa comandos em um sandbox, para limitar o estrago de um erro.
Harness vs modelo: qual a diferença?
O modelo é o motor: entende linguagem, raciocina e escreve. O harness é o carro: volante, freio, painel e cinto de segurança. Um motor potente em um carro mal montado anda pouco e com risco. Por isso, comparar agentes só pelo nome do modelo diz pouco sobre o resultado que eles entregam.
Exemplos
- Um agente de programação recebe a tarefa de corrigir um erro, lê o código, roda os testes, ajusta o arquivo e roda os testes de novo antes de entregar.
- Um agente de atendimento consulta o histórico do cliente, mas precisa de aprovação humana para conceder reembolso, regra definida no harness.
- Uma equipe troca o modelo de um agente por outro mais barato e mantém o mesmo harness, com as mesmas ferramentas e regras.
Erros comuns
- Avaliar uma ferramenta só pelo modelo que ela usa.
- Dar ao agente permissões amplas sem sandbox nem guardrails.
- Encher o contexto com tudo o que existe, em vez de selecionar o que importa.
- Ignorar o custo em tokens de ciclos longos.
Por que importa para líderes e empresas?
Modelos mudam a cada poucos meses, e a vantagem de um sobre o outro dura pouco. O harness, por outro lado, carrega as regras, os sistemas e o conhecimento da empresa. Para líderes, a pergunta útil deixa de ser qual modelo usar e passa a ser qual estrutura de trabalho, controle e engenharia de contexto a empresa coloca em volta dele.
Perguntas frequentes
O que significa harness em inteligência artificial?
Harness, em inglês, quer dizer arreio ou estrutura de fixação. Em IA, o termo descreve tudo o que fica em volta do modelo para que ele trabalhe sozinho: o ciclo que repete pensar, agir e verificar, as ferramentas disponíveis, as regras de permissão, a memória e o ambiente onde os comandos rodam.
Por que o mesmo modelo rende diferente em produtos diferentes?
Porque o modelo é só uma parte do sistema. O harness decide quais ferramentas ele pode usar, como o contexto é montado e resumido, quando ele verifica o próprio trabalho e quanto tempo pode seguir sem ajuda. Duas empresas com o mesmo modelo e harnesses diferentes entregam agentes com qualidade, custo e segurança diferentes.
Harness é a mesma coisa que agente de IA?
Não exatamente. O agente é o resultado: um sistema que recebe um objetivo e executa tarefas em várias etapas. O harness é a estrutura que torna isso possível, somada ao modelo. Uma forma simples de pensar é a fórmula agente igual a modelo mais harness, em que cada parte pode ser trocada separadamente.
Empresas precisam construir o próprio harness?
Na maioria dos casos, não. Ferramentas prontas como Claude Code, Codex CLI e Cursor já trazem harnesses maduros, e kits de desenvolvimento permitem adaptar um existente. Construir do zero faz sentido quando o processo tem regras, sistemas ou exigências de segurança muito específicas, e mesmo assim costuma partir de componentes abertos.