> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Folder Sync

> Synchronisiere Ordner von SharePoint oder Google Drive direkt mit deinen Agenten für nahtlosen Zugriff auf aktuelle Wissensbasen

Folder Sync ermöglicht es dir, ganze Ordner aus SharePoint oder Google Drive an deine Agenten anzuhängen und deine Wissensbasis automatisch mit täglichen Updates zu synchronisieren. Diese Funktion geht über einzelne Dateianhänge hinaus und ermöglicht dir die Arbeit mit größeren Dokumentensammlungen bei gleichzeitigem Zugriff auf die neuesten Versionen.

<Info>
  Folder Sync erfordert, dass die SharePoint- oder Google Drive-Integrationen in deinem Workspace aktiviert sind. Kontaktiere deinen Admin, falls diese Integrationen nicht verfügbar sind.
</Info>

## Wie Folder Sync funktioniert

Im Gegensatz zu [direkten Dateianhängen](/de/using-langdock/troubleshooting/faq/knowledge-folders-and-direct-attachments), die ganze Dokumente an das KI-Modell senden, verwendet Folder Sync eine semantische Suche, um relevante Abschnitte aus deinen synchronisierten Ordnern zu identifizieren. Dieser Ansatz ermöglicht die Arbeit mit größeren Dokumentensammlungen und bleibt dabei innerhalb der Kontextgrenzen des KI-Modells.

<Tabs>
  <Tab title="Folder Sync">
    * **Verarbeitungsmethode**: Semantische Suche identifiziert relevante Abschnitte
    * **Dateilimit**: Bis zu 200 Dateien pro Ordner
    * **Am besten für**: Große Dokumentensammlungen, FAQ-Agenten, Abteilungswissensbasen
    * **Updates**: Tägliche automatische Synchronisation
    * **Kontext**: Nur relevante Abschnitte werden an das Modell gesendet
  </Tab>

  <Tab title="Direkte Anhänge">
    * **Verarbeitungsmethode**: Gesamte Dokumente werden an das Modell gesendet
    * **Dateilimit**: Bis zu 50 Dateien pro Agent (die ersten 20 als Vorschau, Dateien 21–50 über die Dokumentensuche abrufbar)
    * **Am besten für**: Kleine, häufig referenzierte Dokumente
    * **Updates**: Manuelles erneutes Hochladen erforderlich
    * **Kontext**: Vollständige Dokumente stehen dem Modell zur Verfügung
  </Tab>
</Tabs>

## Folder Sync einrichten

<Steps>
  <Step title="Navigiere zu deinem Agenten">
    Öffne den Agenten, an den du einen synchronisierten Ordner anhängen möchtest, und gehe zum Wissensbereich.
  </Step>

  <Step title="Starte den Anhangprozess">
    Klicke auf den **Anhängen**-Button in deinem Wissensbereich und suche nach deinem Ordner anhand des Namens.

    <Tip>
      Verwende spezifische Ordnernamen, um die benötigten Inhalte schnell zu finden. Die Suchfunktion durchsucht alle zugänglichen Ordner in deinen verbundenen Integrationen.
    </Tip>

    <Info>
      Statt nach dem Namen zu suchen, kannst du auch einen SharePoint-Link direkt in die Ordnersuche einfügen. SharePoint-Listen und OneNote-Notizbücher werden nicht unterstützt.
    </Info>
  </Step>

  <Step title="Überprüfe Sync-Einschränkungen">
    Vor dem Anhängen siehst du einen Dialog mit den Sync-Parametern für deinen ausgewählten Ordner:

    * **Tägliche Synchronisation**: Dateien werden einmal täglich synchronisiert, um aktuelle Inhalte zu gewährleisten
    * **200-Dateien-Maximum**: Nur die ersten 200 Dateien werden verarbeitet
    * **Dateitypbeschränkungen**: Bilder werden ausgeschlossen
    * **Erste Sync-Dauer**: Die erste Synchronisation kann bis zu einer Stunde dauern

    <Info>
      Der Dateizugriff wird in Echtzeit überprüft. Nutzer können nur Inhalte aus Dateien abrufen, für die sie im Quellsystem (SharePoint oder Google Drive) Zugriffsrechte haben. Nutzer benötigen ihre eigene Integrationsverbindung, um auf Inhalte synchronisierter Ordner zugreifen zu können.
    </Info>
  </Step>

  <Step title="Bestätige und hänge an">
    Überprüfe die Ordnerinhalte und klicke auf **Ordner anhängen**, um die erste Synchronisation zu starten.

    <Check>
      Dein Ordner wird im Wissensbereich des Agenten angezeigt, sobald die erste Synchronisation abgeschlossen ist.
    </Check>
  </Step>
