Clicked Gallery
O que é um agent harness?
Subrayado en un documento técnico real. Explicado por Clicked.
Usado numa frase
Engineering Notes · AI Systems
Most of the gain came from the agent harness, not from swapping in a larger model.
O leitor sublinhou uma palavra na documentação. O Clicked explicou o termo técnico «agent harness» em termos simples:
Explicado em três níveis
●○○
Overview
Um agent harness é o programa embrulhado em volta de um modelo de IA que transforma as respostas do modelo em ações. O modelo em si só produz texto, então quando ele diz para rodar um comando ou abrir um arquivo, o harness é o que roda, devolve o resultado e pergunta ao modelo o que fazer em seguida. Ele também escolhe quais resultados anteriores valem ser mostrados ao modelo de novo, repete os passos que falham e decide quando o trabalho terminou.
●●○
Detail
Peça a um modelo sozinho que conserte um bug e tudo o que você recebe é texto descrevendo um conserto, porque ler e escrever texto é tudo o que um modelo faz. Embrulhe-o num harness e o mesmo pedido se desenrola diferente. O harness envia o pedido, vê a resposta pedindo para abrir um arquivo, abre, manda o conteúdo de volta, aplica a edição que recebe, roda os testes e dá outra volta até eles passarem. Ferramentas de código como o Claude Code e o Cursor funcionam exatamente assim, com o modelo lá dentro fazendo só a leitura e a escrita. Por que não entregar as chaves ao modelo e deixá-lo tocar sozinho? Porque esses trabalhos precisam sair idênticos toda vez, enquanto um modelo escreve a resposta do zero a cada chamada — então código comum faz a execução, o registro e a parada precisamente porque nunca improvisa. É por isso que um modelo pode falhar numa tarefa sozinho e terminá-la dentro de um bom harness, e por que as notas muitas vezes saltam quando só o software em volta mudou. O MCP é confundido com isso: ele é o formato combinado para descrever uma ferramenta, enquanto o harness é o software que faz a chamada.
●●●
Analogy
Um especialista brilhante está numa linha telefônica e não enxerga a sala. Você descreve a situação, ele diz qual gaveta abrir, você abre e lê em voz alta o que tem dentro, ele diz o que mudar, e a coisa gira até o trabalho terminar. O especialista fornece o pensamento e nada mais, enquanto você fornece as mãos, os olhos, a decisão sobre o que vale ler em voz alta e o julgamento sobre quando parar. Nesse arranjo o modelo é a voz no telefone, e o harness é você.
Explicações de IA podem conter erros · Não é aconselhamento profissional
Os mesmos fatos, outra vibe — Modo slang 😎
●○○
Overview
Um agent harness é o código embrulhado em volta de um modelo que transforma as palavras dele em coisas de fato acontecendo. O modelo só sabe digitar, então quando ele diz rode isto ou abra aquilo, o harness é o que vai lá e faz, e depois reporta. Ele também cuida das tentativas repetidas, lembra o que já aconteceu e descobre quando o trabalho de fato terminou. 😎
●●○
Detail
Um modelo não tem mãos. Você pede que ele conserte o seu site quebrado e ele digita um plano lindo — e acaba aí, porque digitar é o repertório completo. O harness é o código parado ao lado que lê o plano, abre o arquivo, cola a mudança, roda o site, vê o site cair, devolve o erro e diz tenta de novo. Essa última parte é o truque inteiro, já que uma rodada de chute é inútil e vinte rodadas com feedback são uma ferramenta que funciona. Por que não entregar as chaves e ir embora? Porque um modelo escreve tudo do zero a cada vez, então pergunte duas vezes e você pode receber duas respostas diferentes — ótimo para ideias, inútil para apertar botões, enquanto código simples faz a coisa idêntica em cada execução. Encaixe um modelo mais chique num harness desleixado e você tem uma coisa esperta se debatendo — e é por isso que equipes vivem trocando de modelo e se perguntando por que nada melhora. E também não é MCP, que é só o formato da tomada para ferramentas, enquanto o harness é quem as pluga. 😎
●●●
Analogy
Um grão-mestre de xadrez vendado joga por meio de um ajudante que não sabe nada de xadrez. Nenhum dos dois vence sozinho aqui, porque o grão-mestre não pode tocar o tabuleiro e o ajudante não sabe escolher um lance, então um fornece o pensamento e o outro fornece as mãos. O grão-mestre canta um lance, o ajudante joga e descreve de volta o que o adversário fez, e a coisa gira. Troque por um ajudante que pega a peça errada e esquece de descrever o tabuleiro, e o gênio perde para um iniciante. 😎
Explicações de IA podem conter erros · Não é aconselhamento profissional
Definição formal — O mesmo termo, explicado da forma habitual
Um agent harness é a camada de software que envolve um modelo de linguagem e converte as suas saídas em ações executadas, compreendendo o ciclo de orquestração, a invocação de ferramentas, a gestão de contexto e memória, o tratamento de erros, as salvaguardas e os critérios de término. O modelo fornece o raciocínio sobre texto; o harness fornece a execução, o estado e o controle, e juntos eles constituem o que se descreve como um agente.
Quer que o Clicked explique termos como «agent harness» direto no seu navegador, até em PDFs?
Adicionar ao Chrome — Grátis50 explicações grátis · Sem cartão de crédito
Mais da galeria
O que são agentes de IA?
IA que age em vez de só responder: o ciclo planejar-fazer-conferir, e por que o ciclo é também o risco.
O que é uma janela de contexto?
Quanto texto uma IA consegue ter em mente de uma vez — e por que conversas longas esquecem o começo.
O que é inferência (em IA)?
O modelo fazendo o trabalho de verdade — e por que a metade barata acaba custando mais.
O que é uma API?
O acordo fixo que deixa dois programas trabalharem juntos sem conhecer o interior um do outro.
O que são benchmarks de IA?
As notas por trás de cada lançamento de IA, o que elas medem — e por que o líder ainda pode decepcionar.
O que é uma camada de abstração?
Simples por cima, complexidade escondida por baixo — e trocável sem quebrar nada.