KI-Verwaltungskonsole

Zum AI-Stack gehört eine Verwaltungskonsole. Sie sehen im Browser, ohne sich am Server anzumelden, wie ausgelastet die GPU ist, ob das LLM langsamer geworden ist und ob die Dokumentenindizierung ordnungsgemäß gelaufen ist.

Dieses Dokument folgt dem Prinzip ein Bildschirm, ein Abschnitt. Jeder Abschnitt enthält eine Bildschirmabbildung, und die Nummern in der Abbildung (① ② ③) entsprechen den Nummern in der Tabelle darunter. Die Nummern folgen der Leserichtung von oben nach unten. Wenn Sie die Konsole zum ersten Mal öffnen, gehen Sie einmal die Rundgang-Tour durch und schlagen Sie danach den Abschnitt zum jeweils benötigten Bildschirm nach.

Wer nutzt diese Konsole

Vor-Ort-Betreiber und Systemadministratoren. Da die Konsole größtenteils aus Lesebildschirmen besteht, kommt es durch versehentliches Klicken kaum zu Fehlfunktionen. Bildschirme, auf denen Werte geändert werden, sind in jedem Abschnitt gesondert mit Achtung gekennzeichnet.

---

Zugriff und Anmeldung

Die Adresse ist eine von drei Möglichkeiten. Fragen Sie den Administrator, welche davon zutrifft.

Form	Adresse	Anmerkung
Per IP im internen Netzwerk (HTTP)	http://<AI_SERVER_IP>:5959	PI_ADMIN_WEB_PORT, Standard 5959
Per IP im internen Netzwerk (HTTPS)	https://<AI_SERVER_IP>:5960	PI_ADMIN_WEB_TLS_PORT, Standard 5960. Der Proxy (plantpulse-proxy) terminiert TLS und leitet an die Konsole weiter
Installation mit Domain	https://admin.<COMPANY_DOMAIN>	Läuft über Port 443 des Proxys

HTTP und HTTPS sind beide geöffnet. Auch bei Zugriff über HTTP erfolgt keine Weiterleitung auf HTTPS.

Wenn Sie von vor 2026.09 aktualisiert haben

Bis 2026.09 befand sich die Konsole unter 9080. Ab 2026.10 wird Port 9080 nicht mehr verwendet — ändern Sie Lesezeichen und Firewall-Regeln auf 5959 · 5960. Die vollständige Portübersicht finden Sie unter Service-Port-Map.

Geben Sie auf dem Anmeldebildschirm (/login/) Benutzername und Passwort ein. Der Standard-Benutzername ist admin, das Passwort wird vom Administrator bei der Installation festgelegt. Nach der Anmeldung gelangen Sie zu dem Bildschirm zurück, den Sie ursprünglich öffnen wollten.

Es gibt nur ein Benutzerkonto

Die Konsole verwendet keine benutzerspezifischen Konten. Der Zugriff erfolgt über ein vom Betriebsteam gemeinsam genutztes Konto. Verwalten Sie das Passwort so, dass es nicht außerhalb des Teams weitergegeben wird. Die Kontokonfiguration finden Sie unter Konto und Sitzung.

Nach einer Anmeldung 8 Stunden gültig

Nach Ablauf von 8 Stunden müssen Sie sich erneut anmelden. Da sich die Konsole die zuletzt angezeigte Bildschirmadresse merkt, kehren Sie nach der Anmeldung dorthin zurück.

Auf Deutsch anzeigbar — im Original Koreanisch verfügbar

Die Konsole unterstützt English · 한국어. Wechseln Sie über die Sprachschaltfläche auf dem Anmeldebildschirm oder nach der Anmeldung über die Schaltfläche Sprache (Language) unten in der linken Leiste. Wenn Sie ?lang=ko an das Ende der Adresse anhängen, wird die koreanische Oberfläche geöffnet. In diesem Dokument sind die Namen der koreanischen Bildschirmelemente fett gesetzt, die englischen Bezeichnungen stehen zusätzlich in Klammern.

---

Bildschirmübersicht

Der vertikale Streifen links (die Leiste) wählt den Dienst aus, die Seitenleiste rechts daneben zeigt die Bildschirme dieses Dienstes an. Home und GPU haben keine Seitenleiste. Am unteren Rand der Leiste befinden sich Betriebshandbuch ↗ · Sprache · Abmelden.

Dass GPU und LLM oberhalb der eigentlichen Dienste stehen, ist beabsichtigte Reihenfolge. Was langsam oder ausgefallen ist, beginnt meist in der darunterliegenden Infrastruktur, daher führt das Durchgehen von oben nach unten schneller zur Ursache. Das MCP Gateway folgt direkt auf LLM — so sieht man das Modell und das Tor, durch das die vom Modell genutzten Werkzeuge gehen, nebeneinander.

Leiste (englische Bildschirme)	Bildschirme in der Seitenleiste
Home (Home)	—
GPU	—
LLM	Dashboard · Chat-Test · Modellregistrierung · API-Schlüssel · API-Endpunkt · Upstream-Status · Protokolle · Einstellungen
MCP Gateway (MCP Gateway)	Overview, Gruppe Gateway (Servers · Tools · Permissions · Client API Keys), Gruppe Tool Search (Search Test Bench · Search Settings), Gruppe Monitoring (Calls & Metrics) + Gemeinsames Menü (2026.10 Re-Release (2026-10-20))
RAG API	Dashboard, Indizierungsgruppe (Dokumente · Videos · Synchronisierungsverlauf · Zeichnungsregister), API-Gruppe (Abfragetest) + Gemeinsames Menü
Zeitreihe Insight (Timeseries Insight)	Dashboard, Analysegruppe (Anlage · Produktion · OEE · RAM · EMS · Alarm · System), KI-Autonomie · Profiling · Feature Store + Gemeinsames Menü
Dokumentenparsing (Document Parsing)	Dokumenten-Inspektion, Zeichnungsgruppe (Zeichnungserkennungstest) + Gemeinsames Menü
Vision (Vision)	Vision-Inspektion + Gemeinsames Menü
Digital Thread (Digital Thread)	Verbindungskarte · Graphspiegel + Gemeinsames Menü
Automatisierungs-Sandbox (Automation Sandbox)	Overview, Gruppe Execution (Run History · Run limits) + Gemeinsames Menü (ohne MCP-Serverinformationen)

Das gemeinsame Menü ist bei allen sechs — RAG API · Zeitreihe Insight · Dokumentenparsing · Vision · Digital Thread · MCP Gateway — identisch (die Automatisierungs-Sandbox hat dasselbe, nur ohne MCP-Serverinformationen): MCP-Serverinformationen · API-Endpunkt (MCP-Gruppe), Protokolle · API-Schlüssel (Betriebsgruppe) sowie Einstellungen am Ende der Liste. Hat man es einmal gelernt, ist es an allen sechs Stellen gleich. Es wird einmalig im Abschnitt Gemeinsames Menü am Ende dieses Dokuments erklärt.

Bildschirme für Vor-Ort-Aufgaben befinden sich nicht in dieser Konsole (2026.10)

Dinge, die Vor-Ort-Mitarbeiter sehen — wie Arbeitsbereitschaft, Anlagen-Zeitachse oder Plattenschilder in Zeichnungen — befinden sich im Copilot (Vor-Ort › Digital Thread /thread, Zeitachse im Anlagenbildschirm, Zeichnungskarten im Chat) → Copilot-Bildschirmübersicht. Die Digital-Thread-Leiste dieser Konsole enthält nur den Betreiberbildschirm, auf dem Konnektoren angebunden und der Spiegel überwacht werden. Der Betreiber sieht nicht das Ergebnis der Beurteilung, sondern «was an der Beurteilung hängt» → Bereitschaftsquellen.

Im Air-Gap-Netzwerk öffnet sich der Handbuch-Link nicht

Betriebshandbuch in der Leiste führt zu einer externen Website (docs.kopens.io). An Standorten ohne Internetzugang öffnet sich der Link nicht. Auf dem Server ist eine Kopie des Handbuchs mitinstalliert — wenden Sie sich an den Administrator.

Schmale Bildschirme — das Menü klappt in eine Schublade

Ist die Fensterbreite schmaler als 1024px, verschwinden Leiste und Seitenleiste von der linken Seite, und am oberen Bildschirmrand erscheint ein Streifen.

Nr.	Position	Funktion
①	Oberer Streifen, links ☰	Menü öffnen — Leiste und Seitenleiste öffnen sich als Schublade
②	Oberer Streifen	Logo und Produktname
③	Schublade (rechte Szene)	Dasselbe Menü wie Leiste · Seitenleiste bei breiten Bildschirmen. Im geöffneten Zustand überdeckt sie ① · ② des oberen Streifens
④	Abgedunkelte Fläche außerhalb der Schublade	Antippen schließt die Schublade

Die Schublade schließt durch Esc, Klick außerhalb, Klick auf einen Menüpunkt, Bildschirmwechsel oder Verbreiterung des Fensters auf 1024px oder mehr.

---

Rundgang

Wenn Sie die Konsole zum ersten Mal öffnen, gehen Sie diese Reihenfolge einmal durch. Ändern Sie dabei nichts — schauen Sie nur.

1. Home — Wenn die Zahl Down in der Zeile Systemstatus 0 ist, können Sie vorerst beruhigt sein.
2. GPU — Prüfen Sie, ob XID-Fehler 0 sind.
3. LLM → Dashboard — Prüfen Sie, ob der P95 pro Modell wie gewohnt aussieht.
4. RAG API → Dokumente — Prüfen Sie nur, ob indizierte Dokumente vorhanden sind.
5. Protokolle in derselben Seitenleiste — Die aktuellsten Protokolle erscheinen zuerst. Sie müssen nicht per SSH docker logs eingeben.

Zuerst den Gesamtstatus auf Home ansehen → in den auffälligen Dienst wechseln → Protokolle prüfen. Das ist der Kern dessen, was man in der Konsole meistens tut.

---

Home — /

Hier sehen Sie den Gesundheitszustand des gesamten AI-Stacks auf einen Blick und starten von hier aus in die einzelnen Dienstbildschirme. Der Status wird alle 20 Sekunden automatisch aktualisiert.

Nr.	Position	Funktion
①	Bildschirmkopf	Produktname und Untertitel — ein pro Installation anpassbarer Kopftext
②	Systemstatus (System Status)	Zählt alle überwachten Dienste nach Gesamt · Normal · Achtung · Down. Der Punkt oben ist die Gesamtbeurteilung, daneben stehen letzte Aktualisierungszeit und Aktualisieren-Schaltfläche. Klappt man Details auf, erscheinen Status und Antwortzeit je Dienst
③	Dienstkarten	Ein Dienst entspricht einer Karte. Gruppiert in Service-API · Model Serving · Speicher · Gateway · Tracing, damit man bei einer Störung in der Reihenfolge «aufrufende Seite → Serving-Seite → Speicher-/Beobachtungsseite» durchgehen kann

So liest man eine Karte:

• Der Statuspunkt rechts erscheint nur bei überwachten Diensten.
• Karten mit Pfeil können angeklickt werden. RAG API · Zeitreihe Insight · Vision · Dokumentenverständnis · Digital Thread öffnen einen Bildschirm innerhalb der Konsole, LLM-Proxy · Graph-DB öffnen den Bildschirm des jeweiligen Tools in einem neuen Fenster.
• Karten ohne Pfeil zeigen nur den Status an. Es handelt sich um interne Dienste, die vom Browser aus nicht direkt erreichbar sind.
• Die zweite Zeile der Karte beschreibt in maximal zwei Zeilen, was dieser Dienst tut. Zum Beispiel lautet die Beschreibung der RAG API „Indiziert und durchsucht Asset-Dokumente (PDF/Office), Zeichnungen (DXF/PDF), Videos und Audio“, die des Zeitreihen-Inferenzmodell-Servers „Modellserver für TSPulse-Anomalieerkennung und TTM-Prognose“.

Häufige Aufgaben

1. Klappen Sie Details auf. Einmal aufgeklappt, bleibt es beim nächsten Öffnen aufgeklappt.
2. Bewegen Sie den Mauszeiger über die Statusanzeige eines Dienstes im Zustand Achtung (gelbes Licht). Der vom Dienst selbst gemeldete Originalstatus erscheint zusätzlich im Tooltip — zum Beispiel, wenn der Dienst selbst läuft, aber die Datenbankverbindung unterbrochen ist.
3. Wechseln Sie in diesen Dienst und prüfen Sie die Protokolle.

In den ersten Sekunden erscheint grau

Solange der Status noch nicht empfangen wurde, ist der Punkt grau (nicht gemessen). Grau bedeutet nicht „normal“, sondern „noch unbekannt“.

---

GPU — /gpu/

Zeigt Auslastung, Temperatur und Fehler der GPU-Geräte an. Die Werte werden alle 5 Sekunden neu erfasst.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Zeitpunkt der letzten Erfassung — hier prüfen Sie, ob die Werte eingefroren sind
②	Zusammenfassungszeile	Geräte · Unified Memory · Host-CPU · XID-Fehler — zeigt auf einen Blick, wie ausgelastet die gesamte Hardware gerade ist und ob Hardwarefehler aufgetreten sind
③	Tabelle Geräte	Eine GPU entspricht einer Zeile. SM (Auslastung) · Speicherbandbreite · Temperatur · Speichertemperatur · Leistung · SM-Takt · Encode / Decode · XID werden spaltenweise verglichen, um auffällige GPUs zu finden
④	Verlauf	Grafik der letzten 60 Minuten — zeigt, ob der aktuelle Wert nur kurz ausgeschlagen hat oder dauerhaft hoch ist

Wenn XID nicht 0 ist, nicht einfach übergehen

XID-Werte sind von NVIDIA-Hardware oder -Treiber gemeldete Fehler. Ist der Wert nicht 0, erscheint in dieser Zeile eine rote Markierung. Ignoriert man sie, folgt meist als Nächstes ein Serverausfall. Notieren Sie den Wert genau und melden Sie ihn dem Systemadministrator.

---

LLM-Dashboard — /llm/

