Zum Inhalt

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.

Zielgruppe
Alle, die Erinnerungen miteinander verknüpfen wollen: im Cockpit ohne Programmierkenntnisse, über KI-Werkzeug und Schnittstelle für Entwicklerinnen und Entwickler. Wer nur sucht, kommt ohne eigene Beziehungen aus; knowmind legt Referenz-Beziehungen aus Wikilinks im Text selbst an.

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
Hinweis

Inverse-Beziehung wird automatisch angelegt

Jede typisierte Beziehung hat eine festgelegte Inverse-Beziehung (zum Beispiel 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. 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. 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_TO zwischen der Erinnerung und der genannten Karte.

  3. 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_link auf:

    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. 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. 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_CLIENT ein SUPERSEDES werden:

    text
    1. 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_relations mit 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

FehlermeldungUrsacheAuflösung
HTTP 400 invalid_edge_typeDer 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_foundEine 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 ForbiddenToken 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 warEdge-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.

Weiterführend