</Steps>

## Folder Sync Einschränkungen

Das Verständnis dieser technischen Einschränkungen hilft dir, deine Ordnerstruktur und Content-Strategie zu optimieren:

### Datei- und Ordnerlimits

<CardGroup cols={2}>
  <Card title="Limit pro Agent" icon="folder">
    Maximal **5 synchronisierte Ordner** pro Agent, um optimale Performance und Antwortqualität zu gewährleisten.
  </Card>

  <Card title="Limit pro Ordner" icon="file">
    Bis zu **200 Dateien** pro Ordner werden verarbeitet. Dateien über dieses Limit hinaus werden automatisch ausgeschlossen.
  </Card>
</CardGroup>

### Dateitypbeschränkungen

<Note>
  **Unterstützte Formate**: Textdokumente (PDF, DOC, DOCX, TXT, MD), Präsentationen (PPT, PPTX), SharePoint-Seiten (ASPX), Tabellen (XLS, XLSX, CSV, TSV, Google Sheets) und andere textbasierte Dateien.

  **Ausgeschlossene Formate**: Bilder (PNG, JPG, GIF) und andere Nicht-Text-Medien.
</Note>

Tabellen in synchronisierten Ordnern werden Agents über das gleiche Read-Tool zugänglich gemacht, das auch für direkt angehängte Tabellen verwendet wird – nicht über die semantische Suche, die für Textdokumente eingesetzt wird. So können Agents bestimmte Tabellenblätter und Zellen bei Bedarf öffnen und abfragen, während Textdokumente weiterhin per semantischer Suche abgerufen werden. Bilder bleiben ausgeschlossen, da sie andere Verarbeitungsmethoden erfordern, die nicht mit Folder Sync kompatibel sind.

### Unterordner-Handhabung

Unterordner zählen zum 200-Dateien-Limit, aber das direkte Anhängen von Unterordnern als separate synchronisierte Ordner liefert oft bessere Ergebnisse:

* **Reduziertes Überspringen von Dateien**: Direktes Anhängen von Unterordnern verringert die Wahrscheinlichkeit, dass wichtige Dateien ausgeschlossen werden
* **Bessere Organisation**: Separate synchronisierte Ordner für verschiedene Themen oder Abteilungen verbessern die Inhaltsrelevanz
* **Klarerer Kontext**: Ein fokussierter Ordnerumfang hilft der semantischen Suche, relevantere Inhaltsabschnitte zu identifizieren

## Sync-Verhalten und Zeitplanung

### Automatische Updates

Deine synchronisierten Ordner werden **einmal täglich** aktualisiert, um sicherzustellen, dass Agenten Zugriff auf die neuesten Dokumentversionen haben. Dieser automatische Prozess:

* Erkennt neue Dateien, die dem Ordner hinzugefügt wurden
* Aktualisiert vorhandene Dateien, die geändert wurden
* Entfernt Dateien, die aus dem Quellordner gelöscht wurden
* Hält das 200-Dateien-Limit ein, indem Dateien in der Reihenfolge verarbeitet werden, in der sie im Quellsystem erscheinen

### Erste Sync-Dauer