Zeigt Antwortzeit und Durchsatz der Model-Serving-Engine an. Werte werden alle 5 Sekunden erfasst.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Zeitpunkt der letzten Erfassung
②	Zusammenfassungszeile	Modelle · Aktiv · Warteschlange · Schlechtester P95 — zeigt auf einen Blick, ob die Engine ins Stocken gerät. Neben dem schlechtesten P95 steht der Warnschwellenwert
③	Tabelle Modelle	Ein Modell entspricht einer Zeile. Status · Aktiv · Warteschlange · Durchsatz · P50 · P95 · P99 · Abbrüche (1 Min) · KV-Cache · TPS (30 Min) zeigen, welches Modell langsam ist. Ein Strich (—) bedeutet, dass noch keine Messwerte vorliegen
④	Verlauf	Grafik der letzten 60 Minuten (1-Minuten-Fenster) für ein Modell — zeigt, wann die Verlangsamung begann

Bei der Meldung „Die Antworten sind in letzter Zeit langsam“ sehen Sie in der Spalte P95 nach (der 5.-schlechteste Wert von 100 Messungen). Liegt er deutlich über dem Normalwert, bestätigt dies den Eindruck.

---

Chat-Test — /llm/playground/

Sendet einen Prompt über das Model-Gateway (LiteLLM). Da dies derselbe Pfad ist, den auch Anwendungen nutzen, dient dies zur Unterscheidung von «Das Modell läuft, aber nur die Anwendung funktioniert nicht».

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und vom Gateway gemeldete Anzahl der Modelle
②	Karte Prompt	Modell über die Modell-Schaltflächen auswählen, System-Prompt (optional) · Max. Tokens und Prompt eingeben, dann Senden (Strg+Enter). Darunter erscheinen Antwort, benötigte Zeit sowie Eingabe-/Ausgabe-Tokens

Max. Tokens wird vom Server auf 2048 begrenzt

Unabhängig von der Eingabe schneidet der Server bei 2048 Tokens ab. Die Antwort kommt auf einmal (Streaming ist absichtlich deaktiviert). Da das Modell vor der eigentlichen Antwort «denkt», kann bei kleinem Budget die Grenze erreicht werden, bevor Antworttext erscheint — der Bildschirm weist in diesem Fall darauf hin. Da dieselbe GPU auch den Copilot bedient, kann eine lange Antwort Zeit benötigen.

---

Modellregistrierung — /llm/models/

Registriert externe Modellendpunkte am Gateway. Egal ob intern oder kommerziell — Voraussetzung ist OpenAI-Kompatibilität.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Aktualisieren
②	Zusammenfassungszeile	Im Betrieb · Konfigurationsdatei · Hier registriert — zählt die vom Gateway gerouteten Modelle nach Herkunft. Nur was «hier registriert» wurde, kann hier bearbeitet werden
③	Modell hinzufügen (Add a model)	Registriert einen neuen Endpunkt — Modellname · Provider-Pfad · Endpunkt · Provider-API-Schlüssel · API-Version · Typ eingeben, dann Verbindungstest und Registrieren
④	Im Betrieb befindliche Modelle	Liste der aktuell bedienten Modelle — nur Zeilen mit Herkunft = «Diese Konsole» können gelöscht werden

Häufige Aufgaben

1. Geben Sie Modellname (Name, unter dem die aufrufende Seite model übergibt), Provider-Pfad (LiteLLM-Format, z. B. openai/gpt-4o) und Endpunkt ein. Bei Endpunkten, die einen Schlüssel benötigen, geben Sie den Provider-API-Schlüssel ein. API-Version wird nur bei Azure OpenAI verwendet.
2. Wählen Sie den Typ (Chat · Completion · Embedding · Rerank) korrekt. Bei falscher Wahl erscheint ein funktionierender Endpunkt als defekt.
3. Prüfen Sie die Antwort mit Verbindungstest und registrieren Sie dann mit Registrieren.

Dieser Bildschirm ändert Werte

• Standardmodelle mit der Herkunft Konfigurationsdatei (litellm-config.yaml) können hier nicht bearbeitet werden — diese Datei ist maßgeblich.
• Beim Löschen beginnt der Aufrufer sofort zu scheitern, der unter diesem Namen aufruft.
• Registrierung · Test · Löschung werden im Audit-Log protokolliert (der Provider-Schlüssel selbst wird nicht gespeichert, nur sein Fingerabdruck).

Registrierte Provider-Schlüssel werden mit Salt verschlüsselt

Der hier eingegebene Provider-API-Schlüssel wird mit PI_LITELLM_SALT_KEY verschlüsselt gespeichert. Ändert sich der Salt, bleibt das registrierte Modell in der Liste sichtbar, nur Aufrufe schlagen dann stillschweigend fehl → Passwörter · API-Schlüssel ändern

---

LLM-API-Schlüssel — /llm/api-keys/

Erstellt, erneuert und löscht virtuelle Schlüssel für Anwendungen. Hat denselben Namen wie API-Schlüssel im gemeinsamen Menü, erfüllt aber eine andere Funktion — dort wird geprüft, «ob unser Schlüssel funktioniert», hier werden «an andere auszugebende Schlüssel» erstellt.

Position	Funktion
Zusammenfassungszeile	Schlüssel · Verbrauch · Gesperrt — wie viel ausgegebene Schlüssel genutzt wurden und ob welche gesperrt sind
Schlüssel ausstellen (Issue a key)	Name · Maximales Budget (USD) · Gültig bis (z. B. 30d, 24h, 1mo) festlegen und Ausstellen. Leer gelassen bedeutet unbegrenzt
Tabelle Ausgestellte Schlüssel	Pro Schlüssel Hash · Modell · Nutzung / Budget · Status · Gültig bis, am Zeilenende Neu ausstellen · Löschen

Ein ausgestellter Schlüssel wird nur einmal angezeigt

Weder Konsole noch Gateway speichern den Klartext. Wurde er direkt nach der Ausstellung nicht kopiert, muss er neu ausgestellt werden. Bei Neuausstellung oder Löschung funktioniert der aktuelle Wert sofort nicht mehr. Ausstellung · Neuausstellung · Löschung werden im Audit-Log protokolliert (der Schlüsselwert selbst nicht).

Auch LLM hat einen API-Endpunkt-Bildschirm (/llm/api-endpoints/). Er listet alle API-Endpunkte des Gateways auf und sieht genauso aus wie der entsprechende Bildschirm im Gemeinsamen Menü.

---

Upstream-Status — /llm/operations/

Testet, ob die Modelle hinter dem Gateway tatsächlich antworten. Jede Prüfung ist ein tatsächlicher Aufruf.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Prüfung ausführen — ruft erst bei Betätigung alle Modelle tatsächlich einmal auf
②	Zusammenfassungszeile	Anzahl Fehlerfrei · Nicht fehlerfrei — zeigt auf einen Blick, ob ein Modell nicht antwortet
③	Tabelle Endpunkte	Pro Modell Status und Details — zeigt die vom Gateway gelieferten Werte unverändert an, sodass die Fehlerursache direkt ablesbar ist

---

LLM-Protokolle — /llm/logs/

Eine Zeile entspricht einer über das Gateway gelaufenen Anfrage. Unterscheidet sich von Protokolle im gemeinsamen Menü (Service-Protokolldateien).

Position	Funktion
Bildschirmkopf	Start · Ende → Übernehmen — den anzuzeigenden Zeitraum festlegen
Tabelle	Zeit · Modell · Typ · Tokens · Latenz · Kosten · Anfrage-ID — findet langsame oder teure Anfragen

Prompt- und Antworttext befinden sich hier nicht — diese stehen im Phoenix-Trace.

---

LLM-Einstellungen — /llm/config/

Zeigt, wie die Konsole den LLM-Stack erreicht, und welche Werte das Gateway meldet. Nur Lesezugriff.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Aktualisieren
②	Gateway (Gateway)	Gateway-Adresse und -Schlüssel, die die Konsole verwendet. Der Schlüssel wird nur als Fingerabdruck angezeigt, Klartext erscheint erst beim Klick auf das Augensymbol, diese Anfrage wird zusammen mit dem Benutzernamen im Audit-Log protokolliert
③	Metrik-Abfrageziele (Metric poll targets)	Liste der Engines, die das LLM-Dashboard direkt abfragt — ist das Dashboard leer, prüfen Sie hier, ob ein Ziel fehlt
④	Vom Gateway bekannte Modelle (Models the gateway knows)	Liste der vom Gateway gemeldeten Modelle unverändert — die Konsole führt keine eigene separate Liste

Für Anwendungen virtuelle statt Master-Schlüssel verwenden

Den Master-Schlüssel des Gateways hält der Konsolenserver und sendet ihn nicht an den Browser. Geben Sie Anwendungen den im Bildschirm LLM-API-Schlüssel ausgestellten virtuellen Schlüssel — dort lassen sich Budget, Ablauf und Widerruf separat festlegen.

---

RAG-Dashboard — /rag/

Zeigt den Indizierungsstatus des Dienstes (RAG API), der dem Chatbot ermöglicht, auf Grundlage interner Dokumente zu antworten.

Nr.	Position	Funktion
①	Indexierungsbetrieb (Indexing Operations)	Bildschirmname, letzte Aktualisierung, Aktualisieren
②	Zusammenfassungszeile	Alle Dokumente · Indiziert · Wartend · Fehlgeschlagen — zählt, ob Dokumente aus dem Plattform-Hauptbuch bis zur Indizierung gelangt sind
③	Scheduler	Nächste Ausführung · Letzte Ausführung samt Ergebniszusammenfassung — zeigt, ob die Synchronisierung rechtzeitig läuft

Darunter folgen die Tabelle Backend-Erreichbarkeit (ob LightRAG · PostgreSQL · Graph-DB · Vektor-DB · Plattform erreichbar sind) und der Indizierungsstatus pro Asset. Sind Fehlgeschlagen nicht 0 oder liegt Nicht erreichbar vor, prüfen Sie die Protokolle des jeweiligen Dienstes.

---

Dokumente — /rag/documents/

Zeigt indizierte Dokumente an, lädt Dokumente hoch oder indiziert sie neu. Bei der Meldung „Der Chatbot findet das Dokument nicht“ schauen Sie zuerst hier nach.

Nr.	Position	Funktion
①	Bildschirmkopf	Hochladen (öffnet den Hochlade-Dialog) · Aktualisieren · Jetzt synchronisieren (holt Plattformdokumente sofort erneut) · Alle neu indizieren
②	Zusammenfassungszeile	Dokumente · Indiziert · Wartend · Fehlgeschlagen — zeigt, ob Dokumente unvollständig indiziert oder fehlgeschlagen sind
③	Dokumententabelle	Asset · Dokument · Status · Indiziert am · Aktion. Über die Aktion am Zeilenende: Detailansicht · Neu indizieren · Original herunterladen · Suchtest mit diesem Dokument · Aus dem Korpus ausschließen/wieder einschließen · Löschen (nur direkt hochgeladene Dokumente)

Häufige Aufgaben — wenn der Chatbot ein Dokument nicht findet

1. Prüfen Sie in der Tabelle, ob dieses Dokument vorhanden ist — fehlt es, wurde es nicht indiziert.
2. Ist es vorhanden, suchen Sie im Bildschirm Suchtest mit diesem Dokument oder Abfragetest am Zeilenende mit einer ähnlichen Formulierung wie der Benutzeranfrage.
3. Prüfen Sie im Synchronisierungsverlauf, ob die letzte Synchronisierung fehlerfrei abgeschlossen wurde.

Während die Indizierung läuft, aktualisiert sich der Status automatisch im Sekundentakt, ein manuelles Neuladen ist nicht nötig.

Ist die Zeichnungsindizierung (DRAWING_INGEST_ENABLED) aktiviert, zeigt die Zeichnungszeile unter dem Dokumentennamen zusätzlich Zeichnungsnummer · Blatt · Teilenummer sowie ein Blattschild (Aktuellstes Blatt · Altes Blatt (aktuell …) · Änderung läuft · Nicht bestätigbar) an. Um Zeichnungen nach Blatt zusammengefasst zu sehen, öffnen Sie das Zeichnungsregister.

• Auch PDF-Zeichnungen, bei denen die Zeichnungsnummer aus dem Schriftfeld nicht gelesen werden konnte, erscheinen als Zeichnungszeile — unter dem Namen steht „Zeichnung · Zeichnungsnummer konnte nicht aus dem Schriftfeld gelesen werden“. Dies soll verhindern, dass sie wie ein normales Dokument erscheinen.
• Die Schaltfläche Aus der Suche ausschließen in der Zeichnungszeile verhält sich je nach Herkunftsweg der Zeichnung unterschiedlich.
  • Bei Zeichnungen aus dem Plattform-Hauptbuch (Herkunft PLATFORM) ist die Schaltfläche Aus dem Korpus ausschließen / wieder einschließen wie bei normalen Dokumenten aktiv. Da das Hauptbuch maßgeblich ist, kann hier nicht gelöscht werden — zum Ausschluss aus der Suche dient diese Funktion.
  • Bei direkt in der Konsole hochgeladenen Zeichnungen ist die Schaltfläche nicht aktiv (abgeblendet). Beim Überfahren mit der Maus erscheint „Manuell hochgeladene Zeichnungen können nicht aus der Suche ausgeschlossen werden — löschen oder neu indizieren Sie die Zeichnung (Zeichnungen aus dem Plattform-Hauptbuch können ausgeschlossen werden)“.
  • Neu indizieren · Original herunterladen funktionieren für jede Zeichnung, Löschen nur für direkt hochgeladene.

Der Antworttext bei fehlendem Beleg ist nicht fest vorgegeben

Dieser Text wird jeweils vom LLM generiert und ist daher jedes Mal anders. Beurteilen Sie nicht anhand eines bestimmten Wortlauts, sondern daran, ob die Zahl der indizierten Treffer 0 ist.

Das Löschen eines Dokuments kann nicht rückgängig gemacht werden

Löschen ist nur bei direkt hochgeladenen Dokumenten (Kennzeichnung manuell) möglich. Ein gelöschtes Dokument kann vom Chatbot nicht mehr als Beleg genutzt werden, um es wieder hinzuzufügen, muss die Originaldatei neu hochgeladen werden. Löschen Sie es nicht, wenn Sie die Originaldatei nicht mehr besitzen. Bei aus der Plattform stammenden Dokumenten schließen Sie es stattdessen aus dem Korpus aus.

