Truncar y resumir resultados de herramientas para ajustarse a un presupuesto de contexto

Objetivo

Evitar que la salida de las herramientas desplace la tarea del contexto del agente, sin perder nada de lo que el agente aún necesita para decidir correctamente.

Requisitos previos

Una capa de herramientas controlada por el host del agente (el código que ejecuta la herramienta y construye el mensaje de resultado), un lugar donde guardar las salidas completas (un directorio temporal) y una idea, para cada herramienta, de qué es lo relevante de su salida: en un ejecutor de pruebas, los fallos; en la lectura de un archivo, el rango solicitado; en una búsqueda, las coincidencias con su ubicación.

Pasos

1. Define un límite por herramienta, en bytes, y uno menor para las herramientas cuya salida casi nunca se lee completa (listados de directorios, logs). Indica el límite en la descripción de la herramienta para que el modelo sepa que los resultados pueden aparecer recortados.
2. Filtra en el origen antes de devolver el resultado: grep con un patrón en lugar de cat, jq sobre JSON, LIMIT en SQL, opciones --quiet, tail sobre logs.
3. Si el resultado sigue superando el límite, conserva el inicio y el final y sustituye la parte central por una única línea marcadora que indique qué se eliminó y dónde está la salida completa: [... 61,204 of 74,880 bytes omitted; full output in /tmp/run/out-17.txt ...]. El final importa porque los resúmenes de errores y los códigos de salida aparecen al final.
4. No cortes nunca dentro de un registro: en JSON, devuelve el esquema, el recuento y los primeros registros como JSON válido; en tablas, conserva filas completas; en diffs, conserva hunks completos.
5. Conserva los errores íntegros; limita stderr por separado y con holgura. Un stack trace truncado cuesta más llamadas de las que ahorra en bytes.
6. Una vez que se ha actuado sobre un resultado, elimínalo o sustitúyelo por un resumen de una línea que conserve los identificadores. La publicación de ingeniería de Anthropic citada califica la eliminación de resultados de herramientas como una de las formas de compactación más seguras y menos intrusivas, y la documentación del proveedor sobre edición de contexto describe la estrategia clear_tool_uses_20250919, que elimina automáticamente los resultados de herramientas más antiguos cuando el contexto supera un umbral configurado y reemplaza cada uno por un texto de marcador.
7. Para las tareas que por naturaleza inundan el contexto (leer muchos archivos, búsquedas largas), delega en un subagente que, según la documentación del agente de programación, hace el trabajo en su propio contexto y devuelve solo el resumen.

Resultado esperado

Resultados de herramientas que ocupan una parte predecible del contexto, con cada recorte señalado y recuperable desde disco, y sin decisiones tomadas sobre una parte invisible de una salida.

Límites y base de verificación

Los límites se fijan por criterio, no por un óptimo medido; la pregunta abierta de esta wiki sobre la proporción de salida de herramientas en ejecuciones reales pide los datos que faltan. Un resumen escrito por un modelo puede omitir lo que era importante; conserva el puntero a la salida completa hasta que termine la tarea.