Eine Löschung überprüfen
Das forget-Tool bestätigt, dass der Datensatz als inaktiv markiert wurde; ein nachfolgender recall- oder search-Aufruf darf ihn nicht mehr zurückgeben.
search_memory({ query: "<the removed content>", limit: 5 })
// -> the removed entry must be absentÖffentliches MCP-Tool
forget
Zweck
Einen bestimmten Speichereintrag gezielt aus zukünftigen Abrufen entfernen oder bereinigen und einen nachvollziehbaren Löschbeleg hinterlassen.
Wann zu verwenden
- Ein Benutzer weist ausdrücklich an, eine veraltete Tatsache, ein ungültiges Geheimnis oder eine überholte Notiz zu löschen.
- Eine gespeicherte Erinnerung hat sich als sachlich falsch erwiesen und soll nicht mehr in recall-Ergebnissen erscheinen.
- Ein Speichereintrag soll im Soft-Delete-Verfahren deaktiviert oder aus Datenschutzgründen bereinigt werden.
Wann NICHT zu verwenden
- Verwenden Sie es nicht für Massenlöschungen ganzer Datenbanken ohne vorherige Einzelüberprüfung.
- Verwenden Sie es nicht für TODOs; verwenden Sie todos mit action: delete oder confirm_delete_all.
- Verwenden Sie es nicht für Finanztransaktionen; ledger-Einträge erfordern Stornobuchungen zur Revisionssicherheit.
- Verwenden Sie es nicht für Knowledge Base-Dokumente; Knowledge-Revisionen werden über separate Versions-APIs archiviert.
- Verwenden Sie es nicht ohne Angabe einer konkreten memory_id oder eines eindeutigen Ziels.
Erforderlicher Scope
- memory:write ist für die Löschoberfläche erforderlich.
- Der Aufrufer muss die Eigentümerrechte für den Zielspeicher besitzen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
memory_id | string | Eindeutige ID der zu entfernenden Erinnerung (z. B. mem_42). |
target | string | Alternatives Ziel oder Pfad zur Identifikation der Erinnerung, falls memory_id nicht direkt vorliegt. |
mode | string · Standard: soft | Löschmodus: soft_delete (inaktivieren, Standard) oder redact (Inhalt überschreiben/bereinigen). |
reason | string | Optionaler Revisionsgrund für die Protokollierung des Löschvorgangs. |
Rückgabeschema
Eine strukturierte Bestätigung mit dem Status der Löschung, der betroffenen memory_id, dem gewählten Modus und dem Auditnachweis. Zukünftige Abrufe ignorieren den Datensatz.
Beispiele
forget({
target: "memory-id-from-recall",
mode: "soft",
reason: "User requested removal"
})Fehler
- 401/403: Das MCP-Token fehlt oder gewährt nicht memory:write.
- 404: Die angegebene memory_id existiert nicht oder wurde bereits dauerhaft entfernt.
- Validierungsfehler: Ungültiger Löschmodus oder fehlender Bezeichner.
- Autorisierungsfehler: Keine Berechtigung zum Modifizieren der Zielerinnerung.
- Sicherheitskonflikt: Versuch, schreibgeschützte Systemeinträge zu löschen.
Zugehörige Tools
- search_memory — Die exakte memory_id vor dem Löschen ermitteln.
- remember — Eine korrigierte Fassung eines bereinigten Fakts speichern.
- todos — Aufgabenstatus verwalten statt Speichereinträge zu löschen.
- ledger — Finanzielle Aufzeichnungen revisionssicher korrigieren.