The Code Codex
Tema
← Notas / IA

nota · texto21 out 2026 · 1 min

Harness de agentes

Harness (arreio) é o código que envolve o modelo e o transforma em agente. O modelo só recebe texto e devolve texto; o harness decide o que entra, o que fazer com o que sai e quando parar.

Harness

Contexto

prompt, histórico, memória

Modelo

Middlewares

roteamento, guardrails, logs

Ferramentas

bash, APIs, busca

Usuário

Resposta

Harness

Contexto

prompt, histórico, memória

Modelo

Middlewares

roteamento, guardrails, logs

Ferramentas

bash, APIs, busca

Usuário

Resposta

  • Loop: chama o modelo, executa a ferramenta pedida, devolve o resultado e repete até a tarefa terminar.
  • Ferramentas: as ações que o agente pode tomar no mundo.
  • Gestão de contexto: o que cabe na janela, o que é resumido, o que é descartado.
  • Middlewares / hooks: pontos antes e depois de cada etapa para rotear modelos, bloquear ações perigosas, pedir aprovação humana ou registrar o que aconteceu.

O mesmo modelo pode ir muito bem ou muito mal dependendo do harness. Boa parte das decisões dentro dele são perguntas fechadas (“esta ferramenta é perigosa?”, “terminou?”), o que abre espaço para modelos de decisão como o JEV.