Docusaurus

Synchronisieren Sie Ihre Docusaurus-Dokumentationswebsite mit der Wissensdatenbank von AI SmartTalk. Ihre KI wird von jeder Seite in Ihrer Sitemap lernen – perfekt für Support-Bots, die technische Fragen beantworten.

---

Übersicht

Die Docusaurus-Integration ermöglicht Ihnen:

• Importieren Sie automatisch alle Seiten aus Ihrer Sitemap
• Halten Sie die Dokumentation synchron, wenn Sie Updates veröffentlichen
• Beantworten Sie Fragen zu Ihrer Dokumentation im Gespräch
• Reduzieren Sie die Supportlast, indem Sie die KI häufige Fragen beantworten lassen

Interessante Tatsache: Die eigene Dokumentation von AI SmartTalk verwendet Docusaurus, und diese Integration treibt unseren Support-Chatbot an!

---

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

• Ein aktives AI SmartTalk-Konto haben
• Eine Docusaurus-Website mit einer gültigen sitemap.xml
• Ihre Website muss öffentlich zugänglich sein (oder Authentifizierung bereitstellen)

---

Schritt-für-Schritt-Setup

Schritt 1: Finden Sie Ihre Sitemap

Docusaurus generiert automatisch eine Sitemap. Finden Sie sie unter:

https://your-docs-site.com/sitemap.xml

Überprüfen Sie, ob sie in Ihrem Browser geladen wird und Ihre Dokumentationsseiten enthält.

Schritt 2: Fügen Sie die Docusaurus-Integration hinzu

1. Melden Sie sich bei Ihrem AI SmartTalk-Konto an
2. Navigieren Sie zu Einstellungen → Integrationen
3. Finden Sie Docusaurus und klicken Sie auf Verbinden
4. Geben Sie die URL Ihrer Sitemap ein
5. Klicken Sie auf Validieren

Schritt 3: Konfigurieren Sie die Import-Einstellungen

Nach der Validierung konfigurieren Sie Ihren Import:

Einstellung	Beschreibung
Sitemap-URL	Vollständige URL zu Ihrer sitemap.xml
Include-Muster	Nur Seiten synchronisieren, die mit Mustern übereinstimmen (optional)
Exclude-Muster	Bestimmte Seiten oder Abschnitte überspringen (optional)

Schritt 4: Starten Sie den Import

1. Klicken Sie auf Seiten importieren
2. AI SmartTalk crawlt jede URL in Ihrer Sitemap
3. Inhalte werden extrahiert und Ihrer Wissensdatenbank hinzugefügt
4. Warten Sie, bis der Import abgeschlossen ist (Fortschritt wird angezeigt)

Schritt 5: Überprüfen Sie den Import

1. Gehen Sie zu Wissen in AI SmartTalk
2. Ihre Dokumentationsseiten sollten angezeigt werden
3. Testen Sie Ihre KI, indem Sie Fragen zu Ihren Dokumenten stellen

---

Was synchronisiert wird

Inhalt	Wie er verarbeitet wird
Seitentitel	Wird als Dokumentenidentifikator verwendet
Seiteninhalt	Voller Text, der aus HTML extrahiert wurde
Überschriften	Für die Struktur beibehalten
Codeblöcke	Unverändert einbezogen
Tabellen	In ein lesbares Format umgewandelt
URLs	Seiten-URL zur Referenz gespeichert

Inhaltsextraktion

AI SmartTalk extrahiert den Hauptinhaltsbereich und ignoriert:

• Navigationsmenüs
• Seitenleisten
• Fußzeilen
• Skripte und Stile

---

Synchronisationsverhalten

Manueller Import

Klicken Sie auf Importieren in den Integrationseinstellungen, um:

• Die neueste Sitemap abzurufen
• Neue Seiten hinzuzufügen
• Geänderte Seiten zu aktualisieren
• Gelöschte Seiten zu entfernen

Dokumente aktuell halten

Für stets aktuelle Dokumentation:

1. Manuelles Aktualisieren: Klicken Sie auf Importieren, nachdem Sie Updates veröffentlicht haben
2. Geplante Synchronisation: Verwenden Sie SmartFlow, um Importe zu automatisieren

SmartFlow Geplanter Import

Workflow: Docusaurus Auto-Sync
Trigger: Geplant (Täglich um 3:00 Uhr)
Actions:
  - Sync Connector:
      Type: Docusaurus
      Sitemap: https://docs.example.com/sitemap.xml

