Inactivity Memorize

Vollständiger Name: Inactivity Memorize: Mark prior tool entries as memorized after inactivity

Technischer Name: agorum_ai_agents_inactivity_memorize

Was macht der Handler?

Der Handler Inactivity Memorized dient der inaktivitätsbasierten Kontextkomprimierung in KI-Chats. Vor jedem KI-Aufruf prüft er, wie alt der Zeitstempel des letzten History-Eintrags ist. Wenn dieser älter als ein konfigurierter Schwellenwert ist, werden ältere History-Einträge, die Tool-Calls oder Tool-Responses enthalten, als memorized markiert.

Funktionsweise

1. Der Handler ermittelt den Zeitstempel des letzten History-Eintrags.
2. Der Handler vergleicht das Alter des Zeitstempels mit dem Schwellenwert inactivityThresholdSeconds.
3. Ist der Eintrag älter als der Schwellenwert, markiert der Handler alle vorherigen Einträge mit Tool-Calls/-Responses als memorized.
4. Einträge, die bereits markiert sind (memorized), werden übersprungen.
5. Die eigentliche Reduktion/Komprimierung der Tool-Response-Inhalte geschieht auf dem Weg zur KI. 
6. Die History bleibt in der Oberfläche weiterhin vollständig sichtbar.

Fehler-/Skip-Verhalten

Bei leerer History oder fehlendem/ungültigem Zeitstempel wird die Verarbeitung still übersprungen (kein Abbruch, keine Fehlermeldung).

Protokollierung (Logging)

Wenn der Handler aktiv wird, protokolliert er die Aktivität über console.log:

• Start-Hinweis, dass der Handler aktiv wird
• Log pro markiertem Eintrag
• Abschließende Zusammenfassung (wie viele Einträge markiert wurden)

Empfohlener Einsatzzweck

Der Handler eignet sich besonders für längere Chat-Sessions, in denen Tool-Responses (z. B. Suchergebnisse, große Metadatenblöcke) den Kontext stark aufblähen können. Durch das Markieren älterer Tool-bezogener Einträge nach einer Inaktivitätsphase wird der an die KI gesendete Kontext schlanker gehalten, ohne dass die Chat-History in der Oberfläche gekürzt oder „verloren“ wirkt.

Typische Szenarien:

• Benutzer kehrt nach einigen Minuten Pause in einen Chat zurück (Kontext soll „aufgeräumt“ werden).
• Chats mit häufigen Tool-Aufrufen (Suche, Metadaten, Listen) und potenziell großen Responses.
• Performance-Optimierung und Token-Reduktion, ohne die UI-History zu verändern.

Einstellungen

Parameter	Beschreibung
inactivityThresholdSeconds (optional)	Schwellenwert in Sekunden, ab dem der Handler bei Inaktivität aktiv wird. Ist der Zeitstempel des letzten History-Eintrags älter als dieser Wert, werden vorherige Tool-Call-/Tool-Response-Einträge als memorized markiert. Standard: 300

Verwendung in KI-Voreinstellungen

Der Handler kann in KI-Voreinstellungen (Presets) als Handler-Konfiguration Inactivity Memorize zugewiesen werden.Er ist mit anderen Handlern kombinierbar.