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

Os mesmos fatos, outra vibe — Modo slang 😎

O método Clicked

●○○

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.
●○○

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. 😎

Uma ideia rápida — muitas vezes é tudo de que você precisa.

●●○

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.
●●○

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. 😎

Quer mais? Um clique aprofunda.

●●●

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ê.
Deepest level reached.
●●●

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. 😎
Deepest level reached.

Conceito novo? Um exemplo do dia a dia faz clicar — novas analogias quando quiser.

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átis

50 explicações grátis · Sem cartão de crédito