Mastra führt Memory-Hooks ein, mit denen sich das Gedächtnis von KI-Agenten einsehen und bearbeiten lässt

Mastra hat sein Memory-System um Hooks erweitert. Entwickler können damit Observation- und Reflection-Zyklen beobachten oder verändern, was Observer und Reflector sehen und speichern. Außerdem hat das Unternehmen skillResultRedactor() veröffentlicht, einen vorgefertigten Transform-Hook, der umfangreiche Skill-Dateien aus dem Speicher heraushält.
- Mastras Memory-System unterstützt jetzt Lifecycle-Hooks und Transform-Hooks rund um Observation- und Reflection-Zyklen.
- Lifecycle-Hooks können den Token-Verbrauch pro Zyklus protokollieren oder helfen nachzuvollziehen, warum ein Agent etwas vergessen hat.
- Transform-Hooks können verrauschte Tool-Ausgaben und interne Überlegungen entfernen oder Secrets und PII schwärzen.
- skillResultRedactor() ersetzt den vollständigen Dateiinhalt eines Skills in Tool-Ergebnissen durch einen Platzhalter, während der Agent den Skill weiterhin kennt.
- Das Feature erfordert @mastra/[email protected] oder neuer sowie einen Storage-Adapter.
Zwei Arten von Hooks
Laut Mastra gibt es zwei Arten von Memory-Hooks. Mit Lifecycle-Hooks (onObservationStart, onObservationEnd, onReflectionStart, onReflectionEnd) können Entwickler extern über einen Zyklus berichten. Mastra nennt zwei Beispiele: einen Kostenanstieg erkennen, indem der Token-Verbrauch pro Zyklus protokolliert wird, und nachvollziehen, warum ein Agent etwas vergessen hat.
Mit Transform-Hooks (beforeObservation, afterObservation, beforeReflection, afterReflection) lassen sich die eigentlichen Speicherdaten abfangen und verändern. Laut Mastra kann man damit verrauschte Tool-Ausgaben und interne Überlegungen kürzen oder entfernen sowie Secrets und PII schwärzen.
Vor den Hooks bot Observational Memory nach Angaben von Mastra keine Stellschrauben, um Einfluss auf einen Observation- oder Reflection-Zyklus zu nehmen, abgesehen vom Filtern von Nachrichten, bevor sie den Speicher erreichen. Die Hooks greifen nun direkt im Zyklus selbst ein.
Ein fertiger Redactor für Skills
Zusammen mit den Hooks hat Mastra skillResultRedactor() veröffentlicht, eine vorgefertigte Variante eines Transform-Hooks. Das Problem, das er löst: Nutzt ein Agent einen Skill, enthält das Tool-Ergebnis den gesamten Dateiinhalt des Skills, und der Observer sieht diesen Inhalt jedes Mal. Der Redactor ersetzt den Inhalt durch einen Platzhalter. Laut Mastra erinnert sich der Agent weiterhin an den Skill.
Einrichtung
Entwickler müssen @mastra/memory und einen Storage-Adapter installieren, der für Observational Memory erforderlich ist. Der Adapter lässt sich an der Memory-Instanz oder an der Haupt-Mastra-Instanz einrichten. Das Feature setzt @mastra/[email protected] oder neuer voraus und wurde mit PR #23167 und PR #24220 ergänzt.
In Mastras Beispiel wird ein Trip-Planner-Agent mit einer Memory-Instanz konfiguriert, die LibSQLStore als Speicher und google/gemini-2.5-flash als Modell für Observational Memory nutzt. Die Hooks werden anschließend unter dem Schlüssel hooks in den Optionen für Observational Memory hinzugefügt.
Das Lifecycle-Beispiel protokolliert, wann ein Zyklus beginnt und, wenn er endet, entweder den Fehler oder die Zahl der verbrauchten Input-Tokens. Das Transform-Beispiel definiert einen Schwellenwert von 2000 Zeichen und ersetzt in beforeObservation jedes zu große Tool-Ergebnis durch den Platzhaltertext "[search results omitted from memory]", bevor der Observer es sieht. Weitere Hooks im Beispiel schwärzen Observations vor dem Persistieren, entfernen interne Notizen, bevor der Reflector Text verdichtet, und synchronisieren die Ausgabe nach der Reflection mit einem externen Speicher.
Was das für Entwickler bedeutet
Mastra erklärt, dass Transform-Hooks auf jedem Pfad abgewartet werden: bei manuellen Aufrufen von observe() und reflect(), bei der Turn-synchronen Observation und beim asynchronen Buffering. Gibt ein Hook void zurück, wird die Eingabe unverändert durchgereicht. Ein Hook ändert Daten also nur, wenn er ausdrücklich einen Ersatz zurückgibt.
Für Teams, die Agenten mit persistentem Gedächtnis betreiben, bieten die Hooks die Möglichkeit, die Kosten jedes Memory-Zyklus zu verfolgen, fehlende Erinnerungen zu debuggen und sensible oder überdimensionierte Inhalte aus gespeicherten Observations herauszuhalten. Die vollständigen Konfigurationsoptionen sind in Mastras Dokumentation zu Observational Memory Hooks, zur Skill-Result-Redaction und in der Übersicht zu Observational Memory beschrieben.
Mastra: Introducing Memory Hooks | Mastra Blog


