reflect

Vorschau vor dem Ändern des Speichers anzeigen

Verwenden Sie dry_run=true, um die fünf freigegebenen Reflexionsaktionen, deren Anzahlen und Kandidatendetails zu prüfen, bevor Sie Schreibvorgänge für Zusammenfassung, Beförderung, Ablauf, Zerfall oder Archivierung zulassen.

Öffentliches MCP-Tool

reflect

Zweck

Einen abgegrenzten Dream/Reflection-Wartungsdurchlauf ausführen, der Konsolidierungs- und Lebenszyklusentscheidungen protokolliert und optional ausgewählte Schreibvorgänge anwendet.

Wann zu verwenden

Periodische Speicheroptimierung: Veraltete Arbeitsspeicherinhalte zusammenfassen oder verdichten.
Wichtige Arbeitsergebnisse aus kurzfristigen Sitzungen in dauerhaften Langzeitspeicher überführen (Promote).
Überprüfen, welche Erinnerungen abgelaufen oder archiviert werden können (mit dry_run: true).

Wann NICHT zu verwenden

Führen Sie keine unbegrenzten oder ungeprüften Schreibdurchläufe direkt in Produktivumgebungen aus.
Verwenden Sie es nicht für das manuelle Löschen einzelner bekannter Einträge; nutzen Sie forget.
Verwenden Sie es nicht für Wissensdokumente in Knowledge Bases; diese unterliegen eigener Revisionsverwaltung.
Führen Sie keinen schreibenden Durchlauf ohne vorherige Inspektion via dry_run=true durch.

Erforderlicher Scope

memory:read ist für die Prüfphase erforderlich.
memory:write ist erforderlich, wenn dry_run: false gesetzt ist und Aktionen angewendet werden.
admin:maintenance kann für globale oder mandantenübergreifende Konsolidierungen verlangt werden.

Parameter

Name	Typ	Beschreibung
`actions_csv`	string · Standard: summarize,promote,expire,decay,archive	Kommagetrennte Liste der auszuführenden Aktionen: summarize, promote, decay, expire, archive.
`dry_run`	boolean · Standard: false	Simulationsmodus (Standard: true): Berechnet und meldet alle Aktionen, führt jedoch keine Änderungen aus.
`time_window_hours`	number · Standard: 24.0	Zeitfenster in Stunden zur Eingrenzung der zu analysierenden Erinnerungen.
`since / until`	string · Standard: empty	Optionale ISO-Zeitstempel zur expliziten zeitlichen Eingrenzung des Wartungsdurchlaufs.
`path_filter / owner_filter`	string · Standard: % / authenticated owner	Filterkriterien zur Beschränkung der Konsolidierung auf bestimmte Projektpfade oder Eigentümer.
`bucket / scope / team_id`	string · Standard: % / empty / empty	Bereichs- und Mandantenabgrenzung für den Reflexionsdurchlauf.
`limit`	integer · Standard: 500	Maximale Anzahl von Erinnerungskandidaten, die in einem Durchlauf verarbeitet werden.

Rückgabeschema

Der Kompaktor erstellt einen Bericht mit dry_run, normalisierten Aktionen, Filtern, Zusammenfassungen, Beförderungen, Lebenszyklusdetails, counts.summarized/promoted/expired/decayed/archived und audit_record_ids. Die MCP-Textantwort beginnt mit '### Memory Reflect Report' und zeigt Dry Run, Aktionen, alle fünf Zählerstände, Audit Records und bis zu 20 Audit-IDs an.

Beispiele

Einen vollständigen Wartungsdurchlauf in der Vorschau prüfen

reflect({
  actions_csv: "summarize,promote,expire,decay,archive",
  dry_run: true,
  time_window_hours: 24,
  limit: 500
})

Eine explizit autorisierte Lebenszyklusaktion anwenden

reflect({
  actions_csv: "archive",
  dry_run: false,
  bucket: "personal",
  limit: 100
})

Fehler

401/403: Unzureichende Berechtigungen für Speicherbereiche oder schreibenden Wartungsmodus.
Validierungsfehler: Unbekannte Aktionen in actions_csv oder ungültige Zeitfenstergrenzen.
Sperrkonflikt: Ein anderer Wartungslauf ist für diesen Bereich derzeit bereits aktiv.
Ressourcenlimit: Zu viele Kandidaten für einen einzelnen Batch; schränken Sie time_window_hours oder path_filter ein.

recall_context — Kontext vor dem Auslösen von Konsolidierungsregeln prüfen.
remember — Dauerhafte Zusammenfassungen manuell speichern, wenn automatische Konsolidierung nicht greift.
search_memory — Kandidatenerinnerungen vor der Ausführung von reflect gezielt einsehen.

Quelle: Dream / Reflection