<Warning>
  Die erste Synchronisation kann bis zu **einer Stunde** dauern, abhängig von Ordnergröße und Dateikomplexität. Nachfolgende tägliche Updates sind in der Regel viel schneller.
</Warning>

Während der ersten Synchronisation:

1. Lädt das System jede Datei herunter und verarbeitet sie für die semantische Suche
2. Erstellt durchsuchbare Indizes für die Inhaltssuche
3. Validiert Dateiformate und wendet Beschränkungen an
4. Richtet den Synchronisationsplan ein

### Manuelles Aktualisieren

Zusätzlich zu den automatischen täglichen Synchronisationen kannst du einen synchronisierten Ordner jederzeit manuell aktualisieren, um die neuesten Updates sofort zu erhalten:

1. Navigiere zum **Wissensbereich** deines Agenten
2. Fahre mit der Maus über den synchronisierten Ordner, den du aktualisieren möchtest
3. Klicke auf die **drei Punkte** (⋯), die erscheinen
4. Wähle **Aktualisieren** aus dem Menü

Die manuelle Aktualisierung löst eine sofortige Synchronisation aus, was nützlich ist, wenn:

* Du gerade wichtige Dateien hinzugefügt hast, die sofort verfügbar sein müssen
* Du überprüfen möchtest, ob aktuelle Änderungen synchronisiert wurden
* Du Synchronisationsprobleme behebst und ein Update erzwingen möchtest

## Verbindungseigentum und Nutzerentfernung

Wenn du einen Ordner aus SharePoint oder Google Drive an einen Agenten anhängst, verwendet Langdock deine persönliche OAuth-Verbindung, um die Dateien zu authentifizieren und zu synchronisieren. Diese Verbindung ist an dein Nutzerkonto gebunden.

### Was passiert, wenn ein Nutzer aus Langdock entfernt wird

<Warning>
  Wenn der Nutzer, der ursprünglich einen Ordner verbunden hat, aus dem Langdock-Workspace entfernt wird, bricht die Synchronisation ab. Die Dateien bleiben zwar an den Agenten angehängt, aber es werden keine Updates mehr durchgeführt.
</Warning>

Wenn ein Nutzer aus Langdock gelöscht wird:

1. **Dateien bleiben angehängt**: Die bereits synchronisierten Dokumente bleiben an den Agenten angehängt und sind weiterhin für Nutzer zugänglich, die Zugriff auf diesen Agenten haben
2. **Synchronisation stoppt**: Die OAuth-Verbindung, die zum Aktualisieren und Synchronisieren des Ordners verwendet wurde, wird zusammen mit dem Nutzerkonto gelöscht
3. **Keine automatische Wiederherstellung**: Das System kann die Verbindung zum Quellordner nicht automatisch wiederherstellen

### So stellst du die Synchronisation wieder her

Um die Synchronisation fortzusetzen, nachdem der ursprüngliche Verbinder entfernt wurde:

<Steps>
  <Step title="Entferne den fehlerhaften Ordner">
    Öffne den Wissensbereich des Agenten und entferne den Ordner, der nicht mehr synchronisiert wird.
  </Step>

  <Step title="Füge den Ordner erneut hinzu">
    Lass einen anderen Nutzer mit Zugriff auf denselben Quellordner den Ordner erneut an den Agenten anhängen.
  </Step>

  <Step title="Überprüfe die neue Verbindung">
    Die OAuth-Verbindung des neuen Nutzers wird nun für alle zukünftigen Synchronisationen verwendet.
  </Step>
</Steps>

<Tip>
  Bei geschäftskritischen Agenten solltest du mehrere Admins oder Teamleiter mit Zugriff auf die Quellordner haben. Dies gewährleistet die Kontinuität, falls der ursprüngliche Verbinder die Organisation verlässt.
</Tip>

## Zugriffskontrolle und Berechtigungen

### Workspace-Konfiguration

Admins steuern die Verfügbarkeit von Folder Sync über die Workspace-Einstellungen:

