Respostas de Ferramentas Grandes, Explicadas: Mantenha as Cargas Úteis Acessíveis Sem Sobrecarregar o Contexto

Uma ferramenta pode retornar os dados certos, mas em um formato inadequado para o raciocínio do modelo. O tratamento de respostas grandes separa a posse do payload da necessidade de processar cada byte imediatamente.

1. Dados corretos ainda podem ser operacionalmente hostis

Uma ferramenta MCP pode responder com sucesso e ainda prejudicar a execução. Uma API de repositório pode retornar centenas de pull requests com descrições longas. Uma ferramenta de métricas pode emitir todas as séries temporais. Uma busca em CRM pode anexar históricos aninhados a cada conta. O payload é relevante em princípio, mas o modelo pode precisar apenas de três campos.

Se o resultado completo entra no contexto, várias coisas acontecem simultaneamente: a entrada aumenta, o raciocínio subsequente herda o volume, fatos importantes competem com campos irrelevantes e chamadas de acompanhamento podem levar a execução ao limite do modelo. Pedir menos à ferramenta é preferível quando sua API suporta projeção, paginação ou filtragem. O runtime ainda precisa de um fallback, pois muitas ferramentas não expõem controles adequados.

O tratamento de respostas documentado do TrueForge grava um resultado excessivamente grande em um arquivo de sandbox e coloca uma breve visualização, além do caminho do arquivo, no contexto. O agente mantém o acesso sem ser forçado a processar todo o payload.

2. O limite de resposta única

A primeira regra se aplica a um resultado de ferramenta. Se a resposta estimada exceder o limite configurado por chamada, o TrueForge grava o resultado completo na sandbox. O contexto recebe um aviso, o caminho do arquivo e uma visualização limitada. O limite padrão atual é de 6.000 tokens; a visualização padrão atual contém os primeiros e os últimos 100 caracteres.

A visualização serve para navegação, não como um resumo. Os caracteres de limite podem revelar o tipo de objeto, chaves de nível superior, contagem total ou metadados finais, mas podem omitir os registros exatos de que a tarefa precisa. Um próximo passo competente é inspecionar a estrutura, buscar um alvo ou executar um pequeno parser — não inferir o conteúdo completo a partir da visualização.

3. Chamadas paralelas criam um modo de falha agregado

Os limites por chamada são insuficientes quando um agente utiliza ferramentas simultaneamente. Quatro resultados de 4.000 tokens passam individualmente por uma verificação de 6.000 tokens, mas, juntos, injetam 16.000 tokens em uma única etapa do modelo.

Por isso, o TrueForge documenta um segundo limite para o conteúdo combinado de chamadas de ferramentas retornadas juntas. O padrão atual é de 10.000 tokens. Quando a soma excede esse limite, o sistema descarrega as respostas uma a uma, começando pela maior, até que o conteúdo inline restante fique abaixo do limite.

Essa política de "maior primeiro" preserva mais resultados pequenos inline enquanto remove rapidamente os maiores contribuintes. É uma heurística de contexto, não um julgamento de relevância. A maior resposta pode conter a evidência mais importante; o caminho do arquivo a mantém acessível.

4. Por que o descarregamento requer uma sandbox

O payload completo precisa de uma superfície de execução durável que o agente possa inspecionar. O recurso do TrueForge é habilitado por padrão, mas requer que a sandbox do agente esteja ativada, pois o resultado descarregado é armazenado como um arquivo de sandbox.

A sandbox não é onde todo o loop do agente é executado. A documentação do TrueForge a descreve como um ambiente isolado usado para código, arquivos e operações de shell, provisionado quando necessário. O modelo recebe um caminho e pode usar operações de sandbox para inspecionar ou transformar o arquivo.

Este design oferece uma separação útil: o sistema controla a execução e as credenciais, enquanto a sandbox lida com o processamento do payload. Isso também cria uma questão de ciclo de vida. Se a tarefa, o usuário ou a política de retenção forem sensíveis, as equipes precisam saber por quanto tempo o arquivo persiste, quem pode baixá-lo, qual telemetria o referencia e como a exclusão é propagada.

5. O comportamento de recuperação correto é a inspeção progressiva

Assim que uma resposta for descarregada, o agente deve restringi-la deliberadamente:

1. Inspecione um pequeno prefixo ou infira o esquema.
2. Confirme a estrutura de nível superior esperada e a contagem de registros.
3. Pesquise a entidade ou os campos específicos relevantes para a solicitação.
4. Use código determinístico para filtragem, agrupamento ou junções.
5. Imprima apenas as evidências ou o resumo necessário para a próxima etapa de raciocínio.
6. Mantenha uma referência ao arquivo de origem para depuração, quando a política permitir.

A documentação do TrueForge conecta explicitamente esse padrão ao Modo de Código. Um script pode ler o arquivo descarregado, calcular um resultado e retornar apenas as linhas impressas para o contexto do modelo.

6. Descarregamento, truncamento, sumarização e recuperação são diferentes

‍