Startseite / Dokumentation / Kontextverwaltung

Kontextverwaltung

Warum die Kosten langer Sitzungen nichtlinear steigen und welche Muster den Verlauf begrenzen.

Die API ist zustandslos. Bei jedem Gesprächsschritt wird die gesamte Unterhaltung erneut gesendet, sodass die Anzahl der Eingabe-Tokens mit dem Gesprächsverlauf wächst — und damit bei jedem weiteren Aufruf auch die Kosten.

Die Struktur des Problems

Eine Unterhaltung mit N Gesprächsschritten, die jeweils ungefähr T Tokens hinzufügen, verursacht insgesamt Eingabe-Tokens in der Größenordnung von N²T/2 statt NT. Eine Verdopplung der Sitzungslänge vervierfacht ungefähr die Kosten für die Eingabe. Deshalb kann ein Agent, der zehn Minuten lang günstig wirkte, nach einer Stunde beunruhigend teuer sein.

Vier bewährte Muster

MusterVorgehenNachteil
Gleitendes FensterDie letzten K Gesprächsschritte behalten, den Rest verwerfenFrüher Kontext geht vollständig verloren
Fortlaufende ZusammenfassungÄltere Gesprächsschritte regelmäßig durch eine vom Modell verfasste Zusammenfassung ersetzenErfordert einen zusätzlichen Aufruf; bewahrt das Wesentliche
Neue Sitzung pro AufgabeBei einem Themenwechsel neu beginnenKostenlos und in der Regel die richtige Wahl
AuslagernDen Zustand in Dateien oder einer Datenbank speichern und nur laden, was der aktuelle Schritt benötigtGrößter Aufwand, bestes Ergebnis

Ältere Gesprächsschritte zusammenfassen

def compact(history, keep=6):
    class="s">""class="s">"Replace everything but the last `keep` turns with one summary turn."class="s">""
    if len(history) <= keep:
        return history
    old, recent = history[:-keep], history[-keep:]
    summary = summarise(old)          class=class="s">"c"># one cheap Haiku call
    return [{class="s">"role": class="s">"user", class="s">"content": fclass="s">"Summary of earlier discussion: {summary}"}] + recent

Führen Sie die Zusammenfassung mit einem kostengünstigen Modell aus. Es handelt sich um eine Komprimierungsaufgabe, nicht um eine Denkaufgabe.

Tool-Ergebnisse sind meist die Ursache

Bei agentischen Tools ist eine neue Sitzung für jede unabhängige Aufgabe die kostengünstigste verfügbare Optimierung. In Claude Code ist das /clear.