1. Navigiere zu **Einstellungen** > **Rollen** in deinem Workspace
2. Konfiguriere, welche Nutzerrollen synchronisierte Ordner anhängen können
3. Aktiviere oder deaktiviere die Funktion für bestimmte Teams oder Abteilungen

### Überlegungen zum Teilen von Agenten

<Info>
  Wenn du einen Agenten mit synchronisierten Ordnern teilst, wird der Zugriff jedes Nutzers in Echtzeit gegen die Originalquelle (SharePoint oder Google Drive) geprüft. Nutzer können nur Inhalte aus Dateien abrufen, auf die sie im Quellsystem Zugriff haben.
</Info>

**Wie die Berechtigungsvererbung funktioniert**:

* Wenn ein Nutzer den Agenten abfragt, prüft Langdock seinen Zugriff auf jede Datei über sein verbundenes Konto
* Dateien, für die ein Nutzer in SharePoint oder Google Drive keine Berechtigung hat, werden für diesen Nutzer aus Dateilisten und Suchergebnissen ausgeblendet
* Nutzer müssen eine eigene Integrationsverbindung haben, um auf Inhalte synchronisierter Ordner zuzugreifen

**Best Practices für das Teilen von Agenten mit synchronisierten Ordnern**:

* Stelle sicher, dass Nutzer in SharePoint oder Google Drive die entsprechenden Berechtigungen für die benötigten Inhalte haben
* Nutzer sollten ihre eigenen Konten mit der jeweiligen Integration verbinden
* Überprüfe regelmäßig, welche Agenten Zugriff auf synchronisierte Ordner haben

## Folder Sync Performance optimieren

### Empfehlungen zur Ordnerstruktur

Für beste Ergebnisse mit dem 200-Dateien-Limit:

* **Nach Thema organisieren**: Erstelle fokussierte Ordner für spezifische Themen oder Projekte
* **Beschreibende Dateinamen verwenden**: Klare Namen helfen der semantischen Suche, relevante Inhalte zu identifizieren
* **Regelmäßige Aufräumarbeiten**: Entferne veraltete oder irrelevante Dateien, um den Wert deiner 200-Dateien-Zuteilung zu maximieren
* **Unterordner-Strategie bedenken**: Hänge wichtige Unterordner separat an, anstatt dich auf den übergeordneten Ordner zu verlassen

### Tipps zur Inhaltsqualität

* **Konsistente Formatierung**: Gut strukturierte Dokumente verbessern die Suchgenauigkeit
* **Klare Überschriften**: Eine ordnungsgemäße Dokumentstruktur hilft, relevante Abschnitte zu identifizieren
* **Duplikate vermeiden**: Mehrere Versionen desselben Inhalts können die semantische Suche verwirren
* **Update-Häufigkeit**: Häufiger aktualisierte Ordner profitieren am meisten von der täglichen Synchronisation

## Behebung häufiger Probleme

