RAG (Suche in technischen Dokumenten)

Übersicht

PlantPulse RAG ist ein RAG(Retrieval-Augmented Generation)-Suchserver, der es der KI ermöglicht, technische Dokumente, Handbücher, SOPs und Vorschriften aus dem Fertigungsumfeld sofort zu durchsuchen und zu referenzieren.

Über 4 Suchmodi wird eine präzise und kontextbezogene Dokumentensuche bereitgestellt. Auch Tabellen, Abbildungen und Formeln in den Dokumenten werden beim Indizieren in Textform aufgelöst und mitdurchsucht.

Aufbau — die Oberfläche ist die RAG API, die Engine ist LightRAG

Die Dokumentensuche gliedert sich in zwei Schichten.

RAG API (plantpulse-rag-api) — die Schicht, in der Benutzer und KI tatsächlich zusammentreffen. Sie bietet die Dokumentenverwaltungsoberfläche und die Such-API.
LightRAG — die interne Engine, die die eigentliche Indizierung und Suche durchführt. Sie ist nicht nach außen exponiert und wird ausschließlich über die RAG API angesprochen.

Das heißt, es gibt keine Möglichkeit, die Adresse von LightRAG oder dessen WebUI (/webui) direkt zu öffnen. Alle Dokumentenarbeiten erfolgen auf der RAG-API-Oberfläche. (Der frühere eigenentwickelte Server plantpulse-rag wurde archiviert, und der Weg des direkten Uploads über die LightRAG-WebUI wurde zum 2026-07-30 durch die unten beschriebene Documents-Oberfläche ersetzt.)

Suchmodi

Modus	Beschreibung	Geeignete Situation
hybrid (Standard)	local + global — Entitäten und Beziehungen aus dem Wissensgraphen gemeinsam	Allgemeine Dokumentensuche (empfohlen)
naive	Nur Vektorähnlichkeit der Dokumentfragmente (ohne Graph)	Konzeptionelle Fragen, Suche nach ähnlichen Dokumenten
local	Fokus auf die in der Frage genannten Entitäten (Anlagen, Bauteile usw.)	Prüfung von Detailinhalten zu einem bestimmten Objekt
global	Fokus auf Beziehungen zwischen Entitäten	Übergreifende Informationen aus mehreren Dokumenten

Wird ein Modusname außerhalb dieser vier angegeben, erfolgt keine Suche, sondern eine Ablehnung (REST 422) → RAG-Algorithmus

Zugriffswege

Tätigkeit	Wo
Per Chat nachfragen	Fragen im Copilot — der Agent ruft über das MCP Gateway automatisch das Werkzeug `rag_search` der RAG API auf (siehe unten «Dokumentensuche im Chat nur über das Gateway»). Klickt man unter der Antwort auf eine Belegkarte (Dokument · Zeichnung · Video), öffnet sich der Originaltext, die Zeichnung bzw. das Video im rechten Panel neben dem Gespräch → Fragen — Rechtes Panel
Nur selbst suchen	Query-Ansicht im RAG-API-Dashboard
Dokumente hochladen · löschen · Liste ansehen	Documents-Ansicht im RAG-API-Dashboard
Ergebnisse der automatischen Synchronisierung prüfen	Sync History-Ansicht im RAG-API-Dashboard
Ursachen fehlgeschlagener Indizierung ansehen	Logs-Ansicht im RAG-API-Dashboard

Dokumentensuche im Chat nur über das Gateway — der Administrator muss sie eingeschaltet lassen

Der Copilot hat keine eingebaute Dokumentensuche. Die Dokumentensuche des Chats ist ausschließlich das RAG-Werkzeug rag_search hinter dem MCP Gateway.

