Nodes
Nodes sind Memory Objects — dieselben Objects, die du über Schemas erstellst und im Explorer verwaltest. Jedes Memory Object ist automatisch ein Node im Knowledge Graph.
Knowledge Graph
Memory
Advanced
Der Knowledge Graph ist ein Netzwerk aus Memory Objects, die durch typisierte Edges verbunden sind. Er ermöglicht beziehungsbasierte Abfragen, sodass Agents kontextuell relevante Informationen entdecken können, indem sie Verbindungen zwischen Objects traversieren — statt sich nur auf Keyword- oder semantische Suche zu verlassen.
Kernkonzepte
Abschnitt betitelt „Kernkonzepte“Edges
Edges sind typisierte, gerichtete Verbindungen zwischen zwei Objects. Eine Edge drückt eine semantische Beziehung aus wie “referenziert”, “gehört zu” oder “löst”. Jede Edge hat ein Quell-Object, ein Ziel-Object und einen Edge-Typ.
Edge Types
Edge Types sind benannte Kategorien von Beziehungen. Sie definieren das Vokabular der
verfügbaren Verbindungen in deinem Graph (z.B. References, BelongsTo, RelatesTo,
Resolves). Edge Types werden organisationsweit geteilt.
Edges erstellen
Abschnitt betitelt „Edges erstellen“Um zwei Objects mit einer typisierten Beziehung zu verbinden:
-
Identifiziere das Quell-Object (die “Von”-Seite der Beziehung) und das Ziel-Object (die “Nach”-Seite).
-
Wähle einen Edge-Typ, der die Beziehung beschreibt. Verwende nach Möglichkeit bestehende Edge Types, um Konsistenz in deinem Graph zu gewährleisten.
-
Erstelle die Edge. Die Verbindung ist sofort für Graph-Traversierung und Nachbarschaftsabfragen verfügbar.
Edge Types
Abschnitt betitelt „Edge Types“Edge Types definieren das Vokabular der Beziehungen in deinem Knowledge Graph. Sie sind organisationsbezogen, d.h. jede Organisation pflegt ihre eigenen Edge Types, die die verfügbaren Beziehungsarten über alle Knowledge Graph Nodes hinweg festlegen.
Gängige Edge Types sind:
| Edge Type | Beschreibung | Beispiel |
|---|---|---|
References | Ein Object referenziert oder zitiert ein anderes | Ein Dokument referenziert eine Produktspezifikation |
BelongsTo | Ein Object gehört zu einem anderen oder ist Teil davon | Ein FAQ-Eintrag gehört zu einer Kategorie |
RelatesTo | Eine allgemeine Verbindung zwischen Objects | Zwei Troubleshooting-Anleitungen behandeln verwandte Themen |
Resolves | Ein Object liefert eine Lösung für ein anderes | Ein Fix löst ein bekanntes Problem |
DependsOn | Ein Object erfordert ein anderes | Eine Prozedur hängt von einem Voraussetzungsschritt ab |
Contains | Ein Object enthält oder umfasst ein anderes | Ein Produkt-Bundle enthält einzelne Produkte |
Causes | Ein Object verursacht oder löst ein anderes aus | Eine Fehlerbedingung verursacht ein bestimmtes Symptom |
Du kannst benutzerdefinierte Edge Types erstellen, die auf deine Domäne zugeschnitten sind (z.B. Escalates, Supersedes, Implements), um die spezifischen Beziehungen abzubilden, die für deine Organisation wichtig sind. Edge Types können im Admin-Panel erstellt und verwaltet werden.
Die Plattform erstellt außerdem Standard-Edge-Types für gängige Beziehungen zwischen gespiegelten Plattformobjekten (Agents, Tools, Operating Protocols usw.).
Nachbarn auflisten
Abschnitt betitelt „Nachbarn auflisten“Von jedem Object aus kannst du seine Nachbarn auflisten — Objects, die direkt durch eine oder mehrere Edges verbunden sind. Nachbarschaftsabfragen unterstützen:
- Richtungsfilterung — nur ausgehende Edges (dieses Object zeigt auf andere), eingehende Edges (andere zeigen auf dieses Object) oder beides anzeigen.
- Edge-Typ-Filterung — nur Nachbarn anzeigen, die durch bestimmte Edge Types verbunden sind (z.B. nur
References-Edges). - Paginierung — Objects mit vielen Verbindungen effizient handhaben.
Das ist nützlich, um den Kontext eines Objects zu verstehen: Was referenziert es, was referenziert es, und welche anderen Objects befinden sich in seiner Nachbarschaft.
Neighborhood RAG
Abschnitt betitelt „Neighborhood RAG“Neighborhood RAG (Retrieval-Augmented Generation) ist die leistungsfähigste Art, wie Agents den Knowledge Graph nutzen. Es kombiniert Graph-Traversierung mit semantischer Suche, um kontextuell relevante Informationen zu finden.
So funktioniert es:
-
Von einem bekannten Root-Object starten. Der Agent identifiziert einen relevanten Startpunkt — z.B. ein Produkt, nach dem der Nutzer fragt.
-
Den Graph traversieren. Das System folgt ausgehenden Edges vom Root-Object und sammelt alle Objects in der Nachbarschaft (direkte und transitive Verbindungen).
-
Nach semantischer Relevanz ranken. Die gesammelten Nachbarschafts-Objects werden nach semantischer Ähnlichkeit zur aktuellen Abfrage des Agents gerankt.
-
Die relevantesten Ergebnisse zurückgeben. Die am höchsten gerankten Objects aus der Nachbarschaft werden dem Agent als Kontext für die Antwortgenerierung zurückgegeben.
Wie Agents den Graph nutzen
Abschnitt betitelt „Wie Agents den Graph nutzen“Agents interagieren mit dem Knowledge Graph hauptsächlich über das neighborhoodRag-Tool:
- Während eines Gesprächs identifiziert der Agent ein bekanntes Memory Object, das für die Frage des Nutzers relevant ist (z.B. ein bestimmtes Produkt, ein Ticket oder ein Gerät).
- Der Agent ruft
neighborhoodRagmit der ID des Root-Objects und der Abfrage des Nutzers auf. - Das System traversiert den Graph von diesem Root aus, sammelt Nachbarschafts-Objects und rankt sie nach semantischer Relevanz.
- Der Agent erhält die relevantesten verwandten Objects und nutzt sie, um eine fundierte Antwort zu generieren.
So können Agents Fragen wie “Welche Troubleshooting-Schritte gibt es für den LaserJet 500?” beantworten, indem sie vom LaserJet 500 Produkt-Object starten, dessen Edges traversieren und verknüpfte Troubleshooting-Anleitungen finden.
Edges löschen
Abschnitt betitelt „Edges löschen“Edges unterstützen Soft-Delete. Wenn du eine Edge löschst:
- Die Verbindung wird als gelöscht markiert und erscheint standardmäßig nicht mehr in Nachbarschaftsabfragen
- Der Edge-Datensatz wird zu Audit-Zwecken aufbewahrt
- Du kannst eine soft-gelöschte Edge bei Bedarf wiederherstellen
Um gelöschte Edges standardmäßig herauszufiltern, schließen Nachbarschaftsabfragen sie automatisch aus. Übergib includeDeleted: true, um gelöschte Edges neben aktiven anzuzeigen.
Den Graph abfragen
Abschnitt betitelt „Den Graph abfragen“Der Knowledge Graph unterstützt mehrere Abfragestrategien, die kombiniert werden können:
| Strategie | Beschreibung | Am besten für |
|---|---|---|
| Semantische Suche | Objects nach Bedeutung mit natürlichsprachlichen Abfragen finden | Unscharfe, absichtsbasierte Fragen |
| Typfilterung | Ergebnisse auf bestimmte Schema-Typen einschränken | ”Zeige mir alle FAQEntry-Objects” |
| Graph-Traversierung | Edges von einem Start-Object aus abgehen | ”Was hängt mit diesem Produkt zusammen?” |
| Kombiniert | Semantische Suche innerhalb einer Graph-Nachbarschaft | ”Welche Troubleshooting-Schritte betreffen dieses Gerät?” |
Anwendungsfälle
Abschnitt betitelt „Anwendungsfälle“Troubleshooting-Schritte mit Symptomen verknüpfen
Abschnitt betitelt „Troubleshooting-Schritte mit Symptomen verknüpfen“Erstelle Symptom-Objects (z.B. “VPN-Verbindung bricht nach 5 Minuten ab”) und TroubleshootingGuide-Objects (z.B. “VPN Keepalive-Konfiguration”). Verbinde sie mit Resolves-Edges. Wenn ein Nutzer ein Symptom beschreibt, findet der Agent das passende Symptom-Object und traversiert Edges, um Lösungsanleitungen zu entdecken.
Produkte mit Dokumentation verbinden
Abschnitt betitelt „Produkte mit Dokumentation verbinden“Verknüpfe Product-Objects mit ihren zugehörigen Manual-, FAQEntry- und KnownIssue-Objects über References-Edges. Agents können von einem Produkt starten und den Graph ablaufen, um alle zugehörige Dokumentation zu finden.
Tickets mit bekannten Problemen verbinden
Abschnitt betitelt „Tickets mit bekannten Problemen verbinden“Wenn ein Support-Ticket einem bekannten Problem entspricht, verbinde sie mit einer RelatesTo-Edge. Zukünftige Agents, die ähnliche Tickets bearbeiten, können das bekannte Problem und seine Lösung über den Graph entdecken.