TulimoaTulimoaDocs
Docs-Menü

Memory im Gateway

Die Memory-Tools, die jede Gateway-Verbindung kostenlos bekommt: Scopes und Aufbewahrung, automatische ID-Erkennung, Schutzregeln und die Ansicht im Dashboard.

Stand: 12. Sept. 2026

Jeder Agent am Gateway bekommt eine Reihe von Memory-Tools. Das Gateway beantwortet sie selbst, darum funktionieren sie auf jedem Plan und kosten nie Credits. Ziele, Entscheidungen und IDs überleben Kontext-Kürzungen, Session-Neustarts und sogar den Wechsel auf einen anderen Client, weil sie im Gateway liegen und nicht im Kontextfenster des Agents.

Das ist das eigene Gedächtnis des Gateways: Es speichert und ruft ab. Nächtliche Konsolidierung, Morgenbriefing und der Tresor für personenbezogene Daten gehören zu Tulimoa Memory, das dein Agent zusätzlich zum Gateway nutzen kann.

Die Memory-Tools

Alle Memory-Tools liegen im tulimoa-Namespace. Beim Verbinden bringt das Gateway deinem Agent eine Routine bei: recall zu Aufgabenbeginn, remember sobald etwas Dauerhaftes entsteht, set_goal und checkpoint vor mehrstufiger Arbeit, get_pending nach einem Reconnect und recall noch einmal vor dem Abschluss.

tulimoa__recall(topic?, limit?)

Holt zurück, was früher festgehalten wurde: gepinnte Fakten, IDs, Entscheidungen, offene Punkte. topic filtert per Text, limit begrenzt die Anzahl (1 bis 25, Standard 8). Sortiert nach Wichtigkeit, Neuestes zuerst.

tulimoa__remember(text, key?, importance?, durable?, share_with_team?)write

Speichert einen Fakt als kurzen Satz. Ein späteres remember mit demselben key ersetzt ihn, importance gewichtet ihn (0 bis 1, Standard 0.6), durable: true behält ihn über die Session hinaus, share_with_team: true teilt ihn mit deinem Team, falls Sharing für dich aktiv ist.

tulimoa__set_goal(goal)write

Setzt das eine aktive Ziel dieser Session. Wird wieder vorgelegt, wenn der Kontext des Agents gekürzt wird.

tulimoa__checkpoint(goal, plan_steps?, open_questions?)write

Sichert einen Plan vor einer mehrstufigen Aufgabe über mehrere Tools, damit der Agent nach einer Kürzung weitermachen kann.

tulimoa__forget(id | key)write

Entfernt eine Erinnerung über ihre id oder ihren key, sodass recall sie nicht mehr liefert. Endgültig löschst du sie im Tab Erinnerungen im Dashboard, siehe unten.

tulimoa__get_pending(since?)

Spielt nach, was der Agent getrennt oder nach einer Kürzung verpasst haben könnte, zum Beispiel Änderungen der Tool-Liste.

tulimoa__recall_result(cache_key)

Holt den vollen Inhalt eines früheren Tool-Ergebnisses, das durch einen kurzen Dedup-Verweis ersetzt wurde.

Mit write markierte Tools brauchen einen Key oder Login mit write-Scope. Memory lesen geht mit jedem Key.

Scopes und Aufbewahrung

ScopeSo entsteht erAufbewahrung
SessionDer Standard für remember, Ziele, Checkpoints und erkannte IDs.Wird nach 14 Tagen gelöscht, auf jedem Plan.
Kontoremember mit durable: true.Bleibt, bis du es löschst.
Teamremember mit share_with_team: true, falls Sharing für dich aktiv ist.Bleibt bis zur Löschung; sichtbar für Mitglieder, die Team-Memory lesen dürfen.

recall liefert deine Konto- und Team-Einträge plus die Einträge der laufenden Session. Wie Team-Sharing pro Mitglied eingeschaltet wird, steht unter Teams.

Was automatisch passiert

  • Eine Routine in den Server-Anweisungen. Beim Verbinden bekommt der Agent einen kurzen Anweisungsblock, der ihm die Memory-Routine beibringt, damit er die Tools nutzt, ohne dass du danach fragen musst.
  • ID-Erkennung ohne LLM. IDs werden nur aus den strukturierten Argumenten und Ergebnissen von Tool-Calls gelesen, nie aus Freitext: IDs mit Präfix und UUIDs, dazu Muster, die pro Connector bekannt sind. Bis zu 10 pro Call landen in der Session. Das hält Prompt-Injection aus deinem Gedächtnis heraus.
  • Eine sparsame Kontext-Notiz. Das Gateway hängt Ziel, gepinnte Fakten und IDs nur dann an ein Tool-Ergebnis, wenn sich das Gedächtnis geändert hat, der Agent den Faden zu verlieren scheint oder alle 12 Calls, mit 140 bis 300 Tokens. Es verbraucht nie bei jedem Call Tokens.
  • Ergebnis-Dedup. Liefert ein identischer Call dasselbe große Ergebnis noch einmal, bekommt der Agent stattdessen einen kurzen Verweis; tulimoa__recall_result holt den vollen Inhalt, wenn er wirklich gebraucht wird.
  • Sichtbare Injektionen. Jede automatische Kontext-Notiz steht mit Grund unter Nutzung: Heartbeat, Gedächtnis geändert, Desorientierung oder Compaction-Anker.

Schutzregeln

  • Credentials werden nie gespeichert. Sieht ein Text wie ein Geheimnis aus (ein Key, ein Token, ein Passwort), lehnt das Gateway ab und bittet den Agent, stattdessen eine Referenz zu speichern.
  • Befehlsartiger Text kommt in Quarantäne. Eine Erinnerung, die wie ein Befehl klingt, wird gespeichert, aber nie an einen Agent zurückgegeben, weder im recall noch in der Kontext-Notiz. Eine vergiftete Erinnerung kann deinen Agent so nicht steuern.
  • Team-Writes sind doppelt Opt-in. Ein Fakt erreicht das Team nur, wenn der Agent es ausdrücklich will und deine Mitgliedschaft das Schreiben erlaubt. Aus Tools erkannte IDs erreichen das Team nie.

Memory im Dashboard

Der Tab Erinnerungen unter Nutzung listet, was deine Agents gespeichert haben, ohne die automatisch erkannten IDs: editierbar, endgültig löschbar und als JSON herunterladbar. Unter Einstellungen kannst du alle Daten exportieren (DSGVO Art. 20) oder dein Gateway-Memory komplett löschen (Art. 17); eine Löschung erreicht auch laufende Sessions innerhalb von etwa 30 Sekunden.