Das Gateway schaltet rag_search · rag_list_documents von Anfang an ein. Schaltet der Administrator sie aus, findet der Chat keine Dokumente.
Findet der Chat keine Dokumente, prüft der Administrator unter AI-Verwaltungskonsole › MCP Gateway › Server, ob der Server RAG Gateway eingeschaltet ist, und unter Tools, ob rag_search eingeschaltet ist → AI-Verwaltungskonsole — MCP Gateway
Auf Benutzerseite ist die Chat-Werkzeugberechtigung (tool:mcp) erforderlich → Berechtigungen
Ist es ausgeschaltet oder antwortet das Gateway nicht, werden Fragen zu Handbüchern · Zeichnungen · Abläufen nicht beantwortet, sondern blockiert — «Die Dokumentensuche ist derzeit nicht verfügbar (MCP Gateway antwortet nicht) …» oder «Das Dokumentensuche-Tool ist ausgeschaltet oder für dieses Konto nicht zugelassen …» → Fragen — Wenn die Antwort abbricht oder stoppt
Abfragetest im RAG-API-Dashboard sowie Dokumentoriginal · Videowiedergabe laufen nicht über das Gateway. Funktionieren diese Ansichten, aber nur der Chat findet keine Dokumente, liegt es am Gateway.

Dokumentoriginal im Chat öffnen

Klickt man unter einer Antwort beim Fragen auf eine Dokument-Belegkarte, öffnet sich der Originaltext dieses Dokuments im rechten Panel. Es erfolgt kein Wechsel zur Dokumentenansicht und kein neuer Tab.

Dokument	Im Panel
PDF	Wird direkt im Panel über die PDF-Ansicht des Browsers angezeigt. In der Kopfzeile: In neuem Tab öffnen · Original herunterladen
Kein PDF-Format (Word, Excel, Textdatei usw.)	Wird nicht im Panel gezeichnet — „Dieses Format kann hier nicht angezeigt werden. Bitte das Original herunterladen und öffnen" sowie Original herunterladen
Browser, der PDF nicht im Fenster darstellen kann (z. B. Smartphone)	„Dieser Browser verfügt über keine PDF-Ansicht. Bitte das Original herunterladen und öffnen" sowie Original herunterladen
Dokument mit Zugriffsstufe	„Dies ist ein Dokument mit Zugriffskontrolle. Original kann weder geöffnet noch heruntergeladen werden" — keine Schaltflächen zum Öffnen bzw. Herunterladen

Findet die Dokumentensuche die von der Antwort erwartete Stelle, wird der Karte eine zitierte Passage angehängt (bei PDFs mit bekannter Seite z. B. „Seite 12"), und das Panel zeigt diese Passage oben an und öffnet sich auf dieser Seite. Dokumente ohne bekannte Seite (Nicht-PDF-Dokumente, nicht lesbare gescannte PDFs, Dokumente ohne bereits erzeugte Seiteninformation) öffnen auf Seite 1. Es ist auch häufig, dass keine Passage oder Seite angehängt wird — insbesondere bei Dokumenten mit Abbildungen oder gescannten Seiten wird keine Seite angegeben, um keine falsche Seite anzuzeigen. Die Passage ist entweder ein Satz aus dem Original oder eine Tabellenzeile.
🔴 Koreanische gescannte PDFs ohne Textebene können nicht gelesen werden. Bitte PDFs mit Textebene hochladen.
Berechtigungen und Zugriffsstufe werden bei jedem Öffnen erneut geprüft. Bei fehlender Berechtigung lautet die Antwort „Sie haben keine Berechtigung, dieses Dokument anzusehen" → Berechtigungen
Ist die Indizierung noch vorhanden, aber kein archiviertes Original mehr auffindbar, lautet die Antwort: „Originaltext kann nicht gefunden werden. Entweder gibt es kein archiviertes Original oder das Dokument wurde gelöscht."
Dokumente, die als Beleg zu einem Vorschlag angehängt sind, werden über dasselbe Panel geöffnet.
Der Titel der Dokumentkarte lautet „Anlagenname · Dokumentname" (bei direkt hochgeladenen Dokumenten „Gemeinsames Dokument · Dokumentname"), und in der Kopfzeile des Panels wird der Dokumentname angezeigt. Mehrere Stellen desselben Dokuments werden zu einer einzigen Karte zusammengefasst.
Dokumente, die die KI zwar durchsucht, aber nicht für die Antwort verwendet hat, werden nicht als Belegkarte angehängt.

