Wissensbasis

Die Wissensbasis ist eine strukturierte Sammlung von Nodes, die deine Inhalte speichern und organisieren.

Node-Attribute

Jeder Node innerhalb der Wissensbasis besitzt mehrere Attribute, die in einer Tabelle dargestellt werden:

• Titel: Die Hauptüberschrift des Nodes, die im Navigator entweder als nachfolgende Option oder als hervorgehobene Auswahl angezeigt wird.
• Label: Eine Beschreibung des Zwecks des Nodes mit spezifischen Typen:
  • entry: Als Start-Node vorgesehen; es sollte nur einen einzigen entry-Node geben. Dies ist der erste Node, dem Nutzer bei der Interaktion mit dem Navigator begegnen.
  • content: Der Standard-Node-Typ, in dem deine HTML-formatierten Inhalte gespeichert werden.
  • contact: Ein Node, der Nutzern Kontaktoptionen bietet, falls ihre Anfragen durch die präsentierten Inhalte nicht gelöst werden können.
  • tool: Dieser Node-Typ verknüpft mit einem bestehenden Tool. Derzeit werden nur Formular-Tools unterstützt. Du kannst diesen Node mit allen Nodes verbinden, für die ein Formular angezeigt werden soll.
• Text: Der HTML-Inhalt des Nodes, der den Hauptteil der dem Nutzer angezeigten Informationen bildet.
• ID: Ein eindeutiger Bezeichner, der jedem Node zur Referenzierung und Verknüpfung zugewiesen wird.
• Zeitstempel: Protokoll des letzten Änderungsdatums des Nodes.
• Icon-URL: Ein Link zu einem mit dem Node verknüpften SVG-Icon. Dieses Icon wird innerhalb eines Nodes angezeigt, um wichtige Nodes (wie z. B. contact) hervorzuheben.
• Formular: Verknüpfe ein bereits konfiguriertes Formular mit diesem Node. Erfordert, dass der Node vom Typ tool ist.
• Quelle: Quelle des Nodes (URL, default_node oder ein Dateiname).
• Datenquellentyp: Wenn der Node durch eine Datenquelle erstellt wurde, wird hier deren Typ angezeigt.
• Score-Boost: Ein separates, explizites Feld am Node, mit dem du Suchranking-Boosts für einzelne Einträge direkt einsehen und bearbeiten kannst. Höhere Werte steigern die Sichtbarkeit des Nodes in den Such- und Chat-Ergebnissen, wenn Custom Boosting aktiviert ist.
• Benutzerdefinierte Metadaten: Beliebige Metadaten-Dictionaries aus deinen externen Systemen. Wir verwenden das Feld tags innerhalb der benutzerdefinierten Metadaten, um Tags für Suchergebnisse im Frontend anzuzeigen.
• Seiten-Metadaten: Wenn der Node über den Website-Crawler hinzugefügt wurde, übernehmen wir bestimmte Metadatenfelder und deren Werte (URL, Typ, Bilder).
• Qualitätsmetriken: Eine KI-gestützte Qualitätsbewertung des Inhalts des Nodes (siehe unten).

Verwende zur Verwaltung von Inhalten für verschiedene Sprachen die Sprachauswahl (Locale-Selector) oben in der Node-Tabelle. Diese Funktion ermöglicht es dir, Node-Details über verschiedene Sprachen hinweg einzusehen und zu bearbeiten, und erleichtert die mehrsprachige Inhaltsverwaltung erheblich.

Node-Editor

Der Node-Editor ermöglicht die einfache Verwaltung einzelner Nodes. Du kannst Attribute für jedes unterstützte Locale hinzufügen und bearbeiten und so Titel, Text (als HTML), Icon-URLs und Beziehungen zwischen Nodes innerhalb der Wissensbasis aktualisieren.

Der WYSIWYG-HTML-Editor unterstützt zahlreiche Formatierungsoptionen und Elemente:

Textformatierung:

• Überschriften / h1, h2 usw.
• Ausrichtung (links, rechts, zentriert)
• Aufzählungsliste (Bullet List)
• Nummerierte Liste
• Code-Abschnitte

