> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Dokumente-Wissen
> Laden Sie Datenquellen für Ihren KI-Agenten hoch
Wenn *Crawler* Bücher aus der öffentlichen Bibliothek (dem Web) sind, sind **Dokumente** die privaten Dateien in Ihrem Büro.
Hier laden Sie Ihre vertraulichen Handbücher, Excel-Preislisten oder internen PDF-Anleitungen hoch. Sie geben dem Agenten direkten Zugriff auf bestimmte Dateien, damit er ein sofortiger Experte für *Ihr* Geschäft wird.
### 📥 Was kann ich hier hochladen? (Magische Formate)
Ihr Agent ist mehrsprachig und kann fast alles lesen:
* 📄 **PDF:** Handbücher, Kataloge, Broschüren.
* 📊 **XLSX / CSV:** Preistabellen, Lagerlisten, einfache Datenbanken.
* 📝 **TXT / JSONL:** Schnelle Notizen, Logs oder strukturierte Daten.
***
### ⚙️ Wie Sie Ihre Dateien verwalten (Die Upload-Zone)
Es ist so einfach, wie es aussieht:
1. **Drag & Drop:** Ziehen Sie Ihre Datei in das Feld oder klicken Sie, um Ihren Computer zu durchsuchen.
2. **Verarbeitung:** Das System liest ("parst") den Text, damit der Agent ihn verstehen kann.
3. **Fertig!** Nach der Verarbeitung sehen Sie die Datei in der untenstehenden Liste.
#### Listensteuerung:
* **Name:** Der Dateiname. Halten Sie ihn klar (z. B. `Preise_2024.pdf` statt `dok1.pdf`).
* **Schalter (Der Switch):** Die nützlichste Funktion.
* 🔵 **AN:** Der Agent liest und verwendet diese Datei.
* ⚪ **AUS:** Die Datei ist gespeichert, wird aber vom Agenten ignoriert. Perfekt für Entwürfe oder ältere Versionen, die Sie nicht komplett löschen möchten.
* **Papierkorb 🗑️:** Entfernt die Datei dauerhaft aus dem Speicher des Agenten.
***
### ⚠️ Goldene Regeln (Was Sie NICHT tun sollten)
Um alles reibungslos am Laufen zu halten, beachten Sie Folgendes:
#### 1. Leere Dateien = Fehler 🚫
Wenn Sie eine PDF hochladen, die nur gescannte Bilder enthält (kein auswählbarer Text) oder eine beschädigte Datei, sehen Sie einen Fehler wie `[MARKITDOWN] pdf is empty`.
> **Lösung:** Stellen Sie sicher, dass die PDF echten Text enthält (OCR) oder dass die Excel-Datei tatsächliche Daten hat.
#### 2. Auf die Größe achten (Aufteilen!) ✂️
Es gibt ein Wortlimit pro Datei, um das Gehirn des Agenten nicht zu überlasten.
* *Hat Ihr Handbuch 500 Seiten?* Laden Sie es nicht als eine Datei hoch.
* **Aufteilen:** Laden Sie `Handbuch_Teil1.pdf`, `Handbuch_Teil2.pdf` usw. hoch.
* Der Agent ist intelligent und kombiniert Informationen aus allen aktiven Dateien, um eine kohärente Antwort zu geben.
***
### 🧠 Wie denkt der Agent damit?
Stellen Sie sich vor, Sie laden drei Dateien hoch und schalten sie **AN**:
1. `Waschmaschinen_Handbuch.pdf`
2. `Ersatzteile_Preise.xlsx`
3. `Garantierichtlinie.txt`
Wenn nun ein Nutzer fragt: *"Was kostet Teil X und ist es von der Garantie abgedeckt?"*
Der Agent wird:
1. Den Preis in der **Excel**-Datei nachschlagen.
2. Die Bedingungen in der **TXT**-Datei lesen.
3. Beides kombinieren und antworten: *"Das Teil kostet 20 € und ja, es ist unter Klausel 3 abgedeckt."* 🤯
***
### 🎓 Zusammenfassung der Best Practices (Spickzettel)
* **Beschreibende Namen:** Helfen Sie dem Agenten (und sich selbst) zu verstehen, was drin ist. `Hochzeitsmenü.pdf` ist besser als `scan001.pdf`.
* **Updates:** Wenn Sie eine neue Version hochladen (`Preise_V2.xlsx`), denken Sie daran, die alte (`Preise_V1.xlsx`) AUS zu schalten oder zu löschen, damit der Bot nicht mit zwei verschiedenen Preisen verwirrt wird.
* **Saubere Daten:** Vermeiden Sie das Hochladen von Excel-Dateien mit Tausenden leerer Zeilen oder PDFs mit starken Wasserzeichen. Je sauberer der Text, desto intelligenter die Antwort.
Füllen Sie das Gehirn Ihres Agenten mit Ihren besten Dokumenten! 📂✨