Anders als in den Dialog eingefügte Dateien

Über Datei einfügen im Eingabefeld von Fragen eingefügte Dateien gelangen — auch Video · Audio — nicht in diese Dokumentensuche. Beides ist getrennt.

	Dokumentensuche (RAG)	In den Dialog eingefügte Dateien
Wer fügt ein	Administratoren (Bildschirm Documents · Verwaltungskonsole) · automatische Platform-Synchronisierung	Die fragende Person — Datei einfügen im Eingabefeld
Wo sie genutzt werden	Alle Dialoge aller Personen (im Rahmen von Berechtigungen · Zugriffsstufe)	Nur dieser eine Dialog — nur sein Eigentümer sieht sie
Wie die KI liest	Sucht relevante Stellen mit `rag_search`	Liest Seiten · Blätter · Folien der eingefügten Datei direkt, bei Video · Audio die Transkript-Abschnitte
Videowiedergabe	Alle angemeldeten Personen	Nur der Eigentümer dieses Dialogs
Wann gelöscht	Wenn der Administrator löscht oder das Dokument aus dem Hauptregister fällt	Zusammen mit dem Dialog, wenn dieser gelöscht wird

Dokumente, die viele Personen immer wieder nachschlagen (Handbücher · SOPs · Vorschriften), gehören in die Dokumentensuche. Dateien nur für die aktuelle Frage fügen Sie in den Dialog ein.
Eine Funktion, in den Dialog eingefügte Dateien in die Dokumentensuche zu übernehmen, gibt es nicht. Der Administrator lädt dieselbe Datei separat hoch.
Vorgehen und Obergrenzen (50 MB · Video · Audio 1 GB · 60 Minuten · 20 je Dialog · erste 100 Seiten) stehen unter KI-Chat — Dateien einfügen.

Zwei Wege, auf denen Dokumente hereinkommen

Dokumente werden auf zwei Arten indiziert. Je nachdem, über welchen Weg sie hereingekommen sind, unterscheidet sich die Verwaltung.

Weg	Quelle	Beschreibung
Automatische Synchronisierung	An Anlagen angehängte Dokumente der Plattform	Wird einer Anlage auf der Plattform ein Dokument angehängt, erfolgt die Indizierung regelmäßig automatisch. Ein separates Hochladen auf der RAG-Seite ist nicht nötig
Manueller Upload	Documents-Ansicht	Dokumente, die keiner Anlage zugeordnet sind (gemeinsame Vorschriften, Schulungsmaterial usw.), werden direkt hochgeladen. Das Original wird separat archiviert und bleibt auch bei einer Re-Indizierung erhalten

Anlagendokumente über die Plattform verwalten

Werden Anlagendokumente manuell in RAG hochgeladen, geraten sie in Widerspruch zum Dokumentenregister der Plattform. Einfacher ist es, Anlagendokumente auf der Plattform an die Anlage anzuhängen und die Indizierung der automatischen Synchronisierung zu überlassen.

Tabellen und Abbildungen in Dokumenten

Bei PDF · DOCX · PPTX · XLSX werden beim Indizieren Abbildungen, Tabellen und Formeln separat extrahiert; Abbildungen erhält Aura eine Beschreibung, mit der sie zusammen indiziert werden. Dadurch kann auch Inhalt, der sich in einer Abbildung befand, etwa „die Ventilnummer in dieser Zeichnung", durchsucht werden.

„Fragen" anhand eines Fotos ist keine RAG-Funktion

Der Suchbegriff ist Text. Das Anhängen eines Fotos an den Chat, um Messwerte oder Typenschildtext auslesen zu lassen, erledigt das Vision-Werkzeug; bei Bedarf sucht die KI anhand dieses Ergebnisses erneut im Dokumentenbestand → Fragen — Mit Foto fragen

Auch Zeichnungen und Videos werden durchsucht — müssen aber aktiviert werden

