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

# Wissensdatenbanken

> Assistenten aus Dokumenten und Websites antworten lassen

Eine Wissensdatenbank versorgt einen Assistenten mit freigegebenen Informationen zu Produkten, Richtlinien, Öffnungszeiten, Preisen und anderen Geschäftsthemen. Stellt ein Anrufer eine passende Frage, kann der Assistent die relevantesten Teile deiner Inhalte nutzen, statt zu raten.

## Funktionsweise

Alles, was du hinzufügst, wird in kurze Passagen aufgeteilt und indexiert. Während eines Gesprächs wird die Frage des Anrufers mit diesem Index abgeglichen, und nur die am besten passenden Passagen werden dem Assistenten als Hintergrund für seine Antwort übergeben – nicht das ganze Dokument und nicht die gesamte Wissensdatenbank.

Das hat eine praktische Konsequenz: Der Assistent sieht immer nur die Passagen, die getroffen haben. Verteilt sich die Antwort auf eine Frage über drei Dokumente, oder steht die Bedingung, die sie einschränkt, in einem anderen Abschnitt als die eigentliche Information, kann die gefundene Passage zwar wahr, aber unvollständig sein. Jedes Thema als in sich geschlossenen Abschnitt zu schreiben, macht das Retrieval zuverlässig – siehe unten.

## Wissensdatenbank erstellen und verbinden

<Steps>
  <Step title="Erstellen">
    Öffne **Knowledge bases → New**, vergib einen Namen und beschreibe kurz den Inhalt.
  </Step>

  <Step title="Inhalte hinzufügen">
    Lade PDF-, DOCX-, HTML- oder Textdateien hoch. Du kannst außerdem Text, Dokument-URLs oder eine Website-Quelle hinzufügen.
  </Step>

  <Step title="Auf Bereitschaft warten">
    Jeder Eintrag zeigt seinen Status. Kann ein Eintrag nicht verarbeitet werden, öffne ihn, um zu sehen, was geändert werden muss.
  </Step>

  <Step title="Testen">
    Nutze **RAG Search**, um echte Kundenfragen zu stellen und die Passagen zu sehen, die ein Assistent finden würde. Verbessere jedes Dokument, das unklar oder widersprüchlich zurückkommt.
  </Step>

  <Step title="Assistent verbinden">
    Wähle die Wissensdatenbank im Assistenten-Editor aus. Eine Prompt-Änderung ist nicht nötig.
  </Step>
</Steps>

## Inhalte für gute Antworten schreiben

* Verwende für jedes Thema eine klare Überschrift.
* Halte die Fakten und Bedingungen für eine Antwort im selben Abschnitt.
* Schreibe wichtige Zahlen in den Text, nicht nur in komplexe Tabellen.
* Entferne veraltete oder widersprüchliche Kopien.
* Bevorzuge nach Möglichkeit ein Thema pro Dokument.
* Achte bei sehr großen Wissensdatenbanken auf die Latenz, besonders bei vielen umfangreichen PDFs – das Umwandeln von Kerninhalten in Textdateien verarbeitet und liefert meist schneller.

## Website importieren

Füge eine Website-Quelle mit einer Root-URL hinzu. Du kannst den Import auf bestimmte Pfad-Präfixe begrenzen, unerwünschte Bereiche ausschließen und die maximale Seitenzahl festlegen.

Starte den Import einmalig, oder aktiviere die automatische Synchronisierung, um die Website im gewählten Intervall erneut zu prüfen. Nur neue oder geänderte Seiten verbrauchen Import-Credits.

Vergib jeder Auto-Refresh-Quelle beim Hinzufügen einen eigenen Namen. Dieser Name erscheint unter **Auto Refresh**; er ändert weder die Website-URL noch den verbundenen Ordner. Wähle bei der Quelle später **Edit**, um sie umzubenennen oder ihre Aktualisierungseinstellungen zu ändern.

Wähle bei einer Website-Quelle **Load pages**, um die Pfade zu sehen, deren Indexierung abgeschlossen ist. Das Laden dieser Liste liest nur den aktuellen Index – es aktualisiert die Website nicht und verbraucht keine Credits.

Für den Zugriff per API oder MCP verwendest du `GET /knowledge-bases/{id}/crawl-sources/{sourceId}/pages` oder `list_crawl_source_pages`. Beide liefern nur fertig indexierte Seiten und starten weder eine Aktualisierung noch einen Credit-Verbrauch.

Website-Importe:

* folgen Seiten auf demselben Host,
* beachten die Crawling-Regeln der Website,
* funktionieren am besten, wenn der Haupttext im HTML vorhanden ist, und
* überspringen nicht unterstützte oder zu große Seiten.

Lädt eine Website ihren relevanten Text erst nach dem Ausführen von JavaScript, füge den Inhalt stattdessen als Dokument oder direkten Text hinzu.

## Cloud-Drive-Sync

Füge einen Google-Drive-, OneDrive-, Box-, Dropbox- oder SharePoint-Ordner als Wissensdatenbank-Quelle hinzu, die genau wie eine Website-Quelle automatisch aktuell bleibt. Verbinde das Konto zuerst unter **[Automations → Connections](/de/automations/overview)**, falls noch nicht geschehen – eine OAuth-Anmeldung, kein eingefügter Key –, füge den Ordner dann als Quelle hinzu und wähle diese Verbindung aus. SharePoint benötigt zusätzlich die Drive-ID der Dokumentbibliothek – ein Ordnerpfad allein reicht nicht aus, um ihren Inhalt aufzulisten.

Starte eine Synchronisierung einmalig, oder aktiviere Auto-Sync, um den Ordner im gewählten Intervall erneut zu prüfen. Nur neue oder geänderte Dateien verbrauchen Sync-Credits.

Cloud-Drive-Sync ist Beta: Aktiviere **Beta Features** unter **Settings → Workspace**, bevor die Cloud-Drive-Optionen erscheinen. Es ist über ein eigenes Plan-Feature freigeschaltet, getrennt vom Website-Crawling, und wird pro synchronisierter Datei zum doppelten Satz des Website-Crawl-Preises pro Seite abgerechnet – auf der [Nutzungsseite](https://app.famulor.io/usage) als **KB cloud drive sync file** aufgeführt, wo du deine aktuellen Sätze einsehen kannst.

Für den Zugriff per API oder MCP verwendest du `GET`/`POST /api/v1/knowledge-bases/{id}/drive-sources`, `GET`/`PATCH`/`DELETE /api/v1/knowledge-bases/{id}/drive-sources/{sourceId}` und `POST /api/v1/knowledge-bases/{id}/drive-sources/{sourceId}/run`, oder die MCP-Tools `list_drive_sources`, `create_drive_source`, `update_drive_source`, `delete_drive_source`, `run_drive_source`.

## Selbstlernende FAQ (Beta)

Der Tab **FAQ (Beta)** erscheint, sobald **Beta Features** unter **Settings → Workspace** aktiviert ist. Frage-Antwort-Paare lassen sich direkt unter **Entries** schreiben – eine leichtere Alternative zum Hochladen eines Dokuments. Unabhängig davon sammelt das Postfach **Inbox** Faktenfragen von Kunden, für die kein hilfreicher Wissenstreffer gefunden wurde. Prüfe einen vorgeschlagenen Antwortentwurf, bearbeite ihn und wähle **Approve & publish**, bevor er Teil der Wissensdatenbank wird.

Von Assistenten erzeugte Vorschläge werden nie automatisch veröffentlicht. Je nach Assistenteneinstellung kann Famulor nur die Frage sammeln, einen privaten Entwurf vorbereiten oder im Gespräch eine erkennbar vorläufige Antwort teilen.

## Verfügbarkeit und Limits

Die Anzahl der Wissensdatenbanken und der Zugriff auf den Website-Import hängen von deinem Plan ab. Reicht die im Plan enthaltene Anzahl an Wissensdatenbanken nicht aus, kaufst du zusätzliche Plätze unter **Settings → Plan** als Add-on **Extra Knowledgebases**, abgerechnet pro Wissensdatenbank und Monat. Die aktuellen Limits pro Wissensdatenbank:

| Ressource    | Limit                             |
| ------------ | --------------------------------- |
| Dateien      | 25 Dateien, bis zu 20 MB je Datei |
| URLs         | 500                               |
| Texteinträge | 50                                |
| CSV oder TSV | 1.000 Zeilen und 50 Spalten       |

Website-Importe werden pro neuer oder geänderter Seite in Credits abgerechnet, zum Workspace-Satz **KB crawl / auto-sync page** – aktuelle Sätze findest du auf der [Nutzungsseite](https://app.famulor.io/usage). Die Quelle zeigt den Fortschritt und alle nötigen Schritte an, falls das verfügbare Guthaben aufgebraucht ist.
