Um livro de código aberto defende que a parte mais importante de um agente de IA não é o modelo. É o programa que o envolve. O Harness Engineering 101 chegou à Versão 1.0 em setembro de 2026, e constrói seu argumento ao longo de 16 capítulos, desenvolvendo um agente de brinquedo com cerca de 300 linhas de Python puro à medida que avança.

O que é Harness Engineering?

O autor, Isuru Wijesiri, parte de um fato básico sobre o funcionamento desses sistemas. Uma API de LLM é stateless, ou seja, não guarda estado. A cada turno, quem a chama envia a conversa inteira como um array JSON e recebe texto de volta. O harness é o programa que constrói, mantém e protege esse array. Segundo a série, tudo o que a indústria chama de agentes equivale a um conjunto de remendos sobre esse mesmo ciclo, e cada remendo existe porque algo específico deu errado.

A série usa uma metáfora simples, presente no título. O LLM é o cérebro. O harness é o corpo. Wijesiri afirma que as mesmas ideias sustentam o One Code, um agente de programação de código aberto construído sobre o pi.

Como os capítulos estão organizados

Como os capítulos do Harness Engineering 101 estão organizados?

Os capítulos se dividem em quatro partes. A Parte I, chamada The Wire, cobre o básico: o array JSON, a caixa-preta do próximo token, ferramentas que mapeiam JSON para funções, o ciclo do agente e o cache. A Parte II, Running Long, trata do array sob pressão. Ela aborda o contexto como um orçamento, e não como um saco, além de subagentes, o controle de um ciclo que se desvia no meio de uma tarefa e o trabalho em segundo plano.

A Parte III, The Ecosystem, enfrenta o campo lotado de frameworks. Ela argumenta que todo framework é um invólucro em torno das ideias do primeiro capítulo, e depois examina como expandir o corpo por meio do MCP, de skills, do carregamento adiado e de hooks. Ela termina com depuração, incluindo a ideia de que você não consegue corrigir um prompt que não consegue ver. A Parte IV, Trust, Domains, and Data, trata de reflexos e salvaguardas, de um estudo de caso sobre agentes de programação e da geração aumentada por recuperação, que o autor descreve como um padrão de harness que já existia desde o início.

Cada capítulo segue o mesmo padrão: uma falha nomeada, um remendo mínimo que a corrige e uma descrição do que esse remendo custa. Os títulos dos capítulos tornam as falhas concretas. Um deles começa com um desenvolvedor perguntando: como eu sequer converso com essa coisa? Outro começa quando a janela de contexto se enche. Um posterior abre com o problema de que o ciclo fará algo idiota.

Quatro apêndices independentes tratam de temas avançados, incluindo roteamento de modelos e engenharia de custos, worktrees para agentes paralelos, modo de planejamento para agentes de programação e a infraestrutura de tentativas, limites de taxa e streaming. Um epílogo apresenta uma versão completa e anotada do harness de brinquedo.

Como executar o material e termos de reutilização

O livro foi pensado para ser lido online, onde seus diagramas são renderizados corretamente. O repositório no GitHub contém os arquivos-fonte dos capítulos, o sumário, o harness de brinquedo executável dividido em um arquivo por etapa e os geradores de diagramas. Leitores que quiserem construir o livro localmente podem instalar o mdBook e o mdbook-mermaid. Sem o mdbook-mermaid, os diagramas mermaid inseridos no texto aparecem como código bruto. Os diagramas quantitativos são regenerados com um script em Python que exige Python 3.10 ou superior e matplotlib.

Qual licença se aplica ao Harness Engineering 101?

O licenciamento é dividido. O texto, abrangendo todos os capítulos e apêndices, é licenciado sob a Creative Commons Atribuição-NãoComercial-SemDerivações 4.0. Os leitores podem compartilhá-lo com crédito. Não podem usá-lo comercialmente nem publicar versões modificadas. O código, incluindo os arquivos do harness, os scripts de diagramas e os trechos reproduzidos nos capítulos, é licenciado sob a Licença MIT. Ele pode ser usado livremente com atribuição.

This article was written with the assistance of AI.
News Factory APP - agentic news to boost your SEO & AEO.