<AccordionGroup>
  <Accordion title="Ordner erscheint nicht in der Suche">
    **Mögliche Ursachen**:

    * Integration ist im Workspace nicht aktiviert
    * Unzureichende Berechtigungen für den Zugriff auf den Ordner
    * Ordner enthält keine unterstützten Dateitypen

    **Lösungen**:

    * Überprüfe, ob die SharePoint- oder Google Drive-Integration aktiv ist
    * Prüfe die Ordnerberechtigungen im Quellsystem
    * Stelle sicher, dass der Ordner mindestens ein unterstütztes Dateiformat enthält
  </Accordion>

  <Accordion title="Dateien fehlen im synchronisierten Ordner">
    **Mögliche Ursachen**:

    * Ordner überschreitet das 200-Dateien-Limit
    * Dateien haben nicht unterstützte Formate
    * Synchronisation läuft noch

    **Lösungen**:

    * Überprüfe Ordnerinhalte und entferne unnötige Dateien
    * Warte, bis die erste Synchronisation abgeschlossen ist (bis zu einer Stunde)
  </Accordion>

  <Accordion title="Synchronisation aktualisiert nicht täglich">
    **Mögliche Ursachen**:

    * Quellordner-Berechtigungen wurden geändert
    * Verbindungsprobleme mit der Integration
    * Workspace-Sync-Einstellungen wurden geändert

    **Lösungen**:

    * Überprüfe den fortlaufenden Zugriff auf den Quellordner
    * Prüfe den Integrationsstatus in den Workspace-Einstellungen
    * Kontaktiere den Admin, um die Sync-Konfiguration zu überprüfen
  </Accordion>

  <Accordion title="Synchronisation gestoppt, nachdem ein Nutzer die Organisation verlassen hat">
    **Ursache**:
    Der Nutzer, der ursprünglich den Ordner mit dem Agenten verbunden hat, wurde aus dem Langdock-Workspace entfernt. Wenn ein Nutzer gelöscht wird, wird auch seine OAuth-Verbindung gelöscht, was die Synchronisation unterbricht.

    **Lösungen**:

    * Entferne den Ordner aus dem Wissensbereich des Agenten
    * Lass einen anderen Nutzer mit Zugriff auf den Quellordner den Ordner erneut hinzufügen
    * Die Verbindung des neuen Nutzers wird für zukünftige Synchronisationen verwendet

    Siehe [Verbindungseigentum und Nutzerentfernung](#verbindungseigentum-und-nutzerentfernung) für weitere Details.
  </Accordion>
</AccordionGroup>

<Tip>
  Beginne mit deinen am häufigsten verwendeten und gut organisierten Ordnern, um die beste erste Erfahrung mit Folder Sync zu erhalten.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Wie funktioniert Folder Sync mit SharePoint oder Google Drive?">
    Folder Sync verbindet einen Quellordner mit Langdock, damit die Dateien verarbeitet und als Wissen verfügbar gemacht werden können. Sobald die Dateien zugänglich und verarbeitet sind, nutzt Langdock die synchronisierten Inhalte für die Suche.
  </Accordion>

  <Accordion title="Wie lange dauert es, bis synchronisierte Inhalte durchsuchbar sind?">
    Neue oder geänderte Dateien brauchen etwas Zeit für Synchronisation und Verarbeitung, bevor sie durchsuchbar sind. Die genaue Dauer hängt von der Größe der Quelle, der Dateianzahl, der Verfügbarkeit des Anbieters, den Berechtigungen und dem Verarbeitungsstatus ab.
  </Accordion>

  <Accordion title="Warum unterscheiden sich synchronisierte Ordnerinhalte von direkt hochgeladenen Dateien?">
    Direkte Uploads werden meist für einen bestimmten Chat oder eine bestimmte Aufgabe verwendet. Synchronisierte Ordner sind wiederverwendbare Wissensquellen und werden in der Regel nach relevanten Abschnitten durchsucht. Synchronisierte Inhalte eignen sich daher besser für die laufende Suche. Direkte Uploads sind besser, wenn der aktuelle Chat eine bestimmte Datei braucht.
  </Accordion>

  <Accordion title="Welche Berechtigungen sind für Folder Sync erforderlich?">
    Das verbundene Konto muss auf den Quellordner und die Dateien zugreifen können. Wenn Dateien fehlen, prüfe die Kontoberechtigungen im Quellsystem, den ausgewählten Ordner, eine gegebenenfalls erforderliche Admin-Freigabe und ob die Integrationsverbindung noch gültig ist.
  </Accordion>

  <Accordion title="Was sollte ich prüfen, wenn synchronisierte Dateien fehlen?">
    Prüfe, ob der Ordner verbunden ist, ob die Dateien unterstützt werden, ob die Verarbeitung abgeschlossen ist, ob das verbundene Konto auf die Dateien zugreifen kann und ob die Dateien kürzlich verschoben, umbenannt oder gelöscht wurden.
  </Accordion>
</AccordionGroup>
