Synchronisation starten und überwachen

Manuelle Synchronisation

1. Öffnen Sie das Customer Portal → Konnektoren
2. Suchen Sie den gewünschten Konnektor in der Liste
3. Klicken Sie auf Synchronisieren (🔄)
4. 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.

Anschließend gleicht die Plattform den Bestand mit dem Quellsystem ab (seit Release 0.83.12): Dokumente, die dort nicht mehr vorhanden sind oder nicht mehr zu Ordnerpfad und Dateimustern des Konnektors passen, werden aus der Wissensdatenbank entfernt.

Wann diese Aktion sinnvoll ist:

• Einmalig nach dem Update auf Plattform-Version 0.83.12: Dateien, die im Quellsystem gelöscht, umbenannt oder verschoben wurden, aber noch gefunden werden, verschwinden damit.
• Nach dem Einschränken von Ordnerpfad oder Dateimustern eines Konnektors.
• Regelmäßig bei SMB- und Confluence-Konnektoren: Diese erkennen gelöschte Inhalte bei der normalen Synchronisation nicht.
• 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.

Wann der Abgleich nichts entfernt

Konnte der Konnektor das Quellsystem nicht vollständig lesen — etwa weil ein Unterordner oder Space für das hinterlegte Konto nicht freigegeben ist — oder liefert der eingestellte Ordner gar keine Dateien, entfernt die Aktion zum Schutz Ihrer Daten nichts. Werden danach weiterhin veraltete Dokumente gefunden, prüfen Sie Berechtigungen und Ordnerpfad des Konnektors und starten Sie die Aktion erneut.

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

1. Klicken Sie auf den Konnektor-Namen
2. Wechseln Sie zum Tab Historie
3. Sie sehen alle bisherigen Synchronisationsläufe mit:
4. Datum und Uhrzeit
5. Anzahl verarbeiteter Dokumente
6. Neue, aktualisierte und gelöschte Dokumente
7. 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.

1. Klicken Sie auf das Bearbeiten-Symbol (✏️) beim Konnektor
2. 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
3. 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 zunächst in der Wissensdatenbank. Lösen Sie danach „Komplett neu synchronisieren" aus — die Aktion entfernt Dokumente, die nicht mehr zu den Einstellungen passen (seit Release 0.83.12).

Konnektor pausieren / fortsetzen

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

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

Konnektor löschen

1. Klicken Sie auf das Löschen-Symbol (🗑️) beim Konnektor
2. 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.