O que diabos é um harness?
A palavra que eu uso todo dia, que ninguém traduz e que quase ninguém explica — contada pelo arreio do cavalo, que é de onde ela veio.
Usei a palavra harness vinte e sete vezes neste site antes de escrever uma única linha explicando o que ela quer dizer, e a culpa disso é de uma pressa bem específica: a de quem passou meses descobrindo uma coisa que mudou o próprio jeito de trabalhar e quer dividir logo, sem parar para apresentar. Você entra pelo meio da conversa que já vinha acontecendo dentro da sua cabeça há semanas, tudo faz um sentido enorme, e faz mesmo — contanto que o leitor também estivesse lá dentro.
Cheguei a montar um glossário justamente para não deixar termo solto por aí, e ainda assim o verbete que faltava era o da palavra que eu mais uso. Empolgação de compartilhar tem dessas: pula o passo zero e vai direto para a parte boa.
Então vamos do começo, que é o cavalo.
O arreio
Harness, em inglês, é arreio: aquele conjunto de tiras, correias e fivelas que se coloca no animal antes de atrelar a carroça. Repare no que o arreio não faz. Ele não deixa o cavalo mais rápido, não aumenta a força dele, não ensina caminho novo. Um cavalo arreado e um cavalo solto no pasto têm exatamente a mesma potência muscular, e qualquer pessoa que já tenha visto um cavalo solto no pasto sabe muito bem no que essa potência costuma dar quando ninguém combinou para onde ir.
O que o arreio faz é transformar força em trabalho. Ele decide onde a tração engata, até onde a cabeça vira, o que acontece quando o bicho se assusta, e principalmente o que não acontece — porque metade do arreio existe para impedir que a carroça atropele o cavalo na descida.
Agora troque o cavalo pelo modelo
Um modelo de linguagem, sozinho, produz texto — e só. Ele não abre arquivo, não roda comando, não lembra de ontem, e principalmente não faz ideia se aquilo que acabou de escrever funcionou ou explodiu, porque ninguém contou pra ele. Tudo o que a gente chama de "agente" é esse modelo mais uma camada em volta dele que resolve as quatro coisas, e essa camada é o harness.
Ela decide, mais ou menos nesta ordem de importância: quais ferramentas o modelo enxerga, o que ele executa sem perguntar, o que sobrevive quando a sessão acaba, e o que dispara sozinho depois de cada alteração — sendo que essa última é a que as pessoas descobrem por último e é quase sempre a que estava faltando.
Nenhuma dessas quatro coisas mora no modelo, e é por isso que trocar de modelo muda o que o agente sabe enquanto trocar de harness muda o que ele consegue fazer com o que sabe.
Por que isso importa mais do que parece
A conversa pública sobre agentes gira quase toda em torno de qual modelo usar, que é a parte da equação sobre a qual você não tem controle nenhum e que muda sozinha a cada dois meses, geralmente numa terça-feira e sem avisar. A parte que é sua, que você projeta e que decide se o erro vai custar dez minutos ou uma tarde inteira restaurando backup, é a de fora.
Um modelo excelente num harness ruim escreve código correto no diretório errado, apaga o arquivo que não devia com a mesma serenidade com que apagaria o certo, repete dez vezes a mesma chamada que já foi bloqueada nove, e encerra a sessão sem que nada do que ele descobriu no caminho sobreviva para a próxima. Um modelo mediano num harness bom erra menos — e quando erra, erra de um jeito que dá para desfazer, que é a única propriedade que realmente importa quando o assunto é software que age no mundo em vez de só opinar sobre ele.
O harness é a parte que você escreve
Nada disso é prompt, aliás, e essa confusão é a mais cara de todas. Prompt é o que você pede. Harness é o que acontece com o pedido depois que ele sai da sua boca: por onde passa, o que é conferido, o que é barrado, o que fica registrado.
A palavra chegou no vocabulário de IA vinda da engenharia de software, onde "test harness" já significava há décadas o aparato que roda o código de outra pessoa em condições controladas — e o sentido é o mesmo do arreio, só que sem o cavalo. Quem escolheu o termo escolheu bem, o que não é sempre o caso nesta área.
O que o arreio ensina
Um arreio mal ajustado machuca o animal e todo mundo percebe rápido. Um arreio folgado demais não segura nada, e isso também aparece na primeira ladeira. Mas existe um terceiro caso, mais chato, que é o arreio apertado no lugar errado: o cavalo anda, a carroça anda, tudo parece funcionar, e o problema só aparece depois de muito quilômetro.
Harness de software tem os três defeitos, na mesma proporção.