Wenn der Administrator dies aktiviert, indiziert RAG neben Dokumenten auch Zeichnungen sowie Video- und Audiomaterial. Beide sind standardmäßig deaktiviert.

Was	Unterstützte Formate	Was der Antwort angehängt wird	Schalter
Zeichnung	`dxf` · Vektor-PDF (beim Hochladen als «Zeichnung» gekennzeichnet, oder Dokumenttyp im Plattformregister ist Zeichnung)	Zeichnungskarte — hebt die Stelle in der Seitenvorschau hervor, Versionsbadge, Vergleich mit aktueller Version	`DRAWING_INGEST_ENABLED`
Video · Audio	Video `mp4` · `mov` · `mkv` · `webm`, Audio `m4a` · `mp3` · `wav`, Untertitel `srt` · `vtt`	Szenenkarte — Wiedergabe ab diesem Zeitpunkt direkt in der Antwort	Installationsschalter `PI_MEDIA_ENABLED`

Nutzung und Einschränkungen finden sich unter Mit Zeichnung fragen · Mit Video/Audio fragen, das Aktivieren unter Konfiguration. Wird Video/Audio aktiviert, wird im Eingabefeld von „Fragen" auch Per Sprache fragen (Mikrofon) mitaktiviert.

Bis ein Dokument durchsuchbar ist

문서 등록 (플랫폼 설비 첨부 / Documents 화면 업로드)
    │
    ▼
파싱 — PDF·DOCX·이미지에서 텍스트와 표를 추출
    │
    ▼
청킹 — 검색 단위로 잘게 나눔
    │
    ▼
임베딩 — 각 조각을 벡터로 변환
    │
    ├──▶ 벡터 저장소 (유사도 검색)
    └──▶ 지식 그래프 (엔티티·관계 추출)

Unmittelbar nach der Registrierung ist ein Dokument noch nicht durchsuchbar. Erst nach Abschluss von Parsing und Embedding erscheint es im Ergebnis; taucht ein gerade hochgeladenes Dokument nicht auf, prüfen Sie zuerst den Verarbeitungsstatus in der Sync History-Ansicht.

Es werden sechs Formate indiziert

Indiziert werden nur PDF · DOCX · PPTX · XLSX · MD · TXT (bei aktivierten Zeichnungen/Videos kommen die Formate aus der obigen Tabelle hinzu). Trifft die automatische Synchronisierung auf andere Dokumente, werden sie nicht indiziert, sondern mit gezählten Gründen für das Überspringen im Synchronisierungsergebnis vermerkt.

Grund des Überspringens	Bedeutung	Wo zu beheben
`ext_not_allowed`	Erweiterung außerhalb der sechs oben genannten	Format ändern und erneut anhängen
`ext_unknown`	Erweiterung unbekannt — kein Dateiformat im Register und auch kein Dateiendung im Dokumentnamen	Im Plattform-seitigen Dokumentenregister
`size_over_limit`	Maximale Dateigröße (Standard 50 MB) überschritten	Datei aufteilen oder Obergrenze erhöhen
`ingest_failed`	Empfangen, aber in der Indizierungsstufe fehlgeschlagen	`plantpulse-lightrag`-Log → Fehlerbehebung

Ob die Indizierung stillsteht, erkennt man an /health von ingest

Es kann vorkommen, dass trotz vollständig laufender Speicherkomponenten kein einziges Dokument hereinkommt. /health der RAG API zeigt das Ergebnis der letzten Synchronisierung mittels ingest an; ist es nicht ok oder disabled, gilt der gesamte status als degraded.

`ingest`	Bedeutung
`ok`	Die letzte Synchronisierung war erfolgreich
`error`	Die letzte Synchronisierung ist fehlgeschlagen
`unknown`	Bisher noch nicht gelaufen oder Verlauf kann nicht gelesen werden — nicht «normal»
`disabled`	Synchronisierung ist deaktiviert

Vollständige Re-Indizierung hebt «Ausschluss» nicht auf

Von einem Betreiber ausgeschlossene Dokumente bleiben auch nach einer vollständigen Re-Indizierung (Reindex All) weiterhin ausgeschlossen.

