MCP-Tools: KI-Gedächtnis
Dauerhafte Fakten, die über Sitzungen hinweg erhalten bleiben — persönlich (user) oder team-weit (org). Dieselben Einträge sind im Client unter Einstellungen → Persönlich → KI-Einstellungen → Gedächtnis sichtbar (siehe Handbuch).
search_memory
Gedächtnis durchsuchen — persönliche und geteilte Org-Fakten.
read · followerGedacht für den Anfang einer Aufgabe: Konventionen, Vorlieben und frühere Entscheidungen abrufen, bevor gearbeitet wird.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
query | string (erforderlich) | – | Wonach gesucht wird |
limit | number 1–20 | 8 | Anzahl Treffer |
save_memory
Einen dauerhaften, wiederverwendbaren Fakt speichern.
write · user| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
text | string (max. 500) (erforderlich) | – | Der Fakt, knapp (ca. ein Satz) |
scope | enum user | org | user | user = privat, nur für diese Person. org = für alle in der Organisation sichtbar |
kind | enum preference | decision | reference | convention | context | context | Art des Fakts. Mit scope: "org" nur convention, decision oder reference |
confidence | number 0–1 | – | Optionale Sicherheit |
Nur stabile, wiederverwendbare Fakten speichern — keine flüchtigen Details einer einzelnen Sitzung, keine Zugangsdaten.
{"name":"save_memory",
"arguments":{"scope":"org","kind":"convention",
"text":"Commit-Titel beginnen mit der Item-Nummer (#216.77)."}}Team-Gedächtnis (scope: "org")
Das Team-Gedächtnis liest jede KI der Organisation mit. Hinein gehören nur unproblematische Konventionen, Beschlüsse und feste Referenzen (Standardfarben, Begriffe, Tech-Stack, Abläufe). Nie dorthin: Aussagen über einzelne Personen, vertrauliche Kunden-, Vertrags- oder Finanzdetails und Inhalte aus Meetings, Calls oder Transkripten — aus einem Meeting höchstens ein unproblematischer Beschluss. Im Zweifel vorher fragen oder mit scope: "user" privat speichern.
Der Server erzwingt die Art: ein org-Eintrag mit einem anderen kind als convention, decision oder reference wird abgewiesen. Der Default kind: "context" reicht für org also nicht.
Private Konversation
Schickt der Client den Header x-liza-conversation mit (siehe Kontext-Header) und ist diese Konversation als privat markiert, speichert save_memory nichts — unabhängig von scope.
Abgewiesene Aufrufe
Ein abgewiesener Aufruf ist kein JSON-RPC-Fehler, sondern ein reguläres Ergebnis mit ok: false:
error | Grund |
|---|---|
org_only_for_conventions | scope: "org" mit einem kind außer convention/decision/reference. hint nennt den Weg: privat speichern oder den Nutzer fragen |
conversation_private | Die Konversation aus x-liza-conversation ist privat — nichts daraus wird gespeichert |
text_required | text ist leer |
get_org_overview
Kompakter Überblick über das geteilte Org-Wissen (Konventionen, Standardfarben, Begriffe, Tech-Stack). read · follower
Keine Parameter.
Aufbewahrung
Wie weit das Gedächtnis zurückreicht, hängt vom Tarif der Organisation ab (ai_memory_days): im Free-Plan die letzten 50 Tage, in bezahlten Plänen unbegrenzt. Ältere Einträge werden beim Lesen ausgeblendet.