knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Aufgaben

Wissensgraph erkunden

Der Wissensgraph macht die typisierten Beziehungen zwischen Ihren Erinnerungen sichtbar. Knoten sind Erinnerungen oder Entitäten (Person, Organisation, Projekt), Kanten sind die Beziehungen. Diese Seite zeigt, wie Sie den Graphen über das eingebettete NeoDash-Dashboard und mit Cypher-Abfragen erkunden.

Zielgruppe
Power-User, die ihre Wissensstruktur visuell prüfen möchten — insbesondere bei Anlage neuer Beziehungen, bei der Mandanten-Übersicht oder zur Vorbereitung einer Recall-Analyse.

Voraussetzungen

  • Eingeloggtes knowmind-Konto
  • Mindestens einige Erinnerungen mit Beziehungen im Wissensspeicher
  • Tarif Business oder höher für erweiterte Cypher-Abfragen im Dashboard
  • Grundkenntnisse in Cypher (Neo4j-Abfragesprache) für eigene Queries

Schritte

  1. 1

    NeoDash-Dashboard öffnen

    Im Cockpit unter Wissensgraph oder direkt:

    text
    https://knowmind.de/dashboard/graph

    Das Dashboard läuft als iframe-eingebettetes NeoDash und verbindet sich beim ersten Aufruf gegen das knowmind-Neo4j. Bei der ersten Sitzung werden Sie nach Datenbank-Credentials gefragt.

    Ergebnis: Die NeoDash-Oberfläche erscheint mit drei vorgefertigten Karten: Mandanten-Übersicht, Personen pro Organisation, jüngste Beziehungen.

  2. 2

    Verbindung einrichten

    Wenn NeoDash beim ersten Start nach Credentials fragt:

    text
    Protocol:  neo4j+s
Hostname:  knowmind.de
Port:      7687
Database:  neo4j
Username:  neo4j
Password:  (im Cockpit unter Profil → Wissensgraph-Zugang)
    Hinweis

    Passwort-Anzeige im Cockpit aktuell auf Anfrage

    Die UI-Anzeige des Read-only-Passworts unter „Profil → Wissensgraph-Zugang" ist in der Backlog. Bis zur Veröffentlichung erhalten Business- und Enterprise-Kundinnen das Passwort auf Anfrage über info@schuebeler-consulting.de.

    Ergebnis: NeoDash stellt eine Bolt-Verbindung über TLS her. Eine Status-Anzeige unten links zeigt „Connected".

  3. 3

    Beispiel: alle Personen im Arbeitsbereich

    Eine neue Karte im NeoDash anlegen, Karten-Typ Table, folgende Cypher-Query eintragen:

    cypher
    MATCH (p:Person)
WHERE p.tenant_id = $tenantId
RETURN p.name AS name, p.role AS rolle, p.email AS email
ORDER BY name
LIMIT 50;

    Die Variable $tenantId wird vom Dashboard automatisch aus Ihrer Session befüllt. Sie müssen sie nicht manuell setzen.

    Ergebnis: Eine Tabelle aller Personen-Knoten in Ihrem Arbeitsbereich.

  4. 4

    Beispiel: Verbindungen einer Organisation visualisieren

    Karten-Typ Graph:

    cypher
    MATCH path = (org:Organization { name: $orgName, tenant_id: $tenantId })
              -[r*1..2]-(n)
WHERE n.tenant_id = $tenantId
RETURN path
LIMIT 100;

    Mit r*1..2 verfolgt die Query Beziehungen bis zwei Hops weit. Setzen Sie $orgName über das Dashboard-Parameter-Feld auf den Namen Ihrer Mandanten-Organisation.

    Ergebnis: Eine interaktive Graph-Visualisierung mit Knoten als Kreisen und Beziehungen als beschrifteten Kanten. Klick auf einen Knoten zeigt seine Eigenschaften.

  5. 5

    Beispiel: Cluster über mehrere Hops finden

    Für eine Cluster-Analyse — welche Personen, Projekte und Dokumente hängen über drei Hops zusammen:

    cypher
    MATCH path = (start:Person { name: $personName, tenant_id: $tenantId })
              -[*1..3]-(n)
WHERE n.tenant_id = $tenantId
WITH n, count(path) AS pfade
RETURN labels(n)[0] AS typ, n.name AS name, pfade
ORDER BY pfade DESC
LIMIT 25;

    Ergebnis: Eine Rangliste der über drei Hops verbundenen Knoten, sortiert nach Pfad-Anzahl. Zeigt das engere Umfeld einer Person.

  6. 6

    Karten speichern und teilen

    NeoDash speichert Dashboards in Neo4j selbst. Zum Speichern oben rechts Save, ein Dashboard-Name (etwa Mandanten-Übersicht) eingeben. Andere Power-User Ihres Arbeitsbereichs sehen das Dashboard nach Reload.

    Ergebnis: Das Dashboard erscheint unter Saved Dashboards und ist für alle Mitglieder Ihres Arbeitsbereichs verfügbar — keine separaten Berechtigungen nötig.

Prüfung des Ergebnisses

  • Die NeoDash-Status-Anzeige zeigt „Connected" gegen knowmind.de:7687.
  • Eine Beispiel-Query mit MATCH (n) RETURN count(n) liefert die erwartete Knoten-Anzahl Ihres Arbeitsbereichs.
  • Ein CREATE (:Test)-Versuch wird mit einer Fehlermeldung abgewiesen (Read-only-User). Das ist gewünschtes Verhalten.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
NeoDash-iframe lädt nichtBrowser-Extension blockiert WebSocket-Verbindungen zu :7687, oder Unternehmens-Proxy lässt Bolt-Protokoll nicht durch.Im Browser-Privacy-Modus (Inkognito) testen. Wenn das funktioniert, eine Browser-Extension blockiert. Im Unternehmens-Netz IT bitten, knowmind.de:7687 für ausgehende WebSocket-Verbindungen freizugeben.
Cypher-Query meldet Neo.ClientError.Security.ForbiddenSchreibender Cypher-Befehl (CREATE, MERGE, DELETE, SET) wurde versucht — Read-only-User lässt das nicht zu.Schreibende Operationen über MCP-Tools, REST-API oder den Beziehungs-Editor durchführen. Siehe Aufgabe „Beziehungen pflegen".
Query liefert leere Ergebnis-Liste, obwohl Daten vorhanden sindtenant_id-Filter fehlt in der Query. Ohne den Filter sieht der Read-only-User trotzdem nichts (RLS auf Datenbankebene), die Query schlägt aber stiller fehl.Jede Query mit WHERE n.tenant_id = $tenantId ergänzen. Das Dashboard befüllt $tenantId automatisch.

Weiterführend