Automatische Knowledge-Synchronisierung und Metadatenkonfiguration

Die automatische Knowledge-Synchronisierung hält ausgewählte öffentliche WordPress-Inhalte für die AI-Kit Knowledge Base verfügbar, ohne jedes erzeugte Basisdokument manuell veröffentlichen zu müssen. Sie ist vom Static Publisher getrennt: Die eine Funktion aktualisiert die Wissensquelle für Suche und Chat, die andere stellt öffentliche statische Seiten bereit.

Website verbinden​

Öffnen Sie SmartCloud → AI-Kit Settings → Knowledge Base → Automatic Knowledge Sync. Diese verbundene Pro-Funktion benötigt ein kompatibles AI-Kit-Backend. AI-Kit 1.4.19 und neuer setzt für die automatische Dokumentübertragung die Fähigkeit knowledge.automation in Version 5 voraus. Sie ist ab Backend-Version 1.0.85 und in späteren kompatiblen Versionen verfügbar. Die unten beschriebenen synchronisierungsbezogenen Quellenstatus stehen ab AI-Kit 1.4.20 bereit.

1. Konfigurieren Sie zuerst API Settings. Sie sind die maßgebliche Quelle für das Backend: Eine direkte URL wird unmittelbar verwendet, ein Name für die Gatey REST API wird zum konfigurierten Endpunkt aufgelöst. Backend from API Settings ist schreibgeschützt.
2. Wählen Sie unter Connection and runner die passende Umgebung und den Speicherort für den privaten Schlüssel. Encrypted WordPress option ist verfügbar; Protected file outside webroot setzt einen konfigurierten geschützten Serverpfad voraus. Mit Disabled kann die Website nicht registriert werden.
3. Wählen Sie Save connection settings und anschließend Create pairing code and enroll. Der kurzlebige Code richtet einen websitespezifischen Signaturschlüssel für nachfolgende serverseitige Anfragen ein.
4. Prüfen Sie den Status Enrolled und verwenden Sie bei Bedarf Verify connection.

Die Registrierung allein aktiviert die Synchronisierung nicht für jeden Inhaltstyp.

Inhalte und Freigaberichtlinie auswählen​

Wählen Sie unter Content policy einen öffentlichen Inhaltstyp, aktivieren Sie Automatically synchronize this content type, konfigurieren Sie seine Richtlinie und wählen Sie Save content policy. Wiederholen Sie dies für jeden gewünschten Typ. Unterstützt werden Standardbeiträge und -seiten sowie geeignete öffentliche Custom Post Types mit öffentlichen URLs.

• WordPress publish is approval erlaubt die automatische Übertragung veröffentlichter Inhaltsänderungen.
• Manual KB review hält Änderungen zurück, bis ein Administrator sie prüft und unter Operational status die Option Approve selected content type auswählt.
• Taxonomies included in metadata legt fest, welche Taxonomien Begriffe zu Dokumenten und zum aus WordPress abgeleiteten Vokabular beitragen. Das bloße Auswählen von Taxonomien veröffentlicht kein Vokabular; die Inhaltsrichtlinie muss aktiviert und gespeichert werden.
• Document profile ist eine erweiterte Routing-Bezeichnung, die zusammen mit den Backend-Dokumentmetadaten gespeichert wird. Behalten Sie default bei, sofern Ihre Abruffilter nicht ausdrücklich ein anderes Profil verwenden; allein verändert die Einstellung weder Konvertierung noch Aufnahme.

Übertragen werden nur geeignete veröffentlichte Inhalte der ausgewählten öffentlichen Inhaltstypen. Entwürfe, Revisionen, unveröffentlichte Vorschläge und private Inhalte dienen nicht als Quellen für die automatische Übertragung. Wird ein zuvor synchronisierter Inhalt zurückgezogen, entsteht eine Entfernungsanforderung; die unveröffentlichte Version wird nicht hochgeladen. Große Löschmengen können eine ausdrückliche Freigabe erfordern.

Zeitplanung und erste Synchronisierung​

AI-Kit registriert ein WordPress-Cron-Ereignis, das alle fünf Minuten fällig ist. Regulärer WP-Cron-Datenverkehr kann es ausführen. Plane auf Websites mit wenig Datenverkehr oder bei deaktiviertem verkehrsgesteuertem WP-Cron den Befehl wp cron event run --due-now alle fünf Minuten auf dem WordPress-Server ein. Eine Runner-Sperre verhindert überlappende Durchläufe.

Dies ist ein PHP-/serverseitiger Ablauf und keine Aufgabe, die Besucher des statischen Frontends ausführen. Der WordPress-Host benötigt ausgehende Verbindungen zum aufgelösten Backend. Der browserbasierte Chatbot und Doc Search können weiterhin auf einer statischen Website laufen, nachdem die ursprüngliche WordPress-Installation ihre Inhalte synchronisiert hat.

Run one sync pass führt einen begrenzten Durchlauf aus, nicht zwangsläufig den gesamten Erstimport. Die Batchgrößen für Baseline und Transport begrenzen die Arbeit je Durchlauf; Cron setzt die verbleibende Arbeit fort. Unter Operational status finden Sie ausstehende Aufgaben, Baseline-Datensätze, Blockierungsgründe, den Aufnahmestatus und das letzte Runner-Ergebnis.

Metadaten-Konfigurationsebenen​

Der Bereich Metadata configuration layers verbindet drei unabhängig verwaltete Eingaben. Es handelt sich nicht um drei bearbeitbare Kopien derselben erzeugten Datei.

Alle Editoren und Vorschauen der Metadatenebenen verwenden YAML. Dieses Anzeige- und Speicherformat ändert weder die strukturierten JSON-Anfrage- und -Antwortobjekte der API noch die für die Knowledge-Base-Aufnahme erforderlichen *.metadata.json-Begleitdateien pro Dokument; diese bleiben JSON.

Das erzeugte Ergebnis führt aktivierte externe und WordPress-Vokabulare mit der manuellen Richtlinie zusammen. Verwenden Sie allowedCategories, allowedTags und namespaceTags für Werte, die bewusst in der manuellen Ebene erhalten bleiben sollen; Werte in namespaceTags müssen auch in allowedTags vorkommen. Bestehende Felder wie categoryPolicies bleiben redaktionell gepflegte Richtlinien. Verwenden Sie vocabularyPolicy nur, wenn Aliase, Ausschlüsse oder gesperrte Anzeigewerte zur Normalisierung automatischer Eingaben nötig sind. Bearbeiten Sie die Eingaben oder die Richtlinie, nicht das erzeugte Ergebnis.

Ein externes Vokabular kann zum Beispiel eine Kategoriehierarchie ausdrücken, ohne eine untergeordnete Kategorie in eine weitere Hauptkategorie umzuwandeln:

- id: docusaurus
  enabled: true
  namespaces:
    category:
      - slug: guides
        label: Guides
      - slug: setup
        label: Setup
        parentSlug: guides
    post_tag:
      - ai-kit

Halten Sie Produzenten-IDs stabil. Die externe YAML-Liste enthält Vokabularhüllen und keine hochzuladenden Dokumente. Das Aktualisieren dieses Bedienfelds liest nur seinen aktuellen Zustand. Führen Sie einen Synchronisierungsdurchlauf aus oder warten Sie auf Cron, um geändertes WordPress-Vokabular zu übertragen.

Bestehende Konfiguration migrieren​

Wenn Legacy config ready to migrate erscheint, werden externe und WordPress-Eingaben vorbereitet, während die aktuelle wirksame Konfiguration unverändert bleibt. Prüfen Sie Proposed result, bevor Sie Establish manual layer auswählen. Die vorgeschlagene manuelle Ebene bewahrt ausschließlich manuelle und unbekannte Richtlinienfelder, während vom Produzenten geliefertes Vokabular unter dessen Kontrolle bleibt.

Das Einrichten der manuellen Ebene aktiviert die vorbereitete Zusammenführung. Es ist keine Anweisung, bestehende eigene Richtlinien zu verwerfen, und entfernt keine alten Dokumente aus der Knowledge Base. Prüfen Sie beibehaltene manuelle Kategorie- und Schlagwortwerte bewusst; lösche sie nicht allein deshalb, weil ein anderer Produzent dieselben Begriffe verwendet. Nach der Migration können weitere gültige Eingaben oder gespeicherte Richtlinien das wirksame Ergebnis ohne erneuten Einrichtungsschritt aktualisieren.

Quell-URLs und Dokumentüberschreibungen​

Für ein automatisch erzeugtes Basisdokument gilt folgende Rangfolge der Quell-URLs:

1. Die ausdrückliche Source URL des Dokuments unter Edit Base Document Metadata.
2. KB Settings → Base URL Override, angewendet auf den WordPress-Permalink.
3. Der ursprüngliche WordPress-Permalink.

Verwenden Sie die globale Überschreibung, wenn eine redaktionelle Website einen anderen öffentlichen Ursprung hat, etwa wenn Sie auf einem Entwicklungs-Hostnamen arbeiten, die Inhalte aber über den Produktions-Hostnamen ausliefern. Eine ausdrückliche URL pro Dokument hat Vorrang.

Die automatische Synchronisierung berücksichtigt außerdem Überschreibungen von Titel, Beschreibung, Kategorie, Unterkategorie und Schlagwörtern des Basisdokuments. Diese Metadatenüberschreibungen sperren das erzeugte Markdown nicht automatisch. Metadatenänderungen durchlaufen den Synchronisierungsablauf unter derselben Freigaberichtlinie. Eine Änderung der globalen Base URL Override löst den Abgleich bestehender Dokumente aus.

Status richtig interpretieren​

Der Veröffentlichungsstatusfilter und die Kennzeichnungen unter KB Sources unterscheiden automatische Übertragungszustände wie ausstehende Synchronisierung, laufende Synchronisierung, übertragen, Fehler, blockiert und entfernt. Fehler enthalten nach Möglichkeit ihren konkreten Grund.

„Übertragen“ bedeutet, dass das Backend die aktuelle Dokumentgeneration empfangen hat. Es bedeutet nicht, dass die Knowledge-Base-Indexierung abgeschlossen ist. Prüfen Sie unter Operational status die Backend-Aufnahme, bevor Sie aktualisierte Such- oder Chatergebnisse erwarten.

Needs Review bleibt für Aufgaben mit manueller Freigabe, separate manuelle Dokumente oder veraltete gesperrte Überschreibungen relevant. Eine erfolgreiche automatische Übertragung eines Basisdokuments gibt diese separaten Elemente nicht automatisch frei. Umgekehrt versetzt das bloße Fehlen eines manuellen Veröffentlichungsdatensatzes ein synchronisiertes Basisdokument nicht in die Prüfung.