Alle neu indizieren

Alle neu indizieren indiziert «sämtliche» Plattformdokumente neu. Dokumente werden schrittweise neu erfasst, sodass keine Indizierungslücke entsteht, direkt hochgeladene Dokumente sind davon nicht betroffen. Da dies dennoch Zeit kostet, verwenden Sie diese Funktion nur bei Bedarf.

Hochlade-Dialog — gemeinsam für Dokumente · Zeichnungsregister · Videos

Drei Bildschirme öffnen denselben Dialog. Je nach Aufrufstelle unterscheiden sich nur Anfangswert und akzeptierte Formate.

Aufrufstelle	Schaltfläche	Dialog
Dokumente	Hochladen	Akzeptiert alle unten genannten Formate. PDF wird anfangs als Dokument erkannt
Zeichnungsregister	Zeichnung hochladen	Titel „Zeichnung hochladen“, PDF wird anfangs als Zeichnung erkannt
Videos	Video hochladen	Titel „Video/Audio hochladen“, akzeptiert nur Video · Audio · Untertitel. Werden Dokumente/Zeichnungen hineingezogen, blockiert der Dialog mit „Hier werden nur Video, Audio und Untertitel akzeptiert“

Nr.	Position	Funktion
①	Asset	Suche nach Asset-ID oder -Name zur Auswahl. Ohne Auswahl wird gemeinsam (_manual) hochgeladen und ist an kein Asset gebunden
②	Drop-Bereich · Akzeptierte Formate	Mehrere Dateien gleichzeitig ablegen oder über Datei auswählen wählen. Die Leiste darunter zeigt die aktuell akzeptierten Formate und die maximale Größe je Format — deaktivierte Formate sind Aus
③	Dateiliste	Pro Datei Typ (Tabelle unten) und Status (Bereit · Blockiert · Lädt hoch · Fertig · Fehlgeschlagen). PDF-Zeilen haben eine Schaltfläche zur Auswahl Dokument / Zeichnung, mit Alle als PDF lässt sich alles auf einmal ändern
④	Blockierte Zeile	Vor dem Senden wird in dieser Zeile der Blockierungsgrund angezeigt (siehe unten)
⑤	N Dateien hochladen	Sendet die Dateien nacheinander, eine nach der anderen — da die RAG-Indizierung nur eine gleichzeitig schreiben kann

Erweiterung	Typ
pdf · docx · pptx · xlsx · md · txt	Dokument (bei PDF wählbar: Dokument / Zeichnung)
dxf	Zeichnung
mp4 · mov · mkv · webm	Video
m4a · mp3 · wav	Audio
srt · vtt	Untertitel

Wählt man bei PDF Zeichnung, wird es als Zeichnung indiziert (document_kind=drawing wird mitgesendet). Ist die Zeichnungsindizierung (DRAWING_INGEST_ENABLED) deaktiviert, erscheint „Die Zeichnungsindizierung ist deaktiviert … PDF wird als normales Dokument indiziert“, und das PDF wird zum normalen Dokument.

Blockierungen vor dem Senden

Fall	Angezeigter Grund
.dwg	„DWG wird nicht akzeptiert — exportieren Sie als DXF oder PDF und laden Sie erneut hoch.“
Video/Audio bei deaktivierter Video-/Audio-Erfassung	„Die Video-/Audio-Erfassung ist deaktiviert — setzen Sie in der Installations-env PI_MEDIA_ENABLED=true …“
Untertitel bei deaktivierter Untertitel-Erfassung	„Die Untertitel-Erfassung ist deaktiviert (MEDIA_TEXT_TRACKS).“
DXF bei deaktivierter Zeichnungsindizierung	„Die Zeichnungsindizierung ist deaktiviert (DRAWING_INGEST_ENABLED) — DXF kann nicht indiziert werden.“
Größe überschritten	„Zu groß — überschreitet das Limit von … für …“ Die Obergrenze liegt bei Dokumenten/Zeichnungen bei SYNC_MAX_FILE_MB (Bundle-Wert 50 MB), bei Video/Audio bei MEDIA_MAX_FILE_MB (Standard 2048 MB), bei Untertiteln bei 5 MB
Leere Datei	„Leere Datei.“

• Welche Funktionen aktiviert sind und welche Obergrenzen gelten, legt nicht der Dialog fest, sondern wird aus der Konfiguration der RAG API gelesen. Kann die Konfiguration nicht gelesen werden, erscheint „Die rag-api-Konfiguration konnte nicht gelesen werden — Format und Größe werden vom Server beurteilt.“, und es werden nur .dwg sowie unbekannte Erweiterungen blockiert.
• Hier hochgeladene Dateien bleiben als manuell (direkt hochgeladen) markiert und werden von der Synchronisierung nicht gelöscht.
• Beim Hochladen einer Zeichnung erscheint in der Ergebniszeile Zeichnungsnummer · Blatt · Maße · Anzahl Stücklistenzeilen, bei Video/Audio endet die Zeile mit „In die Transkriptions-/Indizierungswarteschlange eingereiht“ — die Transkription beginnt im Verarbeitungszeitfenster.
• Ist derselbe Name bereits in einer anderen Form (Zeichnung / normales Dokument) indiziert, lehnt der Server ab — zuerst löschen oder den Dateinamen ändern.

---

Videos — /rag/videos/

Zeigt Reparatur-, Schulungs- und Anlagenbetriebs-Videos und Audio pro Datei an — ob transkribiert wurde, ob Szenenbilder entstanden sind, ob die Suchindizierung erfolgt ist. Schauen Sie hier zuerst, wenn im Chat ein Video nicht als Beleg für eine Antwort erscheint. Wie Videos im Chat genutzt werden, steht unter Videosuche.

Bei deaktivierter Video-/Audio-Erfassung

Es wird nur der Hinweiskasten „Die Video-/Audio-Erfassung ist deaktiviert“ angezeigt, keine Tabelle. PI_MEDIA_ENABLED=true in der Installations-env-Datei ist der zugehörige Schalter — nach Aktivierung und Neuerstellung des Stacks akzeptiert die RAG API Videos, und der Transkriptionsserver (ASR) startet. Zuvor besitzt die RAG API keinen Video-Pfad, und Video-Uploads werden abgelehnt → Umgebungskonfiguration

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Zusammenfassungszeile	Dateien · Indiziert · Wartend/In Bearbeitung · Fehlgeschlagen (Fehlgeschlagen · Übersprungen) · Leere Transkription · Fehlt in Suche (Anzahl indizierter, aber nicht im Suchindex enthaltener Abschnitte)
③	Werkzeugzeile	Suche nach Datei/Asset (Dateiname · Asset-ID · Teil des Asset-Namens) · Nur Probleme (nur Fehlgeschlagen · Übersprungen · leere Transkription · Abschnitte fehlen in Suche) · Aktualisieren · Video hochladen (öffnet den Hochlade-Dialog nur für Video/Audio/Untertitel)
④	Rechts in der Werkzeugzeile	Verarbeitungszeitfenster — wann Transkription/Indizierung beginnen (siehe unten)
⑤	Tabelle	Datei · Asset · Dauer · Status · Transkription (Zeichenzahl · Abschnittszahl) · Szenen (Anzahl Szenenbilder) · Hochgeladen am · Aktion
⑥	Aufgeklappte Zeile	Beim Aufklappen erscheinen Player, Transkription mit Zeit-Chips (Klick spielt ab diesem Zeitpunkt), zugeordnete Untertiteldatei, Verarbeitungsinfo (Sprache · indizierte Abschnitte · ASR-Modell · Aktualisierungszeit usw.)
⑦	Aktionen am Zeilenende	Es erscheinen nur zum Status passende Schaltflächen — bei indizierten Zeilen in der Abbildung Erneut transkribieren (↻) und Löschen (nur direkt hochgeladen), bei fehlgeschlagenen/übersprungenen Zeilen Erneut versuchen (siehe unten)

Verarbeitungszeitfenster. Videotranskription beansprucht die GPU stark und beginnt daher nur in einem festgelegten Zeitfenster. In der Zeile erscheint eine von drei Meldungen.

• „Verarbeitungszeitfenster … — Wird gerade verarbeitet“
• „Verarbeitungszeitfenster … — Wartende Datei startet um …“
• „Kein Verarbeitungszeitfenster-Limit“

Das Zeitfenster wird über MEDIA_PROCESSING_WINDOW festgelegt. Leer gelassen bedeutet 20:00-06:00 (bezogen auf die Installations-Zeitzone PP_TZ), always bedeutet jederzeit. Das Zeitfenster gilt nur für den «Beginn» der Verarbeitung — eine bereits gestartete Verarbeitung läuft auch nach Schließen des Fensters bis zum Ende durch → Umgebungskonfiguration

Status

Status	Bedeutung
Wartend	Wartet auf das Verarbeitungszeitfenster
Wird abgerufen · Transkribiert · Wird indiziert	Wird gerade verarbeitet
Indiziert	Wird in der Suche verwendet
Kein Ton · Keine Sprache	Keine Tonspur vorhanden oder keine Sprache erkannt — bei Videos mit Sprache erneut transkribieren
Übersprungen · Fehlgeschlagen	Konnte nicht verarbeitet werden — Grund im aufgeklappten Zustand prüfen und erneut versuchen
Wird gelöscht	Löschung läuft gerade

Aktionen

Aktion	Erscheint bei	Funktion
Erneut versuchen	Fehlgeschlagen · Übersprungen	Stellt die Datei wieder in die Warteschlange. Startet im nächsten Verarbeitungszeitfenster
Erneut transkribieren	Indiziert · Keine Sprache · Kein Ton	Transkribiert von vorn. Die bisherige Transkription wird verworfen, neue Abschnitte ersetzen nach Indizierung die alten
Löschen	Nur direkt hochgeladene (manuell)	Löscht Abschnitte, Transkription und gespeichertes Original. Videos aus dem Plattform-Hauptbuch können hier nicht gelöscht werden

• Solange Zeilen in Bearbeitung sind, lädt der Bildschirm alle 5 Sekunden automatisch neu. Sind nur Wartend-Zeilen vorhanden, erfolgt kein erneutes Laden (da das Warten auf das Zeitfenster Stunden dauern kann).
• Ist Leere Transkription nicht 0, übergehen Sie dies nicht einfach. Bei einem Video mit Sprache, dessen Transkription leer ist, kann der Chat dieses Video nicht als Beleg heranziehen — prüfen Sie gemäß dem Hinweis in der aufgeklappten Zeile das ASR-Modell und führen Sie dann Erneut transkribieren (oder Erneut versuchen) aus.
• Ab Re-Release 4 vom 2026.10 verwirft die Transkription den ersten Satz nach Stille/Rauschen nicht mehr, und die Zeitstempel der verbleibenden Sätze werden auf die tatsächliche Sprache angepasst. Zuvor transkribierte Videos werden nicht automatisch erneut verarbeitet — Videos mit fehlendem ersten Satz oder abweichenden Quellzeitstempeln sollten erneut transkribiert werden — die erneute Erfassung erfolgt im Verarbeitungszeitfenster (leer gelassen 20:00-06:00).
• Zeitangaben (Hochladen · nächster Start) werden in der Installations-Zeitzone (PP_TZ) angezeigt. m:ss im Transkriptions-Chip entspricht der Position im Video.

---

Synchronisierungsverlauf — /rag/sync-history/

Verlauf der Synchronisierungsläufe, die Asset-Dokumente aus der Plattform abrufen. Bleibt auch nach einem Neustart erhalten.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname, Anzahl erfasster Läufe, Aktualisieren
②	Tabelle	Pro Lauf Start · Auslöser · Assets · Hauptbuch · Indiziert · Verschwunden · Karten · Dauer · Ergebnis — zeigt, was zu welchem Zeitpunkt hinzukam oder fehlte, und ob ein Lauf fehlgeschlagen ist

Steht in der obersten Zeile bei Ergebnis der Wert Fehler, prüfen Sie die Protokolle der RAG API rund um diesen Zeitpunkt.

---

Zeichnungsregister — /rag/drawings/

Zeigt in RAG indizierte Zeichnungen (DXF · Vektor-PDF) nach Zeichnungsnummer gruppiert, eine Zeile pro Blatt. Gibt es mehrere Dateien zum selben Blatt (DXF und PDF, aus Plattform-Hauptbuch und direkt hochgeladen), werden sie in einer Zeile zusammengefasst. Dient zur Klärung von „Entspricht die vor Ort hängende Zeichnung dem aktuellsten Blatt?“ oder „Wurde das Schriftfeld korrekt gelesen?“.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Zusammenfassungszeile	Zeichnungen · Blätter · Alte Blätter · Nicht erkannt — wie viele alte Blätter und fehlgeschlagene Erkennungen vorliegen
③	Filterzeile	Suchfeld (Zeichnungsnummer oder Teilenummer — findet auch über Teile des Dokumentnamens, Groß-/Kleinschreibung wird nicht unterschieden) · Nur alte Blätter · Nur Erkennungsfehler · Aktualisieren · Zeichnung hochladen (Hochlade-Dialog, bei dem PDF von vornherein als «Zeichnung» erkannt wird)
④	Tabelle	Zeichnungsnummer · Blatt · Teilenummer · Blattstatus · Dateien · Erkennung · Hochgeladen am. Innerhalb derselben Zeichnungsnummer steht das neuere Blatt oben. Der Pfeil links in der Zeile öffnet Seitenvorschau (Seiten blättern) und die erkannten Schriftfeldwerte
⑤	Spalte Dateien	Format-Chip der Dateien dieses Blatts — der dunklere Chip ist die repräsentative Datei (die vom Chat-Karten/Vorschau geöffnete Datei)
⑥	Rechts in der aufgeklappten Zeile	N Dateien dieses Blatts — Format · Hauptbuch/manueller Upload · Asset · Dateiname, bei der repräsentativen „(Repräsentativ — wird mit dieser Datei geöffnet)“. Die Auswahl erfolgt in der Reihenfolge verwendbare Datei → DXF-Original → Plattform-Hauptbuch
⑦	Spalte Vergleich	Gibt es zwei oder mehr Blätter zur selben Zeichnungsnummer, erscheint bei der neueren Zeile die Schaltfläche Mit Blatt ○ vergleichen — vergleicht mit dem direkt darunterliegenden Blatt