Verwaltbare Dokumenttypen

Dokumenttyp	Beispiel	KI-Einsatz
Wartungshandbuch	Anlagenspezifische Inspektionsverfahren, Austauschintervalle für Schmierstoffe	Sofortige Bereitstellung geeigneter Maßnahmen bei Anomalieerkennung
SOP	Prozessspezifische Arbeitsabläufe, Sicherheitsverfahren, Qualitätsprüfkriterien	Präzise Anleitung je Arbeitsschritt
Sicherheitsvorschriften	Chemikalien-Sicherheitsdatenblätter (MSDS), Arbeitsschutzvorschriften, Notfallhandbuch	Sofortiger Zugriff auf Vorschriften bei Gefahrensituationen
Technisches Datenblatt	Anlagenspezifikationen, Sensorspezifikationen, Toleranzbereiche	Referenzwerte für die Beurteilung von Anomalien
Störfall-/Ausfallbericht	Frühere Ausfallfälle, Ursachenanalyse, Maßnahmen zur Wiederholungsvermeidung	Ursachenschätzung anhand ähnlicher Fälle
Schulungsmaterial	Einarbeitungsmaterial für neue Mitarbeiter, Prozessbeschreibungen, Qualitätsschulung	Unterstützung bei Vor-Ort-Schulungen

Konfiguration

Suchparameter wie Embedding-Modell, Chunk-Größe und Top-K sind Einstellungen der LightRAG-Engine-Seite und können nicht über die Oberfläche geändert werden. Die aktuell geltenden Werte lassen sich in der Config-Ansicht des RAG-API-Dashboards einsehen (Tokens und Passwörter werden maskiert dargestellt).

Was im laufenden Betrieb häufig angepasst werden muss, betrifft in der Regel die Synchronisierung.

Punkt	Beschreibung
Synchronisierung ein/aus	Aktiviert/deaktiviert die automatische Indizierung von Anlagendokumenten der Plattform
Synchronisierungsintervall	Abstand, in dem Änderungen an Plattformdokumenten geprüft werden
Dokumentenanzahl pro Durchlauf	Obergrenze für die Verarbeitung je Zyklus — zur Lastregelung bei anfänglichem Massenimport
Maximale Dateigröße	Dokumente, die diese Größe (Standard 50 MB) überschreiten, werden übersprungen

Anwendungsszenarien

Szenario	Suchbeispiel
Wartungsverfahren prüfen	„Wie wechsle ich das Lager der Einspritzpumpe" → Wartungshandbuch
Sicherheitsvorschrift nachschlagen	„Vorgehen bei Stickstoff-Gaslecks" → Notfallhandbuch
Leitfaden bei Anomalien	„Prüfpunkte bei Temperatursensor-Anomalie" → Inspektions-SOP
Frühere Fälle durchsuchen	„Ursache des Einspritzpumpenausfalls auf Linie 3 im letzten Jahr" → Ausfallbericht
Maße · Platten in Zeichnungen	„Wo ist Ø62 H7?" → Zeichnung · Seite · Bereich (bei aktivierter Zeichnungserfassung)
Szenen aus Schulungsvideos	„Was muss vor dem Lagereinpressen geprüft werden?" → entsprechender Zeitpunkt im Wartungsschulungsvideo (bei aktiviertem Video/Audio)
Spezifikationen prüfen	„Zulässiger Temperaturbereich der Einspritzpumpe" → technisches Datenblatt

Übersicht​

Suchmodi​

Zugriffswege​

Dokumentoriginal im Chat öffnen​

Anders als in den Dialog eingefügte Dateien​

Zwei Wege, auf denen Dokumente hereinkommen​

Tabellen und Abbildungen in Dokumenten​

Auch Zeichnungen und Videos werden durchsucht — müssen aber aktiviert werden​

Bis ein Dokument durchsuchbar ist​

Es werden sechs Formate indiziert​

Verwaltbare Dokumenttypen​

Konfiguration​

Anwendungsszenarien​