Zusätzliche Elemente:

• Links / <a>
• Bilder / <img>
• Trennlinie (Divider)
• iframe / <iframe>
• Video / <video>
• Audio / <audio>

Neuen Node erstellen

Klicke auf „Node erstellen“, um den Node-Editor zu öffnen. Nach dem Speichern öffnet sich die Kachel mit den Node-Beziehungen.

Node bearbeiten

Wähle die Option „Bearbeiten“ neben dem betreffenden Node in der Tabelle aus, um ihn zu bearbeiten.

Vorgeschlagene & manuelle Fragen

Auf der Node-Detailseite kannst du im Tab Fragevorschläge spezifische Fragen konfigurieren, die Nutzern vorgeschlagen werden, wenn sie diesen Node aufrufen.

• Manuelle Fragen: Du kannst manuell spezifische Fragen hinzufügen, die auf diesem Node als Vorschlags-Pills angezeigt werden sollen.
• KI-Fragevorschläge: Das System kann basierend auf dem Inhalt des Nodes automatisch Fragevorschläge generieren.
• Fragen neu generieren: Verwende den Button „Neu generieren“, um eine neue KI-Generierung für die Fragevorschläge des Nodes auszulösen.
• Cache-Verwaltung: Wenn Fragen gecacht sind, können Administratoren den Cache direkt über die Fragen-Karte invalidieren, um sicherzustellen, dass frische Vorschläge geladen werden.

Content Quality Score

Jeder Node wird automatisch auf seine inhaltliche Qualität hin bewertet. Die Auswertung läuft im Hintergrund, wann immer ein Node erstellt, aktualisiert oder ersetzt wird – sei es über den Node-Editor oder über eine Datenquelle wie den Website-Crawler. Bei frisch bearbeiteten Inhalten kann es daher einen kurzen Moment dauern, bis die Metriken erscheinen. Die Bewertung basiert auf Googles Search Quality Evaluator Guidelines (Page Quality Rating) und liefert folgende Metriken:

• Page Type (informational, commercial, legal, navigational, gated): Der funktionale Zweck der Seite. Beispielsweise ist ein Dokumentationsartikel informational, eine Landingpage commercial und eine Login-Schranke oder Fehlerseite gated.
• Content Score (0–2): Der allgemeine Nutzen des Inhalts für das Retrieval – wie gut er Nutzerfragen beantwortet. Ein Wert von 2 steht für dichten, präzisen und fundierten Inhalt; 1 für eine nützliche, aber knappe oder marketinglastige Seite; 0 für unbrauchbare Inhalte wie Fehlerseiten, Login-Wände oder leere Linksammlungen.
• Content Density (0–1): Der Anteil des lesbaren Textes, der konkrete Fakten, Antworten oder Spezifikationen vermittelt, anstelle von Fülltext, Slogans oder Phrasen.
• Noise Ratio (0–1): Der Anteil des extrahierten Textes, der aus Boilerplate besteht (Navigationsmenüs, Footer-Texte, Cookie-Banner, Linklisten) anstelle von Hauptinhalten. Ein hoher Noise-Ratio-Wert deutet darauf hin, dass der Crawler überwiegend Navigations-Elemente erfasst hat.
• Classified At: Der Zeitstempel der letzten Qualitätsbewertung.

Die Qualitätsmetriken stehen am Node-Objekt über die API (quality_metrics) zur Verfügung, sodass du sie zur Überprüfung deiner Wissensbasis nutzen kannst: Seiten mit niedrigem Content Score oder hoher Noise Ratio sind Kandidaten für erneutes Crawlen, inhaltliche Überarbeitung oder den Ausschluss aus der Wissensbasis.

Node-Beziehungen

Der Bereich „Beziehungen“ im Node-Editor bietet eine Übersicht darüber, wie Nodes miteinander verknüpft sind. Hier kannst du die Priorität und Sichtbarkeit von Nodes im Navigator anpassen, indem du die Attribute weight oder weight_manual bearbeitest, welche den Navigationsfluss und die Inhaltshierarchie beeinflussen.