KI-Handler Inactivity Memorize

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Suite. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Hinweis: Der Handler ist nur verfügbar, wenn ALBERT | AI Agents verwendet wird.

Der Handler dient der inaktivitätsbasierten Kontextkomprimierung in KI-Chats.

Eine allgemeine Beschreibung von KI-Handlern finden Sie unter ALBERT | AI KI-Handler einrichten.

Eigenschaft	Wert
Anzeigename in der Oberfläche	Inactivity Memorize: Mark prior tool entries as memorized after inactivity
Technischer Handler-Name	`agorum.ai.agents.inactivity-memorize` (Name der Konfiguration: `agorum_ai_agents_inactivity_memorize`)
Standardmäßig aktiv	ja (nur verfügbar, wenn ALBERT \| AI Agents verwendet wird)
Eingriffspunkte (Hooks)	`before`

Wann verwenden

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.

Funktionsweise

Der Handler Inactivity Memorized prüft vor jedem KI-Aufruf, 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.

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

Hinweis: Der Handler verändert nicht die sichtbare History in der Oberfläche. Er setzt lediglich Markierungen, die später bei der Message-Erstellung für die KI berücksichtigt werden.

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)

Einstellungen

Einstellung	Parameter	Standard	Beschreibung
Inaktivitäts-Schwellwert (Sekunden)	`inactivityThresholdSeconds`	300	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.

In einer KI-Voreinstellung verwenden

Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
Wählen Sie den KI-Handler Inactivity Memorize: Mark prior tool entries as memorized after inactivity in der Liste aus.
Speichern Sie die KI-Voreinstellung.
Ergebnis: Nach einer Inaktivitätsphase werden in Chats mit dieser KI-Voreinstellung ältere Tool-bezogene Einträge als memorized markiert, sodass der an die KI gesendete Kontext schlanker gehalten wird.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Keine Besonderheiten bekannt.
Geeignete Kombinationen	Der Handler ist mit anderen Handlern kombinierbar.
Nicht kombinieren mit	Keine Besonderheiten bekannt.