Feld	Wert	Bedeutung
Blattstatus	Aktuellstes Blatt · Altes Blatt (aktuell ○) · Änderung läuft · Nicht bestätigbar	Antwort, die durch Abfrage von Freigabeblatt und Konstruktionsänderung im PLM anhand der Teilenummer erhalten wird. Nicht bestätigbar bedeutet nicht «aktuell», sondern «unbekannt» — der PLM-Konnektor fehlt oder antwortet nicht → Digital Thread
Erkennung	Schriftfeld gelesen · Kein Schriftfeld · Fehlgeschlagen (mit Grund) · In Bearbeitung	Sagt nur aus, ob die Zeichnungsnummer aus dem Schriftfeld gelesen wurde, und ob die Indizierung fehlgeschlagen ist. Auch PDF-Zeichnungen, bei denen die Zeichnungsnummer nicht gelesen werden konnte, erscheinen im Register und zählen mit Kein Schriftfeld zu Nicht erkannt
Hochgeladen am	—	Wird in der Installations-Zeitzone (PP_TZ) angezeigt

Klickt man auf Vergleich, öffnet sich darunter Zusammenfassung · Konfidenz · Punkt Nicht vergleichbar sowie eine Änderungstabelle (Schriftfeld · Maße · Stückliste · Hinweise mit Hinzugefügt · Entfernt · Geändert), und über dem Bild des neuen Blatts werden die geänderten Bereiche markiert. Erneuter Klick schließt die Ansicht.

Bei deaktivierter Zeichnungsindizierung

Am Bildschirmkopf erscheint „Die Zeichnungsindizierung der rag-api ist deaktiviert (DRAWING_INGEST_ENABLED)“, Seitenvorschau · Blattstatus · Blattvergleich sind nicht nutzbar. Werkseinstellung ist deaktiviert. Zum Aktivieren siehe Umgebungskonfiguration.

Um zu sehen, wie auch Maße und Stückliste gelesen wurden

Die Spalte Erkennung im Register gibt nur Auskunft über Schriftfeld und Indizierungsfehler. Laden Sie dieselbe Datei im Zeichnungserkennungstest hoch — dort kommt derselbe Erkenner zum Einsatz, den RAG bei der Zeichnungsindizierung verwendet.

---

Abfragetest — /rag/query/

Führt eine direkte Suche über indizierte Dokumente durch. Da dies demselben Vertrag wie die von Konsumenten genutzte Abfrage-API entspricht, wird genau nachgebildet, worauf sich der Chatbot als Beleg stützt.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Abfragefeld	Frage eingeben, Suchmodus (hybrid · local · global · naive · mix, Standard hybrid) wählen und Abfrage ausführen (Strg+Enter). Darunter erscheinen Antwort, benötigte Zeit, Quellen

Erscheint das gewünschte Dokument nicht bei Quellen, versuchen Sie es mit einem anderen Modus erneut.

---

Zeitreihe-Insight-Dashboard — /insight/

Zeigt den Status der Engine (Zeitreihe Insight), die in Anlagendaten nach Anomalien sucht und Vorhersagen trifft. Von allen Diensten hat dieser das umfangreichste Menü.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname
②	Statusmeldung	Zeigt, ob der Dienst und seine abhängigen Komponenten alle antworten — unterschieden in Normal / Abnormal / Serververbindungsfehler
③	Zusammenfassungszeile	Anomalieerkennung · Prognose · MCP-Tools · Scheduler — Anzahl der von dieser Engine gebotenen Analysen/Tools und geplanten Jobs
④	Pipeline-Tabelle	Letzte Ausführungszeit pro Feature-Store-Pipeline — zeigt, ob das Ausgangsmaterial für die Analyse rechtzeitig erzeugt wird

Darunter folgen die Beschreibung Analysebereiche und Systeminformationen (KI-Modell · Betriebszeit · Scheduler · Prognosemodell).

---

Anomalieerkennung — /insight/anomaly/asset/ und andere

Berechnet einen Anomaliewert für die aktuellen Daten eines Ziels und ermittelt, welche Tags/Kennzahlen am stärksten vom Normalwert abweichen. Die folgenden sechs Bildschirme haben dasselbe Format (Häufigkeitsanomalie bei Alarm siehe Abschnitt Alarmanalyse unten).

Seitenleiste	Pfad	Ziel
Anlage › Anomalieerkennung	/insight/anomaly/asset/	Sensor-Tags einer Anlage
Produktion › Anomalieerkennung	/insight/anomaly/order/	letzte Arbeitsaufträge (Achse ist nicht Zeit, sondern Auftragsreihenfolge)
OEE › Anomalieerkennung	/insight/anomaly/oee/	kumulierte OEE, umgerechnet in Veränderungsrate (Delta) von Verfügbarkeit · Leistung · Qualität
RAM › Anomalieerkennung	/insight/anomaly/ram/	Zuverlässigkeit · Verfügbarkeit · Instandhaltbarkeit (MTBF/MTTR)
EMS › Anomalieerkennung	/insight/anomaly/ems/	kumulierter Energieverbrauch (Strom/Brennstoff), umgerechnet in Veränderungsrate
System › Anomalieerkennung	/insight/anomaly/system/	CPU/Speicher/Festplatte des Erfassungshosts

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und verwendetes Modell
②	Parameter	Zu analysierendes Asset und Bereich (Datenintervall · Zeilenlimit · Schwellenwert · Abfragebereich · letzter Abschnitt · Top-K) festlegen und Anomalieerkennung ausführen. Als Ergebnis öffnen sich Zusammenfassungszeile, Zeitreihe + Anomaliewert, Anomalie-Rangliste, Antwortdaten samt Hinweiskarte darunter

Häufige Aufgaben

1. Asset-ID wählen und Anomalieerkennung ausführen klicken.
2. Das oberste Tag aus der Anomalie-Rangliste nehmen und in Zeitreihe + Anomaliewert den tatsächlichen Wert zum Zeitpunkt des Ausschlags prüfen.
3. Für dasselbe Asset den Prognose-Bildschirm öffnen, um zu sehen, wohin sich die Entwicklung bewegt.

Der Wert bedeutet nicht „Defekt“, sondern „weicht vom Üblichen ab“

Der Wert wird «innerhalb» des angeforderten Fensters auf 0–1 neu skaliert, daher können auch in einem ruhigen Fenster Punkte nahe 1 erscheinen. Ändert man das Fenster, ändert sich auch der Wert desselben Punkts. Lesen Sie auch den Punkt Leicht missverständlich in der Hinweiskarte unter dem Ergebnis.

Ab 2026.10 sind OEE · RAM · EMS im Menü

In früheren Versionen befanden sich diese drei Gruppen nicht in der Seitenleiste und waren nur über die Adresse erreichbar. Jetzt erscheinen sie als Gruppe unter Anlage · Produktion.

---

Prognose — /insight/forecast/asset/ und andere

Prognostiziert den nächsten Zeitabschnitt eines Ziels und zeichnet das Konfidenzintervall als Band ein. Die folgenden sechs Bildschirme haben dasselbe Format (Ausfallprognose bei Alarm siehe Abschnitt Alarmanalyse unten).

Seitenleiste	Pfad	Ziel
Anlage › Prognose	/insight/forecast/asset/	Sensor-Tags einer Anlage
Produktion › Qualitätsprognose	/insight/forecast/order/	Qualität/OEE/Energie der nächsten Aufträge
OEE › Prognose	/insight/forecast/oee/	zukünftiger Verlauf der OEE
RAM › Prognose	/insight/forecast/ram/	Zuverlässigkeit · Verfügbarkeit · Instandhaltbarkeit (MTBF/MTTR)
EMS › Prognose	/insight/forecast/ems/	Energieverbrauch
System › Prognose	/insight/forecast/system/	CPU/Speicher/Festplatte des Erfassungshosts

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und verwendetes Modell
②	Parameter	Zu prognostizierendes Asset und Länge (Datenintervall · Zeilenlimit · Kontextlänge · Prognoselänge · Abfragebereich · Konfidenzintervall) festlegen und Prognose ausführen. Als Ergebnis öffnen sich Zusammenfassungszeile (Dauer · Modell · Konfidenzintervall · Kontext), Prognoseergebnis, Antwortdaten samt Hinweiskarte

Wenn als Modell NAIVE angezeigt wird

Nur wenn in der Zusammenfassungszeile bei Modell TTM steht, handelt es sich um eine echte Prognose. NAIVE bedeutet, dass TTM fehlgeschlagen ist und ein Ersatzwert zurückgegeben wurde. Die Prognoselänge beträgt maximal 96 Punkte, bei größerer Eingabe wird nicht abgeschnitten, sondern abgelehnt.

---

Gesundheitsindex — /insight/asset/health/

Zeigt eine Anlage als eine einzige Punktzahl zwischen 0 und 100 und gleichzeitig die Abzüge, die diese Punktzahl gemindert haben.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname — Erklärung, dass der Score Sensor · OEE · RAM · EMS · Alarm zusammenfasst
②	Parameter und Hinweiskarte	Asset-ID · Datenintervall festlegen und Gesundheitsindex prüfen. Als Ergebnis öffnen sich Score · Score nach Bereich · Antwortdaten. Die Hinweiskarte (Details / Einklappen) erklärt, wie der Score zu lesen ist und welcher Bildschirm als Nächstes sinnvoll ist

Das Ergebnis wird 60 Sekunden lang wiederverwendet

Klickt man innerhalb von 60 Sekunden erneut, wird nicht neu berechnet, sondern das vorherige Ergebnis angezeigt. Bereiche ohne Daten werden nicht als normal gewertet, sondern vom Score abgezogen — bei unzureichender Beobachtung bleibt die Bewertung als „-“ zurückgestellt.

Stillstand mindert nur bei «ungeplant» den Score

Rüsten · geplanter Stillstand · Kalender-Betriebsruhe · außerhalb der Schicht mindern den Score nicht. Bereiche mit kurzem Verlauf fallen nicht mit 0 Punkten, sondern mit zurückgestellter Bewertung heraus (held_domains in den Antwortdaten), und die dann vergebene Bewertung ist vorläufig (grade_provisional) → Zeitreihe-Insight-Tools — Gesundheitsindex richtig lesen

---

Alarmanalyse — /insight/alarm/…

Die fünf Bildschirme der Seitenleistengruppe Alarm. Alle haben dasselbe Format: oben Parameter mit Asset und Bereich eingeben, Ausführen-Schaltfläche klicken, darunter öffnen sich Ergebnis, Antwortdaten und Hinweiskarte. Die Abbildung zeigt Häufigkeitsanomalie.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Parameter	Asset · Priorität · Aggregationsfenster · Zeilenlimit · Schwellenwert · Top-K festlegen und Anomalieerkennung ausführen. Vor der Ausführung steht an der Ergebnisstelle nur ein Hinweistext

Seitenleiste	Pfad	Ausführen-Schaltfläche	Zeigt
Häufigkeitsanomalie	/insight/alarm/anomaly/	Anomalieerkennung ausführen	zu welcher Tageszeit sich Alarme häufen
Ausfallprognose	/insight/alarm/forecast/	Prognose ausführen	wie viele Alarme künftig je Fenster erwartet werden
Dauernanalyse	/insight/alarm/duration/	Dauernanalyse	ob derselbe Alarm zunehmend länger aktiv bleibt (Erkennung von Verschlechterung)
Sensorkorrelation	/insight/alarm/correlation/	Korrelationsanalyse	an welchen Sensor-Tags der Alarm hängt
Statistik	/insight/alarm/stats/	Statistik abrufen	Alarmanzahl · Prioritätsverteilung · Top-Alarme nach Einstellung und Tag

Sensorkorrelation ist kein Korrelationskoeffizient

Dieser Bildschirm «zählt» Alarme nach Tag und Tageszeit. Es handelt sich um häufig gemeinsam aufgetretene Tags, nicht um erwiesen gemeinsam bewegte Tags. Gibt es bei Statistik im Zeitraum keine Alarme, erscheint kein Fehler, sondern 0 und eine leere Liste.

---

KI-Erkenntnisse — /insight/findings/

Zeigt, was die KI vor Ort bemerkt hat (verfehlte Aufträge · Datenabriss · KI-Änderungen · Prozessanomalie · Sensordefekt). Offene Einträge erscheinen zuerst. Befindet sich in der Seitenleistengruppe KI-Autonomie.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Aktualisieren
②	Zusammenfassungszeile	Offen · Dringend · Schweregrad hoch · Bestätigt — wie viele Einträge aktuell einer Prüfung durch einen Menschen bedürfen
③	Statusfilter	Eingrenzung der Liste auf Nicht geschlossen · Offen · Bestätigt · Geschlossen. Daneben zusätzliche Eingrenzung nach Typ und Asset
④	Tabelle	Pro Erkenntnis Typ · Asset · Schweregrad · Inhalt · Letzte Beobachtung · Status, am Zeilenende Bestätigen · Schließen — hinterlässt einen Hinweis, dass man es gesehen bzw. bearbeitet hat

Häufige Aufgaben

1. Den Inhalt einer offenen Erkenntnis lesen und mit Bestätigen signalisieren, dass man sie gesehen hat.
2. Ist die Bearbeitung abgeschlossen, Schließen klicken und im Bestätigungsdialog erneut bestätigen.

Geschlossene Erkenntnisse öffnen sich nicht erneut, solange dieselbe Bedingung fortbesteht

Bestätigung/Schließung werden unter dem Namen des angemeldeten Administrators protokolliert und zusätzlich im Konsolen-Audit-Log (insight.write) gespeichert.

---

Autonome Verbesserung — /insight/autonomy/

Zeigt, was die KI eigenständig warum geändert hat, und bietet die Möglichkeit, anzuhalten oder zurückzusetzen.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Aktualisieren
②	Aktueller Modus (Current mode)	Aktueller Modus (Automatisch · Nur Vorschlag · Aus), wer ihn wann festgelegt hat, letzte nächtliche Ausführung. Hier befinden sich auch die Schaltfläche zum Moduswechsel und der Not-Aus-Schalter Ausschalten
③	Zieltabelle	Pro Verbesserungsziel Aktuell verwendete Version · In Erprobung · Wartender Kandidat · Status, am Zeilenende Zurücksetzen · Fortsetzen (bei Anhalten) · Austausch genehmigen (bereiter Kandidat im Modus «Nur Vorschlag»)