---

URL-Muster

Include-Muster

Nur bestimmte Abschnitte synchronisieren:

Muster	Effekt
/docs/api/*	Nur API-Dokumentation
/docs/guides/*	Nur den Abschnitt Anleitungen
/blog/*	Nur Blogbeiträge

Exclude-Muster

Bestimmte Seiten überspringen:

Muster	Effekt
/docs/internal/*	Interne Dokumente überspringen
/changelog	Seite mit Änderungsprotokoll überspringen
*/draft-*	Entwurfsseiten überspringen

---

Anwendungsfälle

Technischer Support-Bot

Synchronisieren Sie Ihre Produktdokumentation:

• "Wie installiere ich das SDK?"
• "Was sind die API-Durchsatzlimits?"
• "Zeigen Sie mir ein Beispiel für die Authentifizierung"

Entwicklerdokumentation

Synchronisieren Sie API-Referenzen und Anleitungen:

• "Welche Parameter akzeptiert der /users-Endpunkt?"
• "Wie gehe ich mit Webhooks um?"
• "Was ist der Unterschied zwischen API v1 und v2?"

Interne Wissensdatenbank

Synchronisieren Sie Unternehmenswikis und Verfahren:

• "Wie läuft der Prozess zur Beantragung von PTO ab?"
• "Wie richte ich meine Entwicklungsumgebung ein?"
• "Wo finde ich die Markenrichtlinien?"

---

Fehlersuche

Sitemap-Probleme

Problem	Lösung
"Ungültige Sitemap"	Überprüfen Sie, ob die URL gültiges XML zurückgibt
"Keine Seiten gefunden"	Überprüfen Sie, ob die Sitemap <url>-Einträge enthält
"Zugriff verweigert"	Stellen Sie sicher, dass die Sitemap öffentlich zugänglich ist

Importprobleme

Problem	Lösung
Fehlende Seiten	Überprüfen Sie die Include/Exclude-Muster
Import hängt	Große Seiten benötigen Zeit; warten oder in Chargen importieren
Alte Inhalte	Erneut importieren, um die neuesten Versionen abzurufen

Inhaltsqualität

Problem	Lösung
Falscher Inhalt extrahiert	Problem melden – möglicherweise ist eine benutzerdefinierte Extraktion erforderlich
Fehlende Codeblöcke	Überprüfen Sie, ob der Code in standardmäßigen <pre><code>-Tags enthalten ist
Unleserlicher Text	Überprüfen Sie die Seitenkodierung (UTF-8 empfohlen)

---

Verwaltung der Integration

Aktion	Wie
Alle erneut importieren	Klicken Sie auf Importieren in den Integrationseinstellungen
Sitemap ändern	URL aktualisieren und erneut importieren
Inhalt entfernen	Integration trennen oder aus Wissen löschen
Trennen	Einstellungen → Integrationen → Docusaurus → Trennen

---

Best Practices

1. Qualitätsinhalt: Gut geschriebene Dokumente = bessere KI-Antworten
2. Klare Struktur: Verwenden Sie Überschriften, Listen und Tabellen
3. Beschreibende Titel: Seitentitel helfen der KI, den Kontext zu verstehen
4. Regelmäßige Synchronisationen: Halten Sie die KI mit der neuesten Dokumentation aktualisiert
5. Gründlich testen: Stellen Sie häufige Fragen, um die Genauigkeit der KI zu überprüfen

---

Docusaurus-Konfigurationstipps

Optimieren für die KI-Extraktion

In Ihrer docusaurus.config.js:

module.exports = {
  // Sicherstellen, dass die Sitemap generiert wird
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Verwenden Sie beschreibende Seitentitel
  title: 'Ihre Produktdokumentation',
  
  // Metadaten einfügen
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Dokumentation für Ihr Produkt'
    }],
  },
};

Seiten von der Sitemap ausschließen

Um zu verhindern, dass bestimmte Seiten synchronisiert werden:

// In der Frontmatter der Seite
---
title: Interne Seite
sitemap:
  exclude: true
---

---

Verwandte Dokumentation

• Integrationen Übersicht
• Wissensdatenbank Verwaltung
• RSS-Feed-Integration — Für Blog-/Nachrichteninhalte
• SmartFlow Geplante Trigger — Importe automatisieren