Das Knowledge Base-Widget ermöglicht es Ihren Nutzern, Ihre Wissensdatenbank zu durchsuchen und zu durchsuchen, ohne Ihre Website oder Anwendung zu verlassen. Anstatt einen neuen Tab zu öffnen oder den Support zu kontaktieren, erhalten Nutzer sofortigen Zugriff auf relevante Artikel direkt dort, wo sie sind – was das Ticketaufkommen reduziert und das gesamte Support-Erlebnis verbessert.
Du kannst bis zu 10 Knowledge Base-Widgets in einem Projekt konfigurieren. Allerdings kannst du pro Domain oder Website nur ein Knowledge Base-Widget konfigurieren.
Wann man das Knowledge Base-Widget verwenden sollte
Das Widget ist in jedem Szenario nützlich, in dem Nutzer kontextuelle Hilfe benötigen, ohne die Anwendung verlassen zu müssen:
- Benutzer-Onboarding – Neue Nutzer können die Grundlagen erlernen, wie das Einrichten eines Kontos, das Navigieren der Benutzeroberfläche und das Erledigen gemeinsamer Aufgaben, ohne den Kontext zu wechseln.
- Technischer Support – Nutzer, die auf einen Fehler oder ein Problem stoßen, können direkt in der App nach einer Lösung suchen, anstatt ein Support-Ticket zu eröffnen.
- Feature-Entdeckung – Wenn Sie neue Funktionen veröffentlichen, können Nutzer über das Widget auf relevante Artikel zugreifen, um zu verstehen, was sich geändert hat und wie man es verwendet.
- Individuelle Ressourcenverlinkung – Sie können benutzerdefinierte Links im Widget hinzufügen, um Nutzer auf externe Ressourcen wie herunterladbare Anleitungen, Google Sheets oder andere Supportkanäle zu verweisen.
Bevor du anfängst
- Sie müssen den Zugriff als Projektbesitzer oder Administrator in Document360 haben.
- Um Eddy AI im Widget zu aktivieren, stellen Sie sicher, dass Sie einen aktiven Eddy-AI-Plan und Zugriff auf die Eddy-AI-Einstellungen haben.
Wie man Eddy AI im Knowledge Base-Widget aktiviert
Um die KI-gestützte Hilfssuche im Widget zu aktivieren, führen Sie die folgenden beiden Schritte durch.
Stufe 1: Aktiviere Eddy AI für Widgets in den KI-Einstellungen
- Navigiere zu Einstellungen () in der linken Navigationsleiste des Knowledge Base-Portals.
- Im linken Navigationsfenster, unter AI-Einstellungen, klicke auf Eddy AI-Einstellungen.
- Im Bereich KI-Assistenzsuche wählen Sie das Kästchen KB-Widgets, Chatbots & Erweiterungen aus.
Phase 2: KI-Assistive Suche im Widget aktivieren
- In der linken Navigationsleiste navigieren Sie zum Connections > Knowledge Base-Widget.
- Um ein neues Widget zu erstellen, klicken Sie auf Widget hinzufügen und geben Sie einen Namen ein.
- Um ein bestehendes Widget zu bearbeiten, fahre mit der Maus darüber und klicke auf Bearbeiten ().
- Im Reiter Konfigurieren & Verbinden aktivieren Sie den Schalter KI-Assistive Suche .
.png)
- Klicken Sie auf Speichern.
Beim Einrichten des Widgets stehen drei Inhaltsebenen zur Verfügung: Projekt, Arbeitsbereich und Kategorie. Wenn Sie Kategorie auswählen, wird das Dropdown-Menü Arbeitsbereich nicht in der Widget-Konfiguration angezeigt.
Was Leser mit dem Widget machen können
Sobald das Widget live ist, können Leser es nutzen, um:
- Suche nach Artikeln – Geben Sie ein Schlüsselwort ein, um relevante Artikel zu finden, ohne den aktuellen Bildschirm zu verlassen. Passende Schlüsselwörter werden in den Ergebnissen hervorgehoben.
- Kontaktieren Sie den Support – Verwenden Sie benutzerdefinierte Links, um eine E-Mail-Adresse oder einen Support-Link hinzuzufügen, wodurch die notwendigen Schritte zur Unterstützung reduziert werden.
- Empfohlene Artikel anzeigen — Kontextuelle Artikelvorschläge erscheinen basierend auf der Seite, auf der sich der Leser gerade befindet, und zeigen proaktiv hilfreiche Inhalte.
- Zugreifen Sie auf benutzerdefinierte Links – Lenken Sie Leser zu jeder externen Ressource, wie einem eBook-Download oder einer Tabelle, indem Sie benutzerdefinierte Links verwenden, die im Widget hinzugefügt wurden.
Das Widget öffnet sich in der Standard-Browsersprache des Nutzers. Wenn diese Sprache im Widget nicht verfügbar ist, wird stattdessen die Standardsprache der Wissensdatenbank verwendet.
Widget-Spezifikationen
| Grenze | Detail |
|---|---|
| Maximale Anzahl von Widgets pro Projekt | 10 |
| Widgets pro Domain/Website | 1 |
| Konfigurations-Cache-Aktualisierung | Alle 15 Minuten |
| Private KB-Einbettung | Nicht direkt unterstützt; Nutze das Widget mit JWT für private Wissensdatenbanken |
| Unterstützte Eddy-KI-Sprachen | Englisch (en-US, en-GB), Französisch (fr), Spanisch (es), Deutsch (de), Norwegisch (nein), Niederländisch (nl) |
Konfigurierbare Widget-Einstellungen
Die folgenden Einstellungen sind unter der Widget-Konfiguration verfügbar:
- Installation und Einrichtung – Kopiere und installiere den JavaScript-Code des Widgets
- Benutzerdefiniertes CSS – Wende benutzerdefinierte Stile an, die zum Design deines Produkts passen
- Benutzerdefiniertes JavaScript — Fügen Sie benutzerdefinierte Skripte hinzu, um das Verhalten von Widgets zu erweitern
- URL-Mapping — Zeigen Sie spezifische Artikel oder Kategorielisten basierend auf der Seiten-URL an
Die Autosave-Option ist verfügbar, wenn man zwischen diesen Tabs navigiert.
Das Widget verwendet einen 15-minütigen Cache. Konfigurationsänderungen treten nach dem Cache-Refresh in Kraft.
Best Practices
-
Verwenden Sie pro Domain ein Widget. Das Konfigurieren von mehr als einem Widget in derselben Domäne kann unerwartetes Verhalten verursachen.
-
Scope-Zugang zu Inhalten. Verwenden Sie die Inhaltszugriffseinstellungen , um Widget-Ergebnisse auf einen bestimmten Arbeitsbereich oder eine bestimmte Kategorie zu beschränken, insbesondere wenn das Widget in einem fokussierten Produktbereich eingebettet ist.
-
Beschränke das Widget auf vertrauenswürdige Domains. Füge deine Domain im Bereich Widget-Sicherheit hinzu, um unbefugte Nutzung des Widget-API-Schlüssels zu verhindern.
-
Verwenden Sie URL-Mapping für kontextuelle Vorschläge. Fügen Sie relevante Artikel oder Kategorielisten bestimmten Seiten zu, damit Nutzer Inhalte sehen, die zu ihrer aktuellen Aufgabe passen.
-
Nutze JWT für private Wissensdatenbanken. Wenn Ihre Wissensdatenbank privat oder eingeschränkt ist, konfigurieren Sie die JWT-Authentifizierung im Widget, um nahtlosen Single Sign-on-Zugriff zu ermöglichen.
FAQ
Wie ist das Knowledge Base-Widget für Nutzer nützlich?
Das Widget hilft in drei Hauptszenarien: Onboarding (neue Nutzer können die App kennenlernen, ohne den Kontext zu wechseln), technischer Support (Nutzer suchen nach Lösungen ohne den Support zu kontaktieren) und Feature-Discovery (Nutzer lernen neue Funktionen kennen, sobald diese veröffentlicht werden).
Muss ich das Widget erneut einrichten, wenn ich von einer öffentlichen zu einer privaten Wissensdatenbank wechsle?
Nein, du musst das Widget nicht erneut einrichten. Nutzer müssen sich jedoch anmelden, um Artikel auf der Knowledge Base-Seite einzusehen. Um die Anmeldeanforderung zu umgehen, konfigurieren Sie die JWT-Funktion (JSON Web Token) in den Widget-Einstellungen.
Wie kann ich eine private Wissensdatenbank in eine andere Anwendung einbetten?
Das direkte Einbetten einer privaten Wissensdatenbank in eine andere Anwendung wird nicht unterstützt. Verwenden Sie das Knowledge Base-Widget mit JWT-Authentifizierung, um Ihre private Knowledge Base in Ihre Anwendung zu integrieren.
Ist es möglich, mehrere Knowledge Base-Widgets zu konfigurieren?
Ja, man kann bis zu 10 Knowledge Base-Widgets in einem Projekt konfigurieren. Allerdings kann pro Domain oder Website nur ein Widget konfiguriert werden, um optimale Leistung zu gewährleisten.