Darunter folgt das Änderungsprotokoll (Change log) mit je einer Zeile zu Zeitpunkt · Ort · Vorgang · Verantwortlichem.

• Eingrenzung nach Zeitraum (7 · 30 · 90 Tage, Standard 7 Tage) und Entscheidung. Es werden jeweils 50 Einträge angezeigt, mit Mehr anzeigen weiter geladen.
• Zeilen mit Übersprungen sind standardmäßig ausgeblendet. Mit Auch Übersprungene anzeigen werden sie eingeblendet. Der Text über der Zeile nennt Gesamtanzahl, sichtbare und ausgeblendete Anzahl.

Modus	Funktion
Automatisch	Die KI prüft, testet und tauscht eigenständig gemäß Kriterien aus und setzt bei Verschlechterung selbst zurück
Nur Vorschlag	Prüft und testet neue Versionen, wartet vor einer Änderung aber auf Genehmigung
Aus	Es wird nichts geprüft, ausgetauscht oder zurückgesetzt. Das aktuell verwendete bleibt unverändert

Dieser Bildschirm ändert Werte

Moduswechsel · Ausschalten · Austausch genehmigen · Zurücksetzen · Fortsetzen werden nach einem Bestätigungsdialog sofort wirksam, der geänderte Modus bleibt auch nach einem Neustart erhalten. Alle Vorgänge werden unter dem Namen des angemeldeten Administrators im Änderungsprotokoll und im Konsolen-Audit-Log (insight.write) festgehalten. Im Notfall ist Ausschalten der Not-Aus-Schalter.

---

Scorer-Vergleich (Shadow) — /insight/shadow/

Führt einen modellfreien Scorer auf den aktuellen Daten eines Assets aus, um zu sehen, was er erkannt hätte, wäre er aktiv.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Eingabe	Asset-ID · Letzte Minuten eingeben und Bewertung ausführen. Als Ergebnis öffnen sich Zusammenfassung Alarmabschnitte · Alarmminuten · Keine Beurteilung · Sensoranomalie sowie eine Tabelle mit verwendeten Kriterien und Abschnitten

Nur Lesezugriff

Es wird nichts gespeichert und keine Benachrichtigung gesendet. Die laufende Anomaliebeurteilung bleibt unverändert.

---

Anlagenprofilierung — /insight/profile/asset/

Versteht Tags eines Assets automatisch anhand tatsächlicher Daten — was jedes Tag misst, der Normalbereich und dessen Konfidenz.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname, rechts Asset-Auswahl und Profil neu laden
②	Hauptbereich	Vor Auswahl eines Assets erscheint nur ein Hinweistext. Nach Auswahl öffnen sich Zusammenfassungszeile und die Tabs Tag-Verständnis · Beziehungsgraph

Im Tab Tag-Verständnis werden pro Tag Typ · Normalbereich · Alarmgrenze · Konfidenz angezeigt, im Tab Beziehungsgraph berechnet Beziehungsanalyse ausführen gemeinsam auftretende Tags sowie Vorläufer-→-Folger-Beziehungen (kann einige Dutzend Sekunden dauern).

---

Pipeline-Status — /insight/feature/status/

Zeigt, ob die aufbereiteten Daten (Feature Store), die die obigen Analysen verwenden, derzeit ordnungsgemäß erzeugt werden. Sind Analyseergebnisse leer oder veraltet, liegt die Ursache meist hier.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname, Aktualisieren, Alle ausführen — führt die Pipelines sofort gesammelt aus
②	Scheduler-Jobs	Pro Job Auslöser und Nächste Ausführung — zeigt, ob die geplanten Läufe aktiv sind
③	Pipelines	Pro Pipeline Letzte Ausführung und Auslöser, pro Zeile eine Ausführen-Schaltfläche — findet lange nicht gelaufene Pipelines und führt gezielt nur diese aus

Darunter zeigt die Karte Backfill-Status laufende Backfills und den letzten Fehler.

Die übrigen drei Bildschirme derselben Gruppe Feature Store.

Seitenleiste	Pfad	Funktion
Ausführungsverlauf (Run History)	/insight/feature/history/	vergangene Pipeline-Läufe — Ausführungszeit · Dauer · Verarbeitet · Status · Bemerkung
Feature-Daten (Feature Data)	/insight/feature/data/	Abfrage von Asset-Features (Asset-ID · Intervall · Anzahl Abfragen → Features abfragen), Textsuche, Ähnliche Assets (Vektorsuche)
Backfill (Backfill)	/insight/feature/backfill/	Startdatum · Enddatum · Pipeline wählen und Backfill starten — füllt fehlende Abschnitte nach. Läuft bereits ein Backfill, kann kein neuer gestartet werden

Backfill belastet den Server

Da hier vergangene Abschnitte neu berechnet werden, dauert dies bei großem Bereich lange und erhöht die Serverlast. Führen Sie dies zu produktionsarmen Zeiten und auf den benötigten Bereich eingegrenzt aus. Bei Erstanwendung wird eine Rücksprache mit dem Administrator empfohlen.

---

Dokumenten-Inspektion — /parser/

Lädt ein Dokument hoch und zeigt genau, wie der Dokumentenparsing-Dienst es liest (den Text, den RAG indiziert hätte). Dient dazu, sich vor Vertrauen in das RAG-Indizierungsergebnis zu vergewissern. In der Seitenleiste heißt der Bildschirm Dokumenten-Inspektion.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und der von diesem Bildschirm aufgerufene Dienst
②	Eingabe	Parsing-Profil (default · fast · ocr · scan) wählen und ein Dokument (PDF · DOCX · PPTX · XLSX · Bild) hineinziehen oder über Datei auswählen laden. default entspricht denselben Einstellungen wie die RAG-Indizierung, bei anderer Wahl wird „Abweichung vom Standard“ angezeigt
③	unter ②	Hinweiskarte — erklärt, was das gewählte Profil bewirkt (bei default: „Wie RAG dieses Dokument gelesen hat“). Mit Einklappen schließbar

Das Ergebnis erscheint in der nebenstehenden Karte Geparstes Markdown, in der Zusammenfassungszeile darüber stehen Dauer · Konfidenz · Zeichenzahl · Zeilenzahl. Ist das Ergebnis leer und handelt es sich um ein gescanntes Dokument, versuchen Sie es erneut mit dem Profil scan.

Zu jedem gewählten Profil gehört unter ② eine Hinweiskarte (③), die erklärt, was dieses Profil tut, wann es verwendet wird und worauf zu achten ist.

Profil	Kartentitel	Kernaussage
default	„Wie RAG dieses Dokument gelesen hat“	Dieselben Parsing-Optionen wie bei der RAG-Indizierung. Der hier angezeigte Text ist der, den RAG indiziert hätte, fehlende Inhalte kennt RAG ebenfalls nicht
fast	„Wie dieses Dokument bei deaktiviertem OCR und schnellem Lesen aussieht“	OCR ist deaktiviert, Text in gescannten Dokumenten/Bildern erscheint nicht. Unterscheidet sich von dem, was RAG gesehen hat
ocr	„Was reine Textextraktion aus diesem Dokument liefert“	Tabellenstrukturen werden nicht erkannt, Tabellen werden zu Fließtext aufgelöst. Die OCR-Funktion der Vision-Konsole verwendet dieses Profil
scan	„Wie dieses Dokument gelesen wird, wenn die Textebene verworfen und komplett per OCR gelesen wird“	Auch eine intakte Textebene wird verworfen und per OCR gelesen. Bei digital erstellten PDFs liefert default genauere Ergebnisse

• Zusätzliche Grenzwerte in der Karte — Uploads über die Konsole sind auf 100 MB begrenzt (bei Überschreitung 413). Diese Konsolengrenze greift schon vor der eigenen Obergrenze des Diensts (MAX_DOCUMENT_BYTES, Standard 200 MiB). Der Bildschirm fragt den Fortschritt alle 2 Sekunden ab und bricht das Warten nach ca. 5 Minuten ab — das Parsen selbst wird dadurch nicht abgebrochen.
• Hier hochgeladene Dokumente dienen nur der Ergebnisanzeige und werden danach verworfen. Sie werden nicht in RAG indiziert.
• Selbst wenn scan nachweislich besser ist, ändert das hier gewählte Profil nicht die RAG-Konfiguration. Um dasselbe Ergebnis auch in RAG zu erzielen, muss die OCR-Einstellung (DOCLING_*) des Dokumentenparsings geändert werden.
• Zeichnungen (DXF · PDF) werden nicht auf diesem Bildschirm, sondern im Zeichnungserkennungstest geprüft.

---

Zeichnungserkennungstest — /parser/drawings/

Lädt eine Zeichnungsdatei hoch und zeigt, was der Dokumentenverständnisdienst wo in dieser Zeichnung erkennt. Befindet sich in der Seitenleistengruppe Zeichnungen. Da hier derselbe Erkenner verwendet wird, den RAG bei der Zeichnungsindizierung nutzt, dient dies zur Klärung von „Der Chatbot nennt falsche Maße aus der Zeichnung“.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Beschreibung
②	Zeichnung	Datei hineinziehen oder per Klick auswählen und Zeichnung erkennen. Zulässige Formate und Größenobergrenze werden vom Dienst festgelegt, der Hinweistext unter dem Upload-Bereich zeigt sie an
③	Zusammenfassungszeile	Format · Seiten · Maße · Stücklistenzeilen · Schriftfeld (Gefunden · Nicht gefunden) · Warnungen
④	Seitenbild	Zeichnet erkannte Positionen als farbige Rahmen auf das Seitenbild. Typ-Schaltflächen (Schriftfeld · Maße · Stückliste · Hinweise) blenden Rahmen ein/aus
⑤	Erkennungstabelle	Schriftfeld · Maße (Toleranzen) · Stückliste · Hinweise · Bereiche in Tabellenform. Klick auf eine Zeile hebt den zugehörigen Rahmen hervor
⑥	Zwei-Blatt-Vergleichstest	Zwei Dateien derselben Zeichnung (Altes Blatt · Neues Blatt) hochladen und Vergleichen — zeigt Änderungen bei Schriftfeld · Maßen · Stückliste · Hinweisen sowie geänderte Bereiche

Spalte «Ober-/Untergrenze» in der Maßtabelle. Gibt bei jedem Maß zusätzlich an, woher die Toleranzgrenzen stammen.

Anzeige in der Zelle	Bedeutung
Wertebereich „unten ~ oben“ + (Formel)	Geschätzter Wert, aus einem Passungssymbol der Zeichnung (z. B. H7) über die ISO-Passungsformel berechnet — kann von Normtabellen im µm-Bereich abweichen
Wertebereich „unten ~ oben“ + (Zeichnung)	Entspricht genau dem in der Zeichnung mit ± angegebenen Wert
Nicht berechnet	Keine Berechnung erfolgt — Grund erscheint beim Überfahren mit der Maus
Allgemeintoleranz …	Bei Maßen ohne eigene Toleranzangabe die von der Zeichnung vorgegebene Allgemeintoleranzklasse (ohne Zahlenwert)

Gibt es mindestens einen «Formel»-Wert, erscheint unter der Tabelle: „«Formel» ist ein per ISO-Passungsformel geschätzter Wert — … Die Gut/Schlecht-Beurteilung sollte anhand vorhandener Normdokumente geprüft werden.“

Karte „Prüfung geometrischer Toleranzrahmen“. Prüft, ob die geometrischen Toleranzrahmen der Zeichnung den Regeln entsprechen. Im Kopf stehen die Allgemeintoleranzangabe und die Datum-Buchstaben der Zeichnung, pro Zeile Schweregrad (Fehler · Warnung · Information), betroffenes Zeichen, Inhalt, Begründung (Normnummer · Konzeptname). Klick auf eine mit einem Maß verknüpfte Zeile hebt dieses Maß im Bild hervor. Gibt es keine regelwidrigen Rahmen, erscheint „Keine regelwidrigen Rahmen gefunden.“

Hinweiskarte. Unter dem Upload-Bereich „Was aus dieser Zeichnung herausgelesen wurde“, unter dem Vergleichstest „Was sich zwischen den beiden Blättern geändert hat“ — diese Karten erklären was · wann · wie zu lesen ist. Kernpunkte:

• Auch die Zeichnungsindizierung von RAG verwendet dieses Erkennungsergebnis. Hier fehlende Maße kennt auch RAG nicht.
• Hier hochgeladene Zeichnungen dienen nur der Ergebnisanzeige und werden danach verworfen. Sie werden nicht in RAG indiziert — indizierte Zeichnungen finden Sie im Zeichnungsregister.
• Bei gescannten PDFs ohne Textebene kann der Text dieser Seite nicht gelesen werden. Dieser Erkenner führt kein OCR durch.
• Zeigt der Vergleich keinerlei Änderung, sind beide Blätter entweder identisch oder der Vergleich war nicht möglich — unterscheiden Sie dies anhand der Liste Nicht vergleichbar und der Konfidenz.

Bernsteinfarbene Warnungen sind kein Fehlschlag

Schriftfeld nicht gefunden · Keine Textebene (gescannte Seite) · Standard-Bereichsraster (keine Randskala) teilen lediglich mit, «wie» der Dienst gelesen hat. Gescannte PDFs ohne Textebene lassen keine Maßlesung zu.

DWG wird nicht akzeptiert

Dateien außerhalb der zulässigen Formate werden vom Dienst samt Grund abgelehnt. Exportieren Sie DWG im CAD als DXF oder PDF und laden Sie diese hoch.

---

Vision-Inspektion — /vision/

Lädt ein Bild hoch und prüft, was der Vision-Dienst tatsächlich erkennt.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und der von diesem Bildschirm aufgerufene Dienst
②	Anfrage	Operation wählen (Inspektion · Instrumentenablesung · Textextraktion · Klassifizierung · Freie Frage · Objekterkennung), Bild hochladen und Ausführen
③	Hinweiskarte	Was die gewählte Operation tut, wie das Ergebnis zu lesen ist (Details / Einklappen)

Nach der Ausführung erscheinen die Zusammenfassungszeile Probe · Übereinstimmung · Abweichung sowie die Karten Bild · Ergebnis. Bei Objekterkennung werden Rahmen ins Bild gezeichnet.

„Keine Beurteilung möglich“ ist eine normale Antwort

Der Vision-Dienst stellt dem Modell mehrere Anfragen und benötigt eine ausreichende Übereinstimmung der Antworten, um ein Ergebnis zu liefern (meist 2 von 3, bei Instrumentenablesung 4 von 5). Weichen die Antworten voneinander ab, wird kein erfundener Wert zurückgegeben, sondern Keine Beurteilung möglich. Erneutes Klicken liefert dasselbe Ergebnis — machen Sie stattdessen ein neues Foto. Freie Frage durchläuft diese Übereinstimmungsprüfung nicht — verwenden Sie sie nicht für Ablesewerte oder Beurteilungen.

---

Verbindungskarte — /thread/

Zeigt auf einer Karte, wie der Digital Thread mit externen Systemen verbunden ist. Zu Konnektorregistrierung, Feldbindung und Synchronisierungs- ablauf siehe Digital Thread.

Nr.	Position	Funktion
①	Bildschirmkopf	Ansichtsschaltflächen (Karte · Liste · Bereitschaftsquellen), Konnektor hinzufügen (vierstufige Registrierung in einem Seitenfenster), Aktualisieren
②	Zusammenfassungszeile	Konnektoren · Aktiv · Konformitätsfehler · Tools — wie viele Verbindungen aktiv laufen
③	Karte	Filterzeile oben (Familie · Status) und Karte. Von links nach rechts: externes System → Konnektor → Tool → Bindung → Werksgraph. Grün = aktiv, Rot = Konformitätsfehler, Grau = aus. Klick auf einen Knoten öffnet im Seitenfenster Konfiguration, Konformitätsergebnis und letzte Aktionsaufrufe, die Karte hebt dabei nur die Kette dieses Knotens hervor

So wird die Karte bedient:

• Sie öffnet sich anfangs auf 1x-Größe zentriert. Konnektoren werden zuerst in der Familienreihenfolge ERP → MES → PLM → SCM → Terminplanung angeordnet, übrige Familien folgen alphabetisch.
• Ziehen zum Verschieben, Mausrad für Hoch/Runter, Strg+Mausrad zum Zoomen. Die Schaltflächen oben rechts sind Vergrößern · Verkleinern · Gesamtansicht.
• In der Filterzeile über der Karte nach Familie · Status eingrenzen (wirkt nur auf die Karte). Filter zurücksetzen stellt den Ausgangszustand wieder her.
• Die Kartenminiaturansicht ist standardmäßig ausgeblendet. Mit Miniaturansicht anzeigen in der Werkzeugleiste einblenden.
• Bei vielen Konnektoren und unübersichtlicher Karte nutzen Sie die Liste — Name · Familie · System · Endpunkt · Status · Ebene · Tools · Anmeldedaten · Konformität.
• Die Familienliste unter Konnektor hinzufügen zeigt anfangs erp · mes · plm · scm · sched · qm.

Jetzt synchronisieren im Seitenfenster eines Konnektors spiegelt dessen Bindungen sofort in den Graphen und schließt im Ursprung verschwundene Verbindungen (sie werden nicht gelöscht, sondern mit Endzeitpunkt versehen — darauf basiert der Verbindungsverlauf). Nach Abschluss erscheint „N Objekte · N Verbindungen synchronisiert“. Wurde die vom Konnektor gelieferte Liste abgeschnitten, erscheint zusätzlich die gelbe Zeile „Diese Synchronisierung hat verschwundene Verbindungen nicht geschlossen — die Erfassung war unvollständig (…). Geschlossen wird erst bei einer vollständig gelesenen Synchronisierung.“ — mit einer unvollständigen Liste würden sonst auch intakte Verbindungen geschlossen. Aktive Konnektoren synchronisiert der Dienst auch periodisch automatisch → Digital Thread — Konnektor-Synchronisierung

Ändernde Aktionen werden im Audit-Log protokolliert

Konnektorregistrierung/-bearbeitung/-löschung, Erkennung, Test, Synchronisierung und Feldbindung werden unter dem Namen des angemeldeten Administrators im Konsolen-Audit-Log (thread.write) festgehalten. Aktionswerkzeuge (🔒) werden nicht von der Konsole aufgerufen — der Copilot vermittelt sie über genehmigte Vorschlagskarten.

---

Bereitschaftsquellen — dritte Ansicht der Verbindungskarte

Zeigt aus Sicht des Betreibers, worauf sich die Schichtleiter-Arbeitsbereitschaft (Go/No-Go je Prozess) des Copilots bei ihrer Beurteilung stützt. Das Beurteilungsergebnis (welcher Prozess blockiert ist) befindet sich nicht hier, sondern im Copilot-Bildschirm. Hier sieht man, «welcher Konnektor an welchem Punkt hängt, ob diese Daten aktuell sind und was bei Fehlen passiert». Die Ansichtsschaltfläche erscheint nur, wenn der Digital-Thread-Dienst in einer Version läuft, die diese Funktion bietet.

Nr.	Position	Funktion
①	Kopfzeile	Zeitpunkt und Status der letzten Beurteilung (Beurteilt · Veraltete Quelle — Beurteilung gestoppt · Kein MES — keine Beurteilung), Jetzt neu messen
②	Punkt · Verdrahtung	Pro Punkt (acht insgesamt) Verdrahtet (grün) · Teilweise verdrahtet (orange) · Fehlt (grau)
③	Quelle (Familie · Tool → Konnektor)	Pro Eingabe Erforderlich · Eines von zweien · Optional, über welches Tool welcher Familie gelesen wird, Name des liefernden Konnektors. Sind Daten älter als die Obergrenze, erscheint ein orangefarbenes Schild Veraltet. Klick auf den Konnektornamen führt zurück zur Karte und öffnet das Seitenfenster dieses Konnektors
④	Bei Fehlen	Was passiert, wenn eine Quelle fehlt — Beurteilung «Unbekannt», oder ohne MES-Arbeitsauftrag wird die gesamte Beurteilung unterlassen. Pro Eingabe steht eine Zeile dazu, was dann nicht bekannt ist (z. B. „Materialmangel unbekannt — Material unbekannt“). Bei der letzten Beurteilung tatsächlich nicht gelesene Eingaben werden als «bei letzter Beurteilung nicht gelesen» ausgewiesen

Die acht Punkte und die jeweils liefernde Familie (maßgeblich ist eine einzige Deklaration im Digital-Thread-Dienst, Beurteilung und dieser Bildschirm lesen dieselbe Deklaration):

Punkt	Quelle
(Basis)	MES-Arbeitsauftrag — fehlt er, wird kein Punkt beurteilt
Vorgelagerter Prozess	MES-Arbeitsauftrag
Material	SCM-Fehlbestand (ersatzweise dasselbe Tool von MES)
Werkzeug · Kalibrierung	Werkzeugverwaltung (Werkzeugliste je Auftrag — erforderlich, Werkzeugregister — optional)
Personal · Qualifikation	Qualifikationsanforderungen des MES-Prozesses + ERP-Personal (ersatzweise MES-Personal)
Freigabe · Sperrung	Sicherheit (EHS) Arbeitserlaubnis (erforderlich) · Sperrung (optional)
Qualitätssperre	Qualität (QM) Nichtkonformität (ersatzweise MES-Nichtkonformität)
Anlagenwartung	Wartung (CMMS) vorbeugendes Wartungsfenster oder Wartungsauftrag, mindestens eines
Zeichnungsblatt	PLM-Konstruktionsänderung (erforderlich) · PLM-Stückliste (optional) · Werkstattzeichnung (Digital-Thread-Spiegel — von RAG indizierte Zeichnung)

• Die Aktualität bezieht sich auf die letzte Beurteilung. Liegt kein Beurteilungsprotokoll vor, erscheint „Noch kein Beurteilungsprotokoll vorhanden“ — Jetzt neu messen führt die Beurteilung einmal aus (nur lesend) und misst neu.
• Die Aktualitäts-Obergrenze unterscheidet sich je Familie → Digital Thread — Wenn Daten veraltet sind
• Auch im Konnektor-Seitenfenster der Karte gibt es die Zeile Bereitschaftspunkte, die zeigt, welche Punkte dieser Konnektor liefert.

Wenn der Schichtleiter-Bildschirm voller «Unbekannt» ist

Das liegt nicht an einer falschen Beurteilung, sondern an fehlenden Quellen. Suchen Sie hier Punkte mit Fehlt (grau) und binden Sie den Konnektor der jeweiligen Familie an. «Unbekannt» bedeutet nicht GO — Punkte mit fehlender Quelle gelten nicht als bestanden.

---

Graphspiegel — /thread/mirror/

Zeigt den Status der periodischen Übertragung (Projektion) von Plattform-Hauptbuch und trainierten Kanten in den Werksgraphen. Nur Lesezugriff. Details siehe Digital Thread.

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Aktualisieren
②	Zusammenfassungszeile	Projektionen · Letzter Erfolg · Dt-Objekte · Projizierte Verbindungen — läuft die Projektion rechtzeitig erfolgreich
③	Letzter Lauf	Abschlusszeit · Lauf-Nr. · aufeinanderfolgende Fehlschläge · Ergebnisse je Schritt — findet, welcher Schritt fehlgeschlagen ist
④	Spiegelinhalt	Quelle und Anzahl je Kategorie — wie viel wovon übertragen wurde

---

MCP Gateway — /mcp-gateway/

Das Tor, durch das jedes MCP-Werkzeug geht, das die KI aufruft. Es sammelt die Werkzeuge des Plattform-Integrations-MCP, der KI-Dienste dieser Installation (Zeitreihe Insight · RAG · Dokumentverständnis · Vision · Digital Thread · Engineering-Berechnung) und der vom Betreiber angebundenen externen MCP-Server und stellt sie unter einer einzigen Adresse (plantpulse-mcp-gateway-api:7160/mcp/) bereit. Der Copilot sieht nur diese eine Adresse, und auch das Ein- und Ausschalten von Werkzeugen geschieht hier (2026.10 Re-Release (2026-10-20) — vorher war das der Bildschirm Tool-Server (MCP) der Copilot-Verwaltungskonsole).

Bildschirm	Adresse	Funktion
Overview	/mcp-gateway/	Gateway-Status (Datenbank · Embedding · Plattform-MCP · MCP-Server), Serverübersicht, Aufrufe · Fehler · Latenz p95 · Suchanzahl der letzten 24 Stunden
Servers	/mcp-gateway/servers/	Server hinter dem Gateway — Art (Platform · Built-in · External) · Präfix · Status · Anzahl eingeschalteter Werkzeuge · Auth · Circuit · letzte Erkennung. Discover · Turn on/Turn off, für externe Server Register server · Edit · Auth · Delete
Tools	/mcp-gateway/tools/	Alle erkannten Werkzeuge — Anzeigename · Server · Beschreibung · Suchbegriffe und deren Quelle · Status · Suchindex. Der Ort, an dem jedes Werkzeug einzeln ein- und ausgeschaltet wird; Beschreibung (4000 Zeichen) und Suchbegriffe lassen sich überschreiben → Tool-Suchbegriffe
Permissions	/mcp-gateway/permissions/	Welcher Aufrufer (Copilot · jeder ausgestellte Schlüssel) sieht die Werkzeuge welches Servers
Client API Keys	/mcp-gateway/client-keys/	Ausstellen · Umfang · Widerrufen von Schlüsseln (ppgw_…) für externe MCP-Clients (andere Agenten · Desktop-Apps)
Search Test Bench	/mcp-gateway/search/	Eine Frage eingeben und sehen, welche Werkzeuge das Gateway dem Modell geben würde — Punktzahl · lexikalischer Rang · Embedding-Rang · Begründung der Auswahl
Search Settings	/mcp-gateway/search-settings/	Werkzeugsuche verwenden · Budget (Anzahl Werkzeuge pro Runde) · Familiengarantie · Abhängigkeitsergänzung
Calls & Metrics	/mcp-gateway/calls/	Aufrufzahlen je Server · Fehler sowie für jeden einzelnen Aufruf Zeitpunkt · Aufrufer · Server · Werkzeug · Ergebnis (Succeeded · Tool failed · Transport failed) · Dauer · Ergebnisgröße → Aufrufprotokoll

Werkzeuge ein/aus — den Anfangswert legt die Richtlinie fest

Werkzeuge kommen bei ihrer ersten Erkennung gemäß der Gateway-Richtlinie ein- oder ausgeschaltet herein. Danach bleibt der im Bildschirm Tools geänderte Wert erhalten; weder Start noch Versionswechsel überschreiben ihn.

Server	Anfangs
Plattform-Integrations-MCP	alle ein
Zeitreihe Insight	34 ein · 4 aus · 1 schreibendes nicht einschaltbar
Digital Thread	9 ein
Engineering-Berechnung	4 ein
RAG · Dokumentverständnis · Vision	ein (alle 2 · 2 · 5) — wird die Dokumentensuche rag_search ausgeschaltet, findet der Chat keine Dokumente
Externe Server	aus

Die Liste je Werkzeug steht in der MCP-Tool-Karte.

• Es gibt nicht einschaltbare Werkzeuge — Werkzeuge mit Schreibverdacht (sie deklarieren readOnlyHint=false oder Name · Beschreibung deuten auf Schreiben) sowie Konnektorwerkzeuge (mes_ · erp_ …), die ein anderer Server als Digital Thread liefert. Plattformwerkzeuge blockiert das Gateway nicht; schreibende holt das Genehmigungs-Gate des Copilot die Zustimmung eines Menschen ein.
• Liefern zwei Server denselben Anzeigenamen, gewinnt der zuerst registrierte, der spätere wird als «Conflict» nicht angezeigt. Ändern Sie das Präfix des späteren Servers.
• Eine überschriebene Beschreibung ändert zugleich die Beschreibung, die das Modell liest, und den Suchindex. Leeren Sie sie, gilt wieder die ursprüngliche Beschreibung des Servers.

Einen externen MCP-Server anbinden

1. Servers › Register server — Name · Streamable-HTTP-Adresse · Werkzeugpräfix (Kleinbuchstaben · Ziffern, endet auf _, Pflicht) · Aufrufzeitlimit (1–600 s, Standard 120). Der Server entsteht ausgeschaltet und für niemanden freigegeben.
2. Ist Authentifizierung nötig, tragen Sie unter Auth Headername und Wert ein. Der Wert wird versiegelt und nie wieder angezeigt (nur «Set»).
3. Turn on → Discover. Externe Werkzeuge kommen ausgeschaltet herein. 🔴 Beschreibung und Argumente externer Werkzeuge gehen unverändert in den Modell-Prompt — lesen Sie sie im Bildschirm Tools und schalten Sie jedes Werkzeug einzeln ein. Ändert sich die Definition eines eingeschalteten externen Werkzeugs, schaltet das Gateway es aus und markiert es zur erneuten Prüfung.
4. Unter Permissions dem Copilot (oder einem ausgestellten Schlüssel) den Server bzw. die Werkzeuge freigeben.

• Externe Werkzeuge gehen an den Copilot als schreibend — der Copilot ruft sie nicht ohne menschliche Genehmigung auf.
• Löst die Adresse auf Loopback · Link-Local · Cloud-Metadaten-Adressen auf, wird nicht angebunden. Interne Netze (10/8 · 172.16/12 · 192.168/16) gehen.
• Plattform- und eingebaute Server legt die Installation fest — sie lassen sich nur ausschalten, nicht bearbeiten oder löschen.
• 🔴 Konnektoren zu Fremdsystemen wie MES · ERP · PLM werden nicht hier, sondern in der Verbindungskarte angebunden.

Berechtigungen und Client API Keys

• Eingebaute Server sind dem Copilot von Anfang an mit allen Werkzeugen freigegeben. «Alle Werkzeuge» umfasst auch später erkannte.
• Neue externe Server und neue Schlüssel entstehen ohne jede Freigabe. «Kein einziges Werkzeug sichtbar» — sehen Sie zuerst unter Permissions nach.
• Der Klartext des Schlüssels ist nur einmal bei der Ausstellung sichtbar. In der Liste bleiben nur die ersten 12 Zeichen. Ein Widerruf greift sofort.
• Einem Schlüssel geben Sie einen Umfang (Anlage · Standort · Projekt · Kunden-PO · Lieferant) und eine Stufe. Ein Schlüssel ohne Umfang kann nur Werkzeuge externer Server aufrufen; eingebaute Werkzeuge lesen eingegrenzt auf diesen Umfang · diese Stufe. Plattformwerkzeuge ruft nur ein Schlüssel mit dem Umfang gesamte Installation auf (die Plattform filtert nicht nach Umfang).
• Dieser Schlüssel gilt nur für /mcp/. Er ist ein anderer Bildschirm als API-Schlüssel im gemeinsamen Menü.
• Externe MCP-Clients verbinden sich mit der Adresse https://<호스트>/mcp/gateway/ → API-Integrationsleitfaden

Werkzeugsuche — standardmäßig ein, Budget 20

Statt alle eingeschalteten Werkzeuge bei jeder Frage mitzuschicken, wählt das Gateway nur die zur Frage passenden aus und gibt sie dem Copilot. Anfangswerte sind ein · Budget 20 · Familiengarantie ein · Abhängigkeitsergänzung ein. search_domains, das IDs anhand von Namen findet, und die Dokumentensuche rag_search werden unabhängig vom Budget immer mitgeschickt (sofern für das Konto zugelassen).

• Schalten Sie sie in Search Settings aus, erhält der Copilot alle freigegebenen Werkzeuge — bei rund 70 Werkzeugen scheitert das Modell oft an der Auswahl. Maßstab zum Einschalten ist ein Recall@20 von mindestens 0,95 in der Offline-Bewertung; wer unterhalb davon einschaltet, wird vom Bildschirm gewarnt (aber nicht gehindert).
• Vom Betreiber geänderte und gespeicherte Werte gewinnen — auch nach einem Versionswechsel kehren sie nicht zum Standard zurück.
• 🔴 Die Suche hängt vom Embedding-Dienst ab. Fällt das Embedding aus, liefert die Suche 503 search_unavailable, und es gibt keinen Ersatzweg — sehen Sie unter Overview auf «Embedding».
• Die Search Test Bench liefert Ränge auch bei ausgeschalteter Suche. Verwenden Sie sie für «Warum wurde bei dieser Frage dieses Werkzeug nicht aufgerufen».

Tool-Suchbegriffe — Wörter, die koreanische Fragen mit Tools verbinden

Die Werkzeugbeschreibungen sind englisch; koreanische Fragen wie «알람 확인 처리» (Alarm quittieren) werden daher über Suchbegriffe mit den Werkzeugen verbunden. Suchbegriffe dienen nur der Wortsuche (BM25), werden nicht eingebettet und sind für das Modell unsichtbar. Im Bildschirm Tools stehen unter dem Beschreibungsfeld je Werkzeug die aktuell verwendeten Suchbegriffe und ihre Quelle.

Quelle	Bedeutung
This install	Vom Betreiber dieser Installation überschrieben — gewinnt gegenüber den drei folgenden
Server declared	Vom MCP-Server zusammen mit dem Werkzeug deklariert (Zeitreihe Insight · Digital Thread · Engineering-Berechnung · RAG · Dokumentverständnis · Vision)
Gateway default	Wert, den das Gateway für Server ohne eigene Deklaration (Plattform-Integrations-MCP) setzt
No search terms	Indexiert nur anhand von Name und Beschreibung

• Suchbegriffe werden nicht abgeschnitten, sondern vollständig angezeigt. Lesen Sie auch die von externen Servern deklarierten Suchbegriffe vor dem Einschalten ganz durch.
• Mit der Schaltfläche Search terms bearbeiten Sie die koreanischen (ko) Suchbegriffe, einen pro Zeile (oder durch Komma getrennt). Suchbegriffe anderer Sprachen bleiben erhalten und werden im Fenster mit angezeigt.
• 🔴 Die Obergrenze je Werkzeug liegt bei 4 Sprachen und über alle Sprachen zusammen 8 Begriffen · 64 Zeichen. Wird sie überschritten, ist die Speichern-Schaltfläche gesperrt.
• Ohne Änderung ist die Speichern-Schaltfläche ebenfalls gesperrt — so wird verhindert, dass eine Kopie des Serverwerts als Überschreibung festgeschrieben wird und spätere Änderungen des Servers verdeckt.
• Leer speichern bedeutet für dieses Werkzeug «keine koreanischen Suchbegriffe». Remove override im Band «This install overrides the search terms.» oben im Fenster kehrt zu Serverdeklaration · Gateway-Standard zurück. Das sind zwei verschiedene Schaltflächen.
• Vom Server in falscher Form oder über der Obergrenze gelieferte Suchbegriffe sowie gespeicherte Überschreibungen, die wegen Überschreitung verworfen wurden, erscheinen mit Grund als Warnzeile (verworfene Werte gelten als nicht vorhanden, es wird die nächste Quelle verwendet). Auch eine verworfene Überschreibung wird mit Remove override gelöscht.
• Das Suchfeld oben im Bildschirm filtert Name · Beschreibung · Suchbegriffe gemeinsam. Ändern sich die Suchbegriffe eines eingeschalteten externen Werkzeugs, wertet das Gateway dies als Definitionsänderung und schaltet das Werkzeug aus.

Wenn …

Symptom	Was prüfen
Serverstatus «Down»	Circuit unter Servers (nach 3 aufeinanderfolgenden Fehlschlägen wird 120 Sekunden lang nicht aufgerufen) und Erkennungsfehler
Externer Server «Degraded», Auth «Not set»	Ein Auth-Header ist festgelegt, aber kein Wert — unter Auth erneut eintragen
Aufruf ergibt upstream_auth	Der Server hat 401/403 geliefert — Auth-Wert prüfen
Aufruf ergibt result_too_large	Das Ergebnis hat 1 MiB überschritten
Mit ausgestelltem Schlüssel ist kein Werkzeug sichtbar	Neue Schlüssel haben keine Berechtigung — Permissions
Bei koreanischen Fragen wird das passende Werkzeug nicht mitgeschickt	Geben Sie die Frage in die Search Test Bench ein, prüfen Sie die Ränge und im Bildschirm Tools die Suchbegriffe und deren Quelle für dieses Werkzeug → Tool-Suchbegriffe
Aufruf ist «Tool failed», der Server ist aber in Ordnung	Das Backend hat geantwortet, aber das Ergebnis ist ein Fehlschlag — prüfen Sie nicht den Server, sondern das Werkzeugergebnis (Argumente · Quelldaten) → Aufrufprotokoll
Aufruf mit ausgestelltem Schlüssel ergibt forbidden_scope	Der Schlüssel hat keinen Umfang, oder es ist ein Plattformwerkzeug und der Umfang ist nicht die gesamte Installation — Client API Keys

Aufrufprotokoll — Werkzeugfehler und Übertragungsfehler

Das Ergebnis in Calls & Metrics hat drei Werte. Die Fehlerzahl schließt Werkzeugfehler ein und wird daneben als «tool N · transport N» aufgeteilt angezeigt. Auch die Tabelle je Server hat eine Spalte Tool failed.

Ergebnis	Bedeutung
Succeeded	Das Werkzeug hat geantwortet, und auch das Ergebnis ist ein Erfolg
Tool failed	Der Backend-Server hat geantwortet, aber das Ergebnis ist ein Fehlschlag — isError, ein nicht leeres error, {"ok": false}, error_code mit status: "error" (dieselbe Regel, nach der der Copilot einen Fehlschlag erkennt)
Transport failed	Das Backend war nicht erreichbar oder das Gateway hat blockiert — der Fehlercode nennt den Grund

Der Filter Result bietet All · Succeeded · Failed (any) · Tool failed. Lautet es «Der Server ist in Ordnung, aber die Antwort ist seltsam», filtern Sie nach Tool failed.

Im Aufrufprotokoll bleiben Argumente · Ergebnisse · Auth-Werte nicht erhalten. «Wer hat was gefragt» auf Personenebene ist das Audit-Log des Copilot → Copilot-Verwaltung

---

Automatisierungs-Sandbox — /sandbox/

Bildschirm des Dienstes, der den Python-Code von Automatisierungsschritten ausführt (Werkzeugergebnisse vorheriger Schritte mit numpy · pandas · scipy verarbeiten und als JSON · Tabelle · Abbildung · Text ausgeben). In der Leiste ist es die vom MCP Gateway getrennte Automatisierungs-Sandbox (Automation Sandbox). Die Konsole liest nur — ausgeführt wird durch die freigegebenen Automatisierungspläne des Copilot, schreibende Zugriffe von der Konsole auf die Sandbox sind gesperrt.

So funktioniert die Isolation

Der Sandbox-Container selbst läuft auf gVisor (runsc), und für jede Ausführung wird darin ein isolierter Prozess mit neuen Namespaces (user · net · pid · mount) gestartet. Es wird nicht für jede Ausführung ein neues gVisor gestartet. Innerhalb einer Ausführung gibt es kein Netzwerk, Werkzeuge oder REST lassen sich nicht aufrufen, und das Root-Dateisystem ist schreibgeschützt.

Bildschirm	Adresse	Funktion
Overview	/sandbox/	Isolation (gVisor-Version · Plattform · Architektur · Netzwerk, letzter Selbsttest), Running · Queued, je Zeitraum Executed · Errors · Turned away, Ausführungen je Ergebniscode
Run History	/sandbox/runs/	Je Ausführung Empfangszeit · Ergebnis · Fehlercode · Code-SHA-256 · Größe · Wartezeit · Dauer. Aufgeklappt Eingabe- · Ausgabegröße · Limits · Kontext. Standardaufbewahrung 30 Tage
Run limits	/sandbox/limits/	Limits einer einzelnen Ausführung (Zeit · Speicher, Code · Eingabe · Ausgabe · Tabelle · Abbildung · /tmp · Prozesse), Limits für gleichzeitige Ausführungen · Warteschlange, importierbare Pakete und Versionen. Das sind die Werte, die die Sandbox tatsächlich anwendet

Es gibt drei Ergebnisse: Succeeded · Error · Turned away. «Turned away» sind nicht ausgeführte Anfragen; in der Run History steht als Dauer «—».

Code	Ergebnis	Bedeutung
ok	Succeeded	Beendet und Ergebnis zurückgegeben
syntax	Error	Der Code ließ sich nicht kompilieren — es lief nichts
forbidden	Error	Es wurde etwas versucht, das ein Berechnungsschritt nicht darf (Netzwerk · Prozesse · nativer Code · Dateien außerhalb von /tmp)
timeout	Error	Wanduhr- oder CPU-Limit überschritten
memory	Error	Speicherlimit überschritten
output_too_large	Error	Ausgabe · Tabelle · Abbildung oder /tmp hat die Obergrenze überschritten
runtime	Error	Sonstige Ausnahme, oder das Ergebnis ließ sich nicht in JSON umwandeln
queue_full	Turned away	Die Warteschlange war voll
queue_timeout	Turned away	Zu lange auf einen freien Platz gewartet
sandbox_unavailable	Turned away	Die Isolation konnte nicht vorbereitet werden — der Code wurde nicht ausgeführt

• 🔴 Der Code-Quelltext liegt nicht hier. Die Sandbox speichert weder Code noch Eingabe · Ausgabe, sondern nur Größen und die Code-SHA-256. Der Quelltext steht im freigegebenen Copilot-Plan mit demselben Hash.
• Häufen sich sandbox_unavailable, oder erscheint in der Übersicht «The isolation self-test failed», schlägt die Vorbereitung der Isolation fehl. Prüfen Sie unter Overview › Isolation die Runtime-Version und den letzten Selbsttest sowie die Protokolle der Sandbox.
• Erscheint «Run records are not being stored», kann nicht in den Speicher für Ausführungsprotokolle (PostgreSQL) geschrieben werden. Ausführungen laufen weiter, fehlen in dieser Zeit aber in Protokoll und Kennzahlen.
• Das gemeinsame Menü umfasst API-Endpunkt · Protokolle · API-Schlüssel · Einstellungen. Da die Sandbox keinen MCP-Server hat, gibt es keine MCP-Serverinformationen.

---

Gemeinsames Menü

Fünf Bildschirme, die in den sechs Diensten RAG API · Zeitreihe Insight · Dokumentenparsing · Vision · Digital Thread · MCP Gateway identisch vorkommen. An der Stelle <Dienst> in der Adresse steht rag · insight · parser · vision · thread · mcp-gateway. Die Abbildungen zeigen die der RAG API. Die Automatisierungs-Sandbox (sandbox) hat dieselben vier ohne MCP-Serverinformationen.

MCP-Serverinformationen — /(Dienst)/mcp-info/

Nr.	Position	Funktion
①	Bildschirmkopf	MCP-Adresse dieses Diensts und Zusammenfassung (Anzahl Tools · Ressourcen · Prompts) — wird durch direkte Abfrage des Diensts in Echtzeit gefüllt
②	Tool-Tabelle	Liste der Tools, die der KI-Copilot aufrufen kann — Tool · Beschreibung · Parameter. Klick auf eine Zeile klappt Typ · Erforderlich · Standardwert der Parameter auf

Darunter folgen die Tabellen Ressourcen · Prompts.

0 Tools ist nicht normal

Ein MCP-Server ohne jegliches Tool sollten Sie nicht als «keine Tools», sondern als fehlgeschlagenes Abrufen der Liste betrachten.

API-Endpunkt — /(Dienst)/api-endpoints/

Nr.	Position	Funktion
①	Bildschirmkopf	Anzahl der Endpunkte und Beschreibung — erzeugt aus dem OpenAPI-Schema des Diensts
②	Tabelle	Methode · Pfad · Beschreibung · Domäne — hilft Integrationsentwicklern, die aufzurufende API zu finden

MCP-Endpunkte (POST /mcp) sind nicht im OpenAPI-Schema enthalten — siehe MCP-Serverinformationen.

Protokolle — /(Dienst)/logs/

Nr.	Position	Funktion
①	Bildschirmkopf	Automatisch 5s (bei Aktivierung alle 5 Sekunden neu laden) · Aktualisieren
②	Kopfzeile	Gelesene Protokolldatei · Größe · Anzahl Einträge — ob die Datei leer ist oder beschädigte Zeilen enthält
③	Protokoll-Tail	Endbereich der Protokolldatei, Neuestes oben — Zeit · Ebene · Ereignis · Felder

Am Bildschirmkopf lässt sich nach Zeilenanzahl, Ebene und Suchbegriff (Enter) eingrenzen. Sie müssen nicht per SSH docker logs eingeben.

API-Schlüssel — /(Dienst)/api-keys/

Prüft, ob die eingehende API-Schlüsselauthentifizierung dieses Diensts tatsächlich aktiv ist. Dies ist kein Bildschirm zur Anzeige des Schlüssel-«Werts».

Nr.	Position	Funktion
①	Bildschirmkopf	Bildschirmname und Prüfung ausführen — ruft erst bei Betätigung zweimal auf: ohne Schlüssel und mit Schlüssel
②	Zusammenfassungszeile	Konsolenschlüssel (ob die Konsole einen Schlüssel besitzt und dessen Fingerabdruck) · Authentifizierung (Prüfergebnis) · Dienstübergreifend geteilt (ob mehrere Dienste denselben Schlüssel verwenden)
③	Roundtrip-Test (Round trip)	Antwortcode und Beurteilung · Bedeutung für ohne Schlüssel · mit Schlüssel — ein geschlossener Dienst antwortet erst mit 401, dann mit 200
④	Verdrahtung (Wiring)	Pro Dienst Konsolen-Umgebungsvariable · Dienst-Umgebungsvariable · Schlüssel · Upstream — unter welchem Namen der Schlüssel wohin gelangt. Klick auf das Augensymbol neben dem Fingerabdruck zeigt den Klartext, dieser Vorgang wird zusammen mit dem Benutzernamen im Audit-Log protokolliert
⑤	Beschreibung unter der Tabelle	Der Schlüssel, den der Aufrufer in X-API-Key senden muss, und unter welcher Umgebungsvariable ihn Konsole und Dienst jeweils halten

Beurteilung	Bedeutung
Erzwungen	Lehnt Aufrufe ohne Schlüssel ab und akzeptiert den Schlüssel der Konsole — normal
Offen	Antwortet auch ohne Schlüssel — jeder mit Netzwerkzugriff kann zugreifen
Nicht erzwungen	Die Konsole besitzt einen Schlüssel, aber der Dienst antwortet auch ohne Schlüssel
Schlüssel stimmt nicht überein	Der Dienst ist geschlossen, lehnt aber den Schlüssel der Konsole ab
Kein Konsolenschlüssel	Der Dienst ist geschlossen, die Konsole besitzt aber keinen Schlüssel
Nicht erreichbar	Der Dienst hat nicht geantwortet — kein «Bestanden»

Allein das Öffnen des Bildschirms führt keine Messung durch

Die fünf Dienste verweigern den Start, wenn der eingehende Schlüssel (PI_INBOUND_API_KEY) leer ist. Die einzige Ausnahme ist, wenn in der Installations-env PI_INBOUND_AUTH_DISABLED=true gesetzt und die Authentifizierung bewusst deaktiviert wurde — dann startet der Dienst ohne Schlüssel, der Container bleibt „healthy“ ohne jedes Signal. Deshalb wird mit Prüfung ausführen gemessen — so werden keine 401-Fehler beim Dienst angehäuft, nur weil der Bildschirm geöffnet wird. Antwortet er auch ohne Schlüssel (Offen), erscheint vor der Tabelle ein Warnkasten. Die Prüfung sendet absichtlich eine Anfrage ohne Schlüssel — bei einer 401-Überwachung kann dies einen Alarm auslösen → API-Integrationsleitfaden — eingehender Schlüssel

Einstellungen — /(Dienst)/config/

Nr.	Position	Funktion
①	Bildschirmkopf	Anzahl Schlüssel und Aktualisieren
②	Komponententabelle	Pro vom Dienst verwendeter Komponente Status · Endpunkt — zeigt, welche Abhängigkeit unterbrochen ist
③	Konfigurationstabelle	Aktuell angewendete Laufzeitkonfiguration Schlüssel · Wert — sensible Werte wie Passwörter/Tokens werden maskiert angezeigt

Die Einstellungen sind kein Bearbeitungsbildschirm

Es werden nur Werte angezeigt, ohne Änderungsmöglichkeit. Zum tatsächlichen Ändern siehe Passwörter · API-Schlüssel ändern und Dienstbetrieb.

---

Vorgehen in bestimmten Situationen

Symptom	Zuerst prüfen	Dann
Der Chatbot findet ein Dokument nicht	RAG API → Dokumente	Direkte Suche über Abfragetest → Synchronisierungsverlauf
Antworten des Chatbots sind langsam	P95 im LLM-Dashboard	GPU-Auslastung/-Temperatur
Das Modell antwortet nicht	LLM → Upstream-Status	LLM → Chat-Test direkt einmal ausprobieren
Analyseergebnis ist leer	Zeitreihe Insight → Pipeline-Status	Fehlgeschlagene Einträge im Ausführungsverlauf
Ob ein Backend ohne Authentifizierung offen ist	Jeweiliger Dienst → API-Schlüssel → Prüfung ausführen	Passwörter · API-Schlüssel ändern
Auf dem Bildschirm erscheint … rejected the console's inbound API key (401) - check <환경변수>	Schlüssel des Diensts und der von der Konsole gehaltene Schlüssel stimmen nicht überein (Fehlergrund upstream_auth, 502)	Jeweiliger Dienst → Tabelle Verdrahtung in API-Schlüssel → Umgebungsvariablen gemäß Meldung angleichen und die Konsole neu starten
LLM-Bildschirme (API-Schlüssel · Protokolle · Modellregistrierung usw.) liefern 502, Grund llm_upstream	Das Gateway (LiteLLM) oder dessen DB hat einen 5xx-Fehler geliefert. Kein Konsolenfehler — upstream_status ist der Statuscode des Gateways	docker compose logs plantpulse-litellm → Fehlerbehebung
Auf der Verbindungskarte erscheint „Konnektorregister nicht verfügbar: 503 … config_error …“	Das Registerspeichersystem (DT_PG_*) oder der Verschlüsselungsschlüssel (DT_SECRET_KEY) des Digital Thread fehlt	Administrator um Konfiguration bitten. Graphspiegel läuft davon unabhängig weiter
Im Zeichnungsregister erscheint „Die Zeichnungsindizierung ist deaktiviert“	DRAWING_INGEST_ENABLED der rag-api ist deaktiviert (Werkseinstellung)	In Umgebungskonfiguration aktivieren und rag-api neu starten
Im Videobildschirm erscheint „Die Video-/Audio-Erfassung ist deaktiviert“ · Video-Upload wird blockiert	PI_MEDIA_ENABLED in der Installations-env ist nicht aktiviert (Werkseinstellung deaktiviert)	In Umgebungskonfiguration aktivieren und den Stack neu erstellen
Ein hochgeladenes Video bleibt lange Wartend	Außerhalb des Verarbeitungszeitfensters — die Zeile zum Verarbeitungszeitfenster im Videobildschirm nennt den nächsten Startzeitpunkt	Zum Ändern des Zeitfensters MEDIA_PROCESSING_WINDOW → Umgebungskonfiguration
Der Chat verwendet ein Video nicht als Beleg	RAG API → Videos → Leere Transkription · Fehlt in Suche	Diese Zeile aufklappen und gemäß Hinweis Erneut transkribieren
Blattstatus im Zeichnungsregister zeigt überall Nicht bestätigbar	Der PLM-Konnektor für Blattabfragen fehlt oder antwortet nicht	Digital Thread → Verbindungskarte, ob der PLM-Konnektor aktiv ist → Digital Thread
Die Schichtleiter-Bereitschaft ist voller «Unbekannt»	Der Quellenkonnektor dieses Punkts ist nicht angebunden oder die Daten sind veraltet	Digital Thread → Verbindungskarte → Bereitschaftsquellen
Auf Home leuchtet ein gelbes Licht	Details aufklappen und Tooltip prüfen	Jeweiliger Dienst → Protokolle
Auf Home leuchtet ein rotes Licht	Jeweiliger Dienst → Protokolle	Neustart-Verfahren unter Dienstbetrieb
Der Bildschirm ist leer und zeigt ein Fehlerband	Der Dienst ist möglicherweise noch nicht gestartet	Status auf Home prüfen

Auch bei falschem Dienstschlüssel erfolgt keine Abmeldung

Lehnt ein Dienst den Schlüssel der Konsole ab, wertet die Konsole dies nicht als abgelaufene Anmeldung, sondern zeigt eine einzelne Fehlerzeile (502, upstream_auth). Erneutes Anmelden behebt das Problem nicht — prüfen Sie die in der Meldung genannte Umgebungsvariable.

„Leer“ unterscheidet sich von „konnte nicht abgerufen werden“

Konnte die Konsole keine Daten abrufen, täuscht sie keine leere Tabelle vor, sondern zeigt ein Fehlerband. Erscheint ein Fehlerband, bedeutet das nicht, dass keine Daten vorliegen, sondern dass keine Verbindung besteht.

---

Konto und Sitzung

Das Konsolenkonto wird nicht über eine Datenbank, sondern über Umgebungsvariablen festgelegt (/etc/kopens/plantpulse-ai.env).

Umgebungsvariable	Bedeutung	Standardwert
PI_ADMIN_USER	Benutzername für die Anmeldung	admin
PI_ADMIN_PASSWORD	Passwort für die Anmeldung	Keiner — muss zwingend festgelegt werden
PI_ADMIN_SESSION_SECRET	Sitzungssignaturschlüssel	wird vom Installationsprogramm erzeugt
ADMIN_SESSION_MAX_AGE	Anmeldedauer (Minuten)	480 (8 Stunden)

Im Container erscheinen diese unter den Namen ADMIN_AUTH_USERNAME · ADMIN_AUTH_PASSWORD · ADMIN_SESSION_SECRET, da Compose die obigen Werte dorthin überträgt, müssen Änderungen auf der Seite von PI_* erfolgen.

Ohne Passwort startet die Konsole gar nicht

Bleibt PI_ADMIN_PASSWORD leer, verweigert die Konsole den Start. Dies verhindert, dass ein unauthentifiziertes Verwaltungsportal stillschweigend offen bleibt — dies ist normales Verhalten.

Wenn Sitzungen ständig abbrechen

Ändert sich PI_ADMIN_SESSION_SECRET, werden alle bisherigen Anmeldungen ungültig. Belässt man den einmal vom Installationsprogramm erzeugten Wert unverändert, bleibt die Anmeldung auch nach einem Neustart erhalten.

Das Konsolenpasswort kann nicht über bin/passwd.sh geändert werden

Das Konsolenkonto gehört nicht zur Schlüsselliste, die bin/passwd.sh verwaltet (siehe Tabelle unter Passwörter · API-Schlüssel ändern). Zum Ändern muss direkt in der Umgebungsdatei bearbeitet und der Dienst neu gestartet werden. Wenden Sie sich an den Administrator.

---

Verwandte Dokumente

• Service-Port-Map — Konsolenadresse und Ports der einzelnen Dienste
• Dienstbetrieb — Start-, Stopp- und Neustartverfahren
• Passwörter · API-Schlüssel ändern — Schlüsselrotation
• Protokollierung und Monitoring — direkte Protokollansicht auf dem Server
• Digital Thread — Konzepte zu Verbindungskarte, Graphspiegel und Bereitschaftsquellen sowie Konnektorregistrierungsverfahren
• Umgebungskonfiguration — Schalter für Zeichnungsindizierung · Video-/Audio-Erfassung (DRAWING_INGEST_ENABLED · PI_MEDIA_ENABLED), Verarbeitungszeitfenster (MEDIA_PROCESSING_WINDOW)
• Videosuche — wie indizierte Videos im Chat verwendet werden
• Copilot-Verwaltung — wo die Genehmigung von Aktionswerkzeugen erfolgt
• MCP-Tool-Karte — Werkzeuge je Server und was anfangs eingeschaltet ist