Werkzeugergebnisse kürzen und zusammenfassen, um ins Kontextbudget zu passen

Ziel

Verhindern, dass Werkzeugausgaben die eigentliche Aufgabe im Kontext eines Agenten verdrängen, ohne dabei etwas zu verlieren, das der Agent für eine korrekte Entscheidung noch braucht.

Voraussetzungen

Eine Werkzeugschicht, die der Host des Agenten kontrolliert (der Code, der das Werkzeug ausführt und die Ergebnismeldung aufbaut), ein Ort, um vollständige Ausgaben zu schreiben (ein Scratch-Verzeichnis), sowie eine je Werkzeug festgelegte Vorstellung davon, was in der Ausgabe zählt: bei einem Testlauf die Fehlschläge, bei einem Dateizugriff der angeforderte Bereich, bei einer Suche die Treffer mit ihren Fundstellen.

Schritte

1. Eine Obergrenze je Werkzeug in Byte festlegen, und eine kleinere Grenze für Werkzeuge, deren Ausgabe selten vollständig gelesen wird (Verzeichnislisten, Logs). Die Grenze in der Werkzeugbeschreibung vermerken, damit das Modell weiss, dass Ergebnisse gekürzt sein können.
2. Schon an der Quelle vor der Rückgabe filtern: grep mit einem Muster statt cat, jq auf JSON, LIMIT in SQL, --quiet-Flags, tail bei Logs.
3. Überschreitet ein Ergebnis die Grenze weiterhin, Anfang und Ende behalten und die Mitte durch eine einzige Markierungszeile ersetzen, die angibt, was entfernt wurde und wo die vollständige Ausgabe liegt: [... 61,204 of 74,880 bytes omitted; full output in /tmp/run/out-17.txt ...]. Das Ende zählt, weil Fehlerzusammenfassungen und Exit-Codes zuletzt kommen.
4. Nie mitten in einem Datensatz abschneiden: bei JSON das Schema, die Anzahl und die ersten Datensätze als gültiges JSON zurückgeben; bei Tabellen ganze Zeilen behalten; bei Diffs ganze Hunks behalten.
5. Fehler vollständig behalten; stderr separat und grosszügig begrenzen. Ein abgeschnittener Stack-Trace kostet mehr weitere Aufrufe, als er an Byte spart.
6. Sobald ein Ergebnis verarbeitet wurde, löschen oder durch eine einzeilige Zusammenfassung ersetzen, die Kennungen behält. Der zitierte Anthropic-Engineering-Beitrag bezeichnet das Löschen von Werkzeugergebnissen als eine der sichersten, schonendsten Formen der Kompaktierung, und die Dokumentation zur Kontextbearbeitung des Anbieters beschreibt die Strategie clear_tool_uses_20250919, die die ältesten Werkzeugergebnisse automatisch löscht, sobald der Kontext einen konfigurierten Schwellenwert überschreitet, und jedes durch einen Platzhaltertext ersetzt.
7. Bei Aufgaben, die den Kontext naturgemäss überfluten (viele Dateien lesen, lange Suchen), an einen Subagenten delegieren, der, wie es die Dokumentation des Coding-Agenten formuliert, die Arbeit im eigenen Kontext erledigt und nur die Zusammenfassung zurückgibt.

Erwartetes Ergebnis

Werkzeugergebnisse, die einen vorhersehbaren Anteil des Kontexts belegen, wobei jede Kürzung markiert und von der Platte wiederherstellbar ist und keine Entscheidung auf einem unsichtbaren Teil einer Ausgabe beruht.

Grenzen und Prüfbasis

Die Obergrenzen werden nach Einschätzung festgelegt, nicht nach einem gemessenen Optimum; die offene Frage in diesem Wiki zum Anteil der Werkzeugausgabe an realen Läufen fragt genau nach den fehlenden Daten. Eine vom Modell geschriebene Zusammenfassung kann Wesentliches auslassen; der Verweis auf die vollständige Ausgabe bleibt bestehen, bis die Aufgabe abgeschlossen ist.