RAG — Technische Dokumentensuche
Überblick
PlantPulse RAG ist ein RAG-Suchserver (Retrieval-Augmented Generation), mit dem die KI technische Dokumente, Handbücher, SOPs und Vorschriften aus der Fertigung Vor-Ort sofort durchsuchen und referenzieren kann.
Über vier Suchmodi liefert er eine präzise und kontextgerechte Dokumentensuche und unterstützt auch multimodale Suchen (Bilder, Tabellen usw.).
Die Dokumentensuche besteht aus zwei Schichten.
- RAG API (
plantpulse-rag-api) — die Schicht, mit der Anwender und KI tatsächlich in Kontakt kommen. Sie stellt die Oberfläche zur Dokumentenverwaltung und die Such-API bereit. - LightRAG — die interne Engine, die Indizierung und Suche tatsächlich ausführt. Sie ist nicht nach außen exponiert und nur über die RAG API erreichbar.
Es gibt also keine Möglichkeit, die Adresse von LightRAG oder dessen WebUI (/webui) direkt zu öffnen. Sämtliche Dokumentenarbeit erfolgt in der Oberfläche der RAG API. (Der frühere Eigenentwicklungs-Server plantpulse-rag wurde archiviert; der Weg über den direkten Upload im LightRAG WebUI wurde zum 30.07.2026 durch die unten beschriebene Documents-Ansicht ersetzt.)
Suchmodi
| Modus | Beschreibung | Geeignet für |
|---|---|---|
| hybrid (Standard) | Kombination aus Dense + Sparse | Allgemeine Dokumentensuche (empfohlen) |
| naive | Semantische (bedeutungsbasierte) Suche | Konzeptuelle Fragen, Suche ähnlicher Dokumente |
| local | Detailsuche innerhalb eines Dokuments | Prüfen von Detailinhalten eines bestimmten Dokuments |
| global | Suche über Dokumentbeziehungen | Zusammenfassende Informationen über mehrere Dokumente hinweg |
Zugriffswege
| Aufgabe | Wo |
|---|---|
| Per Chat fragen | AI Chat Web — der integrierte Agent ruft das Werkzeug rag_search automatisch auf |
| Nur die Suche direkt ausprobieren | Ansicht Query im RAG-API-Dashboard |
| Dokumente hochladen, löschen, auflisten | Ansicht Documents im RAG-API-Dashboard |
| Ergebnisse der automatischen Synchronisierung prüfen | Ansicht Sync History im RAG-API-Dashboard |
| Ursachen fehlgeschlagener Indizierung einsehen | Ansicht Logs im RAG-API-Dashboard |
Zwei Wege, auf denen Dokumente eintreffen
Dokumente werden auf zwei Arten indiziert. Je nach Herkunftsweg unterscheidet sich die Verwaltung.
| Weg | Quelle | Beschreibung |
|---|---|---|
| Automatische Synchronisierung | An Anlagen angehängte Dokumente der Platform | Werden Dokumente in der Platform an eine Anlage angehängt, erfolgt die Indizierung periodisch automatisch. Ein separates Hochladen auf RAG-Seite entfällt |
| Manueller Upload | Ansicht Documents | Dokumente ohne Anlagenbezug (allgemeine Vorschriften, Schulungsunterlagen usw.) werden direkt hochgeladen. Das Original wird separat aufbewahrt und übersteht auch eine Neuindizierung |
Werden anlagenbezogene Dokumente manuell in RAG hochgeladen, weichen sie vom Dokumentenbestand der Platform ab. Hängen Sie Anlagendokumente in der Platform an die Anlage an und überlassen Sie RAG die automatische Synchronisierung — das vereinfacht die Verwaltung.
Multimodale Unterstützung
Unterstützt wird die Suche über multimodale Inhalte aus Text + Bild + Tabelle usw.:
- Anfrage „Was ist dieses Bauteil?" mit angehängtem Anlagenfoto
- Foto eines Bedienpanels → Suche nach dem zugehörigen Konfigurationshandbuch
- Unterstützung von Bild-URL oder Base64-Daten
Bis ein Dokument durchsuchbar ist
문서 등록 (플랫폼 설비 첨부 / Documents 화면 업로드)
│
▼
파싱 — PDF·DOCX·이미지에서 텍스트와 표를 추출
│
▼
청킹 — 검색 단위로 잘게 나눔
│
▼
임베딩 — 각 조각을 벡터로 변환
│
├──▶ 벡터 저장소 (유사도 검색)
└──▶ 지식 그래프 (엔티티·관계 추출)
Unmittelbar nach der Registrierung ist ein Dokument noch nicht durchsuchbar. Es erscheint erst in den Ergebnissen, wenn Parsing und Embedding abgeschlossen sind. Wird ein soeben hochgeladenes Dokument nicht gefunden, prüfen Sie zuerst den Verarbeitungsstatus in der Ansicht Sync History.
Verwaltbare Dokumenttypen
| Dokumenttyp | Beispiel | KI-Nutzen |
|---|---|---|
| Wartungshandbuch | Abläufe der regelmäßigen Inspektion je Anlage, Wechselintervalle für Schmieröl | Sofortige Bereitstellung geeigneter Maßnahmen bei erkannter Anomalie |
| SOP | Arbeitsabläufe je Prozess, Sicherheitsabläufe, Qualitätsprüfkriterien | Präzise Anleitung Schritt für Schritt |
| Sicherheitsvorschriften | MSDS für Chemikalien, Arbeitsschutzvorschriften, Notfallhandbuch | Sofortiger Vorschriftenbezug in Gefahrensituationen |
| Technische Spezifikation | Anlagenspezifikation, Sensordaten, zulässige Bereiche | Referenz für Grenzwerte zur Anomaliebewertung |
| Störungs-/Ausfallberichte | Frühere Ausfälle, Ursachenanalysen, Maßnahmen gegen Wiederholung | Ursachenvermutung anhand ähnlicher Fälle |
| Schulungsunterlagen | Einarbeitungsmaterial, Prozessbeschreibungen, Qualitätsschulung | Unterstützung der Schulung Vor-Ort |
Konfiguration
Suchparameter wie Embedding-Modell, Chunk-Größe oder Top-K gehören zur Konfiguration der LightRAG-Engine und lassen sich nicht über die Oberfläche ändern. Die aktuell wirksamen Werte können Sie in der Ansicht Config des RAG-API-Dashboards einsehen (Token und Passwörter werden maskiert dargestellt).
Im laufenden Betrieb anzupassen ist in der Regel nur die Synchronisierung.
| Position | Beschreibung |
|---|---|
| Synchronisierung aktiv | Schaltet die automatische Indizierung der Anlagendokumente aus der Platform ein und aus |
| Synchronisierungsintervall | Abstand, in dem auf Änderungen an Platform-Dokumenten geprüft wird |
| Dokumentanzahl je Durchlauf | Obergrenze der pro Durchlauf verarbeiteten Dokumente — zur Lastbegrenzung bei anfänglich großem Zulauf |
| Maximale Dateigröße | Dokumente oberhalb dieser Größe werden übersprungen |
Anwendungsszenarien
| Szenario | Suchbeispiel |
|---|---|
| Wartungsablauf prüfen | „Vorgehen beim Lagerwechsel am Injektor" → Wartungshandbuch |
| Sicherheitsvorschrift nachschlagen | „Vorgehen bei Stickstoffgas-Leckage" → Notfallhandbuch |
| Leitfaden für Störungsmaßnahmen | „Prüfpunkte bei Anomalie des Temperatursensors" → Inspektions-SOP |
| Frühere Fälle recherchieren | „Ausfallursache Injektor Linie 3 im Vorjahr" → Ausfallbericht |
| Spezifikation prüfen | „Zulässiger Temperaturbereich des Injektors" → Technische Spezifikation |