Tool result
O que volta depois da ferramenta rodar. É a única visão que o agente tem do mundo, e ela ocupa a janela.
Onde você esbarra nisso
Quando a automação fica cada vez mais lenta ao longo de uma tarefa longa. Ela está carregando o resultado de tudo que já leu.
Conecta com
O que é
Conteúdo do arquivo, saída do comando, linha do banco, ou a mensagem de erro. O harness executa e manda de volta pro contexto.
Duas coisas importam aqui. Primeira: é a única visão do agente. Se o resultado veio truncado ou errado, ele vai raciocinar em cima disso sem desconfiar. Segunda: resultado ocupa janela, e ocupa muito.
O que muda pro teu negócio
É o maior devorador de contexto em qualquer automação de verdade, e quase ninguém olha pra isso.
Uma consulta que devolve quinhentas linhas gastou quinhentas linhas de janela, e vai continuar sendo reenviada em cada requisição seguinte do mesmo turno. Três consultas assim e a sessão fica lenta, cara e confusa.
A engenharia que resolve é chata e eficaz: fazer a ferramenta devolver o que importa, já filtrado, em vez de despejar tudo e deixar o modelo procurar.
Fontes
Skill `claude-api` (cache 2026-06-24): resultados voltam como blocos no contexto, e ferramenta que falhou deve retornar o erro marcado em vez de ser omitida.
AI Coding Dictionary, verbete "Tool result", Matt Pocock. A frase dele de que o resultado é a única visão do agente sobre o ambiente é a chave. Resultado ruim vira raciocínio ruim.