Engenharia de Arneses de Agente: a disciplina ausente

Addy Osmani nome o que todo construtor de agentes aprende da maneira mais difícil: o *harness* é um objeto de engenharia, não uma cola.

O fato

Em 12 de julho de 2026, Addy Osmani publicou « Agent Harness Engineering »: o harness (loop, memória, roteamento de ferramentas, tratamento de erros) ao redor de um LLM é um objeto de engenharia de primeira ordem, distinto do modelo e do prompt.

Nossa leitura

Cada equipe que colocou um agente em produção aprendeu da pior forma: a qualidade observada depende menos do modelo do que do harness. Política de retry, contexto que extrapola, arbitragem de ferramentas similares, registro de logs explorável — são escolhas de arquitetura, não detalhes.

Under the hood

Osmani propõe cinco camadas: loop (planejamento/reação/agente), memory (de trabalho, episódica, semântica), tool layer (roteamento, retry, timeout), safety layer (validação, barreiras de orçamento), observability. A disciplina começa quando deixamos de tratar essas camadas como código cola e as versionamos, testamos e evoluímos independentemente do modelo.

Então, o que fazer?

Se você “apenas conecta o Claude às nossas APIs”, está construindo um harness — é melhor saber disso. As equipes que tratam o harness como um componente real (testes, métricas, ownership) vão rapidamente superar aquelas que trocam de modelo na esperança de que ele compense.

A se observar

O surgimento de frameworks “harness-first” além de LangGraph e DSPy, e a emergência do cargo Agent Reliability Engineer nas organizações que implantam agentes em produção.