Dokumente

URL: /admin/documents Mindest-Rolle: avs-editor

Die Dokumentenverwaltung ermoeglicht das Hochladen, Versionieren und Loeschen von Wissensdokumenten, die der Chatbot zur Beantwortung von Fragen nutzt.

Upload

Methoden

• Drag & Drop: Datei(en) in den Upload-Bereich ziehen
• Button: Datei ueber den Dateiauswahl-Dialog hochladen

Unterstuetzte Formate

Format	Endung
PDF	.pdf
Word	.docx
Text	.txt
Markdown	.md

Maximale Dateigroesse: 50 MB

4-Schritt-Verarbeitung

Nach dem Upload durchlaeuft jedes Dokument vier Schritte:

1. Uploaded -- Datei ist auf dem Server gespeichert
2. Extracting -- Textextraktion aus dem Dokument
3. Chunking -- Aufteilung in Abschnitte (Chunks)
4. Embedding -- Erzeugung der Vektor-Embeddings und Speicherung in Qdrant

Der Fortschritt wird live angezeigt.

Chunk-Vorschau

Nach der Verarbeitung kann eine Vorschau der erzeugten Chunks eingesehen werden. Zusaetzlich kann eine Testfrage gestellt werden, um die Qualitaet der Indexierung zu pruefen.

Dokumenten-Tabelle

Die Tabelle zeigt alle aktiven Dokumente mit folgenden Spalten:

Spalte	Beschreibung
file_path	Pfad des Dokuments
status	Verarbeitungsstatus
chunks_count	Anzahl der erzeugten Chunks
created_at	Upload-Zeitpunkt
product_id	Zugeordnetes Produkt

Versionierung

Jedes Dokument wird versioniert. Bei einem erneuten Upload derselben Datei wird eine neue Version angelegt. Die Versionshistorie ist einsehbar.

Rollback

Ueber die Versionshistorie kann auf eine fruehere Version zurueckgesetzt werden. Dabei werden die Chunks der aktuellen Version in Qdrant geloescht und durch die Chunks der Zielversion ersetzt.

Rollback-Auswirkung

Ein Rollback aendert sofort, welche Inhalte der Chatbot als Wissensquelle nutzt. Laufende Sessions bemerken die Aenderung beim naechsten Turn.

Loeschen (Soft-Delete)

Dokumente werden nicht physisch geloescht, sondern als inaktiv markiert (Soft-Delete). Dabei werden:

1. Alle Versionseintraege in der Datenbank auf deleted gesetzt
2. Die zugehoerigen Chunks aus Qdrant entfernt
3. Relevante Caches invalidiert

Mit AVS abstimmen

Der typische Update-Rhythmus der AVS-Produkthandbuecher ist mit AVS abzustimmen. Aus dieser Absprache ergeben sich konkrete Empfehlungen, wann Dokumente re-indexiert werden sollten (z.B. nach jedem Software-Release oder in festen Zeitabstaenden).

Automatische Evaluation

Wenn die Einstellung eval_auto_after_upload aktiviert ist (Standard: ja), wird nach jedem Upload automatisch eine Qualitaetspruefung gestartet. Siehe Evaluation.

Produkt-Kontext

Dokumente sind immer einem Produkt zugeordnet. Der aktive Produkt-Kontext (Switcher in der Sidebar) bestimmt, welche Dokumente in der Tabelle angezeigt werden.

Screenshot

Platzhalter: Screenshot der Dokumentenverwaltung einfuegen.