Aufgaben
Beziehungen pflegen
Erinnerungen lassen sich typisiert miteinander verknüpfen. Eine Beziehung trägt einen festen Typ wie REFERENCES_ENTITY, SUPERSEDES oder FOR_CLIENT und macht den Wissensgraph durchsuchbar. Diese Seite zeigt, wie Sie Beziehungen anlegen, prüfen und entfernen.
Voraussetzungen
- Mindestens zwei vorhandene Erinnerungen
- Für die Wege über KI-Werkzeug und Schnittstelle: deren Memory-IDs und ein API-Token mit Scope write (in jedem Tarif verfügbar, auch Privat)
- Übersicht über die zulässigen Edge-Typen — siehe Referenz Beziehungstypen
Inverse-Beziehung wird automatisch angelegt
OWNS ↔ OWNED_BY). knowmind materialisiert die Inverse beim Anlegen automatisch — Sie müssen die Gegenrichtung nicht separat anlegen. Beim Entfernen wird die Inverse-Beziehung mit entfernt.Schritte
- 1
Weg 1: Im Cockpit
Öffnen Sie die Erinnerung im Cockpit. Auf ihrer Detailseite steht der Abschnitt Beziehungen mit allen vorhandenen Verknüpfungen. Der Knopf + Neue Beziehung anlegen öffnet ein Formular mit drei Feldern:
- Richtung: von dieser Erinnerung zu einer anderen oder von einer anderen zu dieser.
- Beziehungs-Typ: Auswahlliste der zulässigen Typen.
- Ziel-Erinnerung (bei umgekehrter Richtung Quell-Erinnerung): Titel oder Stichwort eintragen. Ab zwei Zeichen sucht knowmind und zeigt Treffer zum Anklicken.
Beziehung anlegen speichert die Verknüpfung. Jede Zeile in der Liste hat einen Knopf Löschen, der die Beziehung wieder entfernt. Dieser Weg ist in jedem Tarif enthalten und läuft allein im Browser.
Ergebnis: Die neue Beziehung steht mit Typ und Ziel in der Liste auf der Detailseite der Erinnerung.
- 2
Weg 2: Verweis im Text beim Speichern
Setzen Sie im Text einer Erinnerung den Titel einer vorhandenen Karte in doppelte eckige Klammern, etwa
[[Serverumzug]], verknüpft knowmind die Erinnerung beim Speichern mit dieser Karte. Gibt es keine Karte mit diesem Titel, entsteht keine Verknüpfung. Andere Verbindungen liest knowmind nicht aus dem Text; die legen Sie über Weg 1 oder Weg 3 an.Ergebnis: Im Wissensgraph erscheint eine Kante vom Typ
LINKS_TOzwischen der Erinnerung und der genannten Karte. - 3
Weg 3: Über den MCP-Client aus der KI heraus
Aus Claude Code, Claude Desktop oder einem anderen MCP-Client sprechen Sie die KI in natürlicher Sprache an. Die KI ruft
knowmind_linkauf:text> Verknüpfe die Erinnerung „Workshop-Memo 12.03.“ mit der Erinnerung > „Müller-Vertrag v3“ über die Beziehung FOR_CLIENT.Die zugehörige Tool-Signatur:
json{ "name": "knowmind_link", "arguments": { "from_id": "memory_workshop_2026_03_12", "to_id": "memory_mueller_vertrag_v3", "rel_type": "FOR_CLIENT" } }Ergebnis: Die KI meldet das Ergebnis. Inverse-Beziehung wird automatisch materialisiert. Beim nächsten Recall mit einer Frage über den Müller-Vertrag wird das Workshop-Memo mitgeliefert.
- 4
Weg 4: Über die REST-API direkt
Für eigene Backend-Integrationen ohne KI-Vermittlung:
bash# Beziehung anlegen curl -X POST https://knowmind.de/api/graph/relations \ -H "Authorization: Bearer kmt_…" \ -H "Content-Type: application/json" \ -d '{ "fromId": "memory_workshop_2026_03_12", "toId": "memory_mueller_vertrag_v3", "relType": "FOR_CLIENT" }' # Beziehungen einer Erinnerung auflisten curl "https://knowmind.de/api/graph/relations?memoryId=memory_mueller_vertrag_v3" \ -H "Authorization: Bearer kmt_…" # Beziehung entfernen curl -X DELETE "https://knowmind.de/api/graph/relations?fromId=memory_workshop_2026_03_12&toId=memory_mueller_vertrag_v3&relType=FOR_CLIENT" \ -H "Authorization: Bearer kmt_…"Ergebnis: HTTP 200 mit Bestätigung. Wird die Beziehung gegen einen unzulässigen Edge-Typ angelegt, antwortet die API mit HTTP 400 und einer SHACL-Constraint-Meldung mit Domain- und Range-Information.
- 5
Beziehung ändern
Eine bestehende Beziehung lässt sich nicht umschreiben. Sie beenden sie und legen die neue an, im Cockpit über den Knopf „Beenden“ und das Formular. Soll über das KI-Werkzeug aus
FOR_CLIENTeinSUPERSEDESwerden:text1. knowmind_unlink from_id=A to_id=B rel_type=FOR_CLIENT 2. knowmind_link from_id=A to_id=B rel_type=SUPERSEDESÄndert sich ein Fakt (Person zieht um, Vertrag wird verlängert), nehmen Sie
knowmind_update_fact. Siehe das Konzept bi-temporale Historie.
Den Graphen ansehen
Im Cockpit zeigt die Seite Wissensgraph den Bestand in Zahlen: wie viele Erinnerungen und Beziehungen es gibt und wie sich die Beziehungen auf die Typen verteilen. So sehen Sie, ob neue Verknüpfungen angekommen sind.
Die Beziehungen einer einzelnen Erinnerung stehen auf ihrer Detailseite im Cockpit; dort legen Sie sie auch an und entfernen sie wieder (Weg 1). Über Ihr KI-Werkzeug fragen Sie mit knowmind_list_relations danach, zum Beispiel: „Womit ist die Erinnerung zum Müller-Vertrag verknüpft?“
Prüfung des Ergebnisses
knowmind_list_relationsmit der Quell-Memory-ID zeigt die neue Beziehung mit Typ und Ziel.- Ein Recall mit Kontext-bezogener Frage liefert beide Erinnerungen verknüpft als Treffer.
- Im Cockpit unter Wissensgraph ist die Zahl der Beziehungen gestiegen.
Fehlerbehebung
| Fehlermeldung | Ursache | Auflösung |
|---|---|---|
| HTTP 400 invalid_edge_type | Der Edge-Typ ist im Schema nicht definiert oder als unzulässige Kombination Domain/Range markiert. | Edge-Typ und erlaubte Domain/Range in der Referenz prüfen. Beispiel: FOR_CLIENT erwartet einen Project- oder Document-Knoten als from_id und einen Client-Knoten als to_id. |
| HTTP 404 memory_not_found | Eine der beiden Memory-IDs existiert nicht im aktiven Arbeitsbereich, oder Tippfehler in der ID. | Memory-IDs über knowmind_recall oder im Cockpit prüfen und kopieren. |
| HTTP 403 Forbidden | Token hat keinen write-Scope. Für link und unlink ist write Pflicht. | Im Cockpit einen neuen Token mit read und write erstellen. |
| knowmind_unlink meldet deleted: 0, obwohl die Beziehung sichtbar war | Edge-Typ war anders herum angelegt (Inverse). Inverse-Edges werden materialisiert, aber der Original-Typ bleibt richtungsbehaftet. | Mit knowmind_list_relations die exakte Edge-Richtung prüfen und unlink mit dieser Richtung aufrufen. |

