Synchronisation starten und überwachen¶

Manuelle Synchronisation¶

Öffnen Sie das Customer Portal → Konnektoren
Suchen Sie den gewünschten Konnektor in der Liste
Klicken Sie auf Synchronisieren (🔄)
Die Synchronisation startet im Hintergrund

Komplett neu synchronisieren¶

Auf der Konnektor-Detailseite finden Sie zusätzlich die Aktion „Komplett neu synchronisieren". Damit werden alle Dokumente erneut vom Quellsystem gelesen und vollständig neu in die Wissensdatenbank aufgenommen — auch wenn sie sich seit der letzten Synchronisation nicht geändert haben.

Wann diese Aktion sinnvoll ist:

Nach einem Plattform-Update, das neue Metadaten an Dokumente anhängt (z. B. den Link „Originalquelle öffnen" ab Plattform-Version 0.76.0 für Confluence-, SharePoint- und GitHub-Dokumente).
Wenn der Verdacht besteht, dass Dokumente in der Wissensdatenbank nicht mehr zum Zustand im Quellsystem passen.

Längere Laufzeit

Ein Full-Resync kann bei großen Datenbeständen deutlich länger dauern als ein normaler Sync, da jedes Dokument neu verarbeitet, vektorisiert und gespeichert wird. Den regulären inkrementellen Sync (Schaltfläche Synchronisieren) für den Alltagsbetrieb verwenden.

Synchronisations-Status¶

Während der Synchronisation sehen Sie den aktuellen Fortschritt:

Status	Bedeutung
🟢 Erfolgreich	Letzte Synchronisation war erfolgreich
🔵 Läuft	Synchronisation ist gerade aktiv
🟡 Teilweise	Einige Dokumente konnten nicht verarbeitet werden
🔴 Fehler	Synchronisation ist fehlgeschlagen
⏸️ Pausiert	Konnektor ist deaktiviert

Synchronisations-Historie¶

Klicken Sie auf den Konnektor-Namen
Wechseln Sie zum Tab Historie
Sie sehen alle bisherigen Synchronisationsläufe mit:
Datum und Uhrzeit
Anzahl verarbeiteter Dokumente
Neue, aktualisierte und gelöschte Dokumente
Eventuelle Fehler

Konnektor bearbeiten¶

Alle Einstellungen eines Konnektors lassen sich nachträglich ändern — Sie müssen ihn dafür nicht löschen und neu anlegen.

Klicken Sie auf das Bearbeiten-Symbol (✏️) beim Konnektor
Passen Sie die gewünschten Felder an — es stehen dieselben zur Verfügung wie beim Anlegen, je nach Konnektor-Typ etwa Ordnerpfad, Dateimuster, Repository oder Branch
Klicken Sie auf Speichern

Die bereits synchronisierten Dokumente und die Synchronisations-Historie bleiben dabei erhalten.

Zugangsdaten bleiben leer (seit Release 0.82.37)

Passwörter, Token und Client-Secrets werden aus Sicherheitsgründen nie an Ihren Browser zurückgegeben und erscheinen deshalb als leeres Feld. Lassen Sie es leer, bleiben die gespeicherten Zugangsdaten unverändert — nur wenn Sie etwas eintragen, wird der bisherige Wert überschrieben.

Nach dem Einschränken von Pfaden oder Dateimustern

Grenzen Sie den Ordnerpfad oder die Dateimuster enger ein, bleiben bereits übernommene Dokumente aus dem vorher erfassten Bereich in der Wissensdatenbank. Entfernen Sie diese bei Bedarf auf der Seite Dokumente.

Konnektor pausieren / fortsetzen¶

Sie können einen Konnektor pausieren, ohne ihn zu löschen:

Klicken Sie auf das Pause-Symbol (⏸️) beim Konnektor
Der Konnektor wird deaktiviert — keine automatische Synchronisation mehr
Zum Fortsetzen: Klicken Sie erneut auf das Symbol

Konnektor löschen¶

Klicken Sie auf das Löschen-Symbol (🗑️) beim Konnektor
Bestätigen Sie die Löschung — der Dialog weist explizit darauf hin, wie viele Dokumente betroffen sind

Dokumente werden mitgelöscht (seit Release 0.73.3)

Beim Löschen eines Konnektors werden alle durch ihn synchronisierten Dokumente aus der Wissensdatenbank entfernt — sowohl die Textauszüge (Chunks) als auch die Inventareinträge. Der Wissensassistent liefert anschließend keine Antworten mehr aus diesen Quellen.

Falls die Dokumente erhalten bleiben sollen, deaktivieren Sie den Konnektor stattdessen (Pause-Symbol) oder erstellen Sie zuvor einen Export.