Der Robot Cell Simulator kann von außen mit Befehlen gesteuert werden – dieselben Schritte wie im Fenster (Simulation laden, fahren, Bericht, Arbeitsbereiche, Verriegelungen prüfen), ohne Dialoge. Gedacht für nächtliche Regressionstests einer Station, den Vergleich von Programmvarianten per Skript und für einen KI-Agenten, der die Studien durchführt.

Einschalten

Die API ist standardmäßig aus. Sie wird in den Einstellungen des Simulators eingeschaltet (Einstellungen > Konfigurieren..., Registerkarte KI-Agent: Befehls-API des Robot Cell Simulator für den KI-Agenten und Skripte) oder mit der Umgebungsvariable DRES_RCS_API=1 beim Start von DReS. Dieselbe Registerkarte zeigt den Pfad des Client-Skripts (Standard template\RCS\AIAgent\rcs_api.ps1 im Installationsverzeichnis). Sie startet, wenn das Fenster des Robot Cell Simulator geöffnet wird (Plugins > Robot Cell Simulator); die Konsole zeigt Befehls-API des Robot Cell Simulator empfängt Befehle über \\.\pipe\DReS_RCS_API. Nur der Benutzer, der DReS gestartet hat, kann sich verbinden (lokale Pipe, kein Netzwerk).

Lizenz: die Befehls-APIs des Editors und des Robot Cell Simulator brauchen die Zusatzlizenz API / CLI (Steuerung von DReS und dem Simulator durch andere Programme, Skripte und KI-Agenten). Ohne sie gehen nur lesende Befehle (z. B. status, run_data, view, robust_test mit status / risks, ui_list, ui_shot, scene_shot, recent_files), die anderen Befehle antworten mit einem Fehler über die fehlende Lizenz, und die Einstellungen der Befehls-APIs sind gesperrt. Auch die Sprachsteuerung VeRa braucht diese Lizenz.

Befehle

Ein JSON-Objekt pro Zeile in beide Richtungen, z. B. {"cmd":"status"}. Jede Antwort enthält "ok": true / false und "error", wenn der Befehl fehlgeschlagen ist. Während ein Befehl läuft, werden keine Meldungsfenster gezeigt – es gilt die Standardantwort, die Meldung steht in der Konsole. Seit 2026-10-25 gilt das auch für das, was später kommt: ein Lauf, ein Robustheitstest oder eine Simulation beider Reihenfolgen, der über die API gestartet (oder angehalten) wurde, endet ohne Fenster (Simulation beendet, Kollisionsgefahr in der Simulation, Wettläufe der Anforderungen, Wettlauf gefunden, Simulation beider Reihenfolgen - Ergebnis) – ihr Text steht in der Konsole und in status.lastRunMessages (auch in den Antworten von report / run_data); eine über die API geladene Simulationsdatei (load, open, package_open) öffnet nicht das Fenster Simulation laden – Nicht wiederhergestellt (Liste in status.lastLoadMissing und in der Konsole), und Fehler beim Öffnen (unbekanntes Format, eine Studie, die sich nicht entpacken lässt) stehen nur in der Konsole. Nur die Pause bei Kollisionsgefahr (Option Simulation bei Kollisionsgefahr anhalten) öffnet weiter ihr Fenster mit Weiter; weiter mit {"cmd":"sim_action","action":"resume"}. Eine fehlende Lizenz während eines Befehls oder beim Schließen von DReS ist nur eine Meldung in der Konsole.

Client-Skript und Zeitlimit: seit 2026-10-25 schreibt rcs_api.ps1 (und der Sprachassistent VeRa) den Befehl mit Zeitlimit und ohne zu warten, bis das Programm ihn gelesen hat – ist DReS beschäftigt oder antwortet nicht, endet das Skript mit einem Fehler, statt endlos zu warten.

DReS per Skript schließen: wird DReS oder das Fenster des Simulators geschlossen, während eine Datei geladen wird (load, open, package_open, Entpacken eines Pakets, Konvertierung von JT-Modellen, Arbeitsbereiche), wartet das Schließen bis zum Ende des Ladens (die Konsole zeigt Laden / Berechnung läuft - DReS wird nach dem Ende geschlossen); das Entpacken eines Pakets und die Arbeitsbereiche werden abgebrochen, noch nicht begonnene Ladevorgänge übersprungen (status.lastLoadError: abgebrochen - das Programm wird geschlossen).

Flag "anon": true (jeder Befehl): die Namen werden übersetzt – R1, R2 …, <file N> und <name> im Befehl werden vor der Ausführung durch die echten Roboternamen und Dateipfade ersetzt, und in der Antwort werden Roboternamen, Dateipfade und Kennungen der Anlage durch diese Kennungen ersetzt. Genutzt vom Fenster KI-Agent im anonymen Modus und seinem MCP-Server (Umgebungsvariable DRES_AI_ANON=1); z. B. {"cmd":"robot","robot":"R2","goto":"UP42/P5","anon":true}.

sim_options – Optionen der Registerkarte Simulation

Ohne Schlüssel liest der Befehl die Optionen. Mit Schlüsseln setzt er sie wie ein Klick in der Oberfläche (auch in den Einstellungen gespeichert). Während der Simulation sind die Optionen gesperrt, das Setzen gibt einen Fehler. Die Antwort enthält immer alle Werte und locked (true, während die Simulation läuft).

template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"sim_options"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"sim_options","stopAtCollisionRisk":false,"upCalls":"all","syncWaits":"E23; E80 & E76"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"sim_options","programRules":[{"kind":"waitAtCommand","value":"SERVOZANGE","ms":1200,"prAct":true,"mode":"after","overlap":400}]}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"live_check","on":true,"cell":30,"capsule":60,"range":200,"warn":30,"contact":5,"thread":true,"parallel":true,"grid":true,"stepMs":20}'

robust_test – Aktionen

signal_timeline – Parameter

Signal-Zeitachse des letzten Stationslaufs (Lizenz Simulation). Die Aufzeichnung entsteht bei jedem Stationslauf (Auf allen Robotern ausführen), solange record ein ist. Alle Schlüssel sind optional; ohne record, select, add, remove, showAt, export und window liest der Befehl nur (auch ohne die Lizenz API / CLI). Ein Signal heißt "Roboter|Signal", z. B. "<Roboter>|E80", "<Roboter>|A41" oder "<Roboter>|Zone5" (vom Roboter belegter Bereich). robot, signals, select, add und remove verwenden die echten Roboternamen (wie in einer Antwort ohne anonymize).

Antwort: duration [s] (Länge der Aufzeichnung), recording (true, solange die Station läuft), samples, from, to, robots [{robot, states [{t0, t1, state, where}]}] – state (englischer Text): motion, process, waits for an interlock zone, WARTE BIS, Warte auf Folgenstart, waits at the end of the loop, waits (condition), not moving; where: Programm und Punkt –, signals [{robot, signal, at_from (Wert bei from, -1 = noch nicht gesetzt), changes [[t, Wert], ...]}], available (alle aufgezeichneten Signale), selection, record und auf Anfrage why, shownAt, export.

template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"signal_timeline","data":false}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"signal_timeline","why":41.5,"robot":"<Roboter>","data":false}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"signal_timeline","from":30,"to":75,"signals":["<Roboter>|E80","<Roboter>|Zone5"],"export":"C:\\temp\\timeline.csv","anonymize":true}'

cycle_reserve – Parameter

Taktzeitreserve (Lizenz 146 Bewegungsoptimierung). Ablauf: ein Stationslauf (run, am besten 2 Schleifen oder mehr) → action analyze → action test → derselbe Stationslauf noch einmal (er ist der Kontrolllauf) → status liest lastTest. Ist lastTest.ok false, werden die Vorschläge der Roboter, die langsamer als der Takt der Station wurden, automatisch abgewählt (Liste lastTest.unticked) – dann action test und der Lauf erneut. status ohne weitere Schlüssel liest nur.

Antwort: share, minOverride, minGain, baseTakt [s] (Takt der Station im analysierten Lauf, -1 = keine Analyse), baseCycles {Roboter: Takt [s]}, testPending (der nächste Stationslauf ist der Kontrolllauf), proposals [{robot, point, motion [s], waitAfter [s], waitKind (il = Verriegelungsbereich, warte = WARTE BIS, fs = Warte auf Folgenstart, end = Ende des Takts), override [%], newMotion [s], energy ((Override / 100)²), use}], energyIndicator (angekreuzte Bewegungen gegenüber jetzt, 1 = unverändert), lastTest {takt, baseTakt, difference, ok, robots [{robot, cycle, baseCycle}], unticked [{robot, point}] (nur wenn nicht ok)}, controllers (Text: für welche Steuerungen die Vorschläge gelten). ok = Takt des Kontrolllaufs ≤ baseTakt + max(0,1 s, 0,5 %).

Beispiel (anonymisierte Station): analyze → baseTakt 74,20 s, 5 Vorschläge; Kontrolllauf → "lastTest":{"takt":74.20,"baseTakt":74.20,"difference":0,"ok":true,...}.

template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"cycle_reserve","action":"analyze","share":80,"minOverride":30,"minGain":5}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"cycle_reserve","use":[{"robot":"<Roboter>","point":"<Punkt aus proposals>","use":false}]}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"cycle_reserve","action":"test"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"cycle_reserve","export":"C:\\temp\\cycle_reserve.pdf","anonymize":true}'

Jede Option des Fensters (UI-Befehle)

Neben den Befehlen oben ist jedes Bedienelement des Simulators erreichbar – auch in Dialogen, Meldungsfenstern, Einstellungen und Kontextmenüs – ohne Bildschirmfotos: die Antwort enthält die Elemente als Daten (Typ, Beschriftung, Pfad Registerkarte / Gruppe / Dock, Wert, Einträge, Zeilen von Tabellen und Bäumen). Die Liste aller Menüaktionen und Bedienelemente: Befehls-API - Referenz. Jedes Element hat eine Nummer (id), die gleich bleibt, solange es existiert; es kann auch über seine Beschriftung (+ window, path, type; first: true nimmt das erste von mehreren passenden Elementen), eine Menüaktion über action (Menüpfad). Das ist target in der Tabelle unten. Änderungen und Klicks werden direkt nach der Antwort ausgeführt, ein dadurch geöffneter Dialog blockiert die API nicht: er erscheint in ui_windows (modale zuerst) und status (modal, uiPending).

template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"ui_click","action":"Einstellungen > Konfigurieren..."}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"ui_set","label":"Im Hintergrund vorbereitete Makros","value":"20, 45, 46, 47, 50, 57"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"ui_click","window":"Einstellungen","label":"OK"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"ui_file","answer":"C:/cells/station_folge81.xml"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"ui_click","action":"Simulation > Simulation laden..."}'

Simulator ohne Klick starten (Editor-API)

Wenn Settings > AI Agent > Command API of the editor (Einstellungen des Editors) eingeschaltet ist (oder mit DRES_API=1), empfängt DReS selbst Befehle über \\.\pipe\DReS_API (Client AIAgent\dres_api.ps1): license zeigt, ob die Lizenzprüfung läuft, ob das erste Lesen des Schlüssels abgeschlossen ist (ready) und welche Lizenzen verfügbar sind; mit "details": true außerdem jede Lizenz mit Typ und Gültigkeit, den Schlüssel und die Wissenspakete der KI-Agenten (Felder: Editor-API, Fenster: Help > License info); plugins listet die Plugins der Menüs; run_plugin {name, wait} öffnet ein Plugin, sobald der Lizenzschlüssel gelesen ist (wait = Sekunden Warten auf die Lizenz) und der Editor nicht beschäftigt ist – solange der Editor nach dem Start die Sitzung wiederherstellt oder viele Dateien öffnet (Open all der zuletzt geöffneten Dateien), wird der Start des Plugins verschoben und die Antwort enthält das Feld waitingFor (was der Editor gerade tut); open {file, line} öffnet eine Datei; status zeigt die aktive Datei, einen offenen Dialog und busy (true, solange der Editor die Sitzung wiederherstellt oder Dateien öffnet; dann sagt busyReason, was er tut; currentSession und, während eine Sitzung wiederhergestellt wird, session – siehe session) – vor dem Laden einer Station im Simulator status abfragen, bis busy false ist, statt eine feste Zeit zu warten (solange der Editor beschäftigt ist, meldet load des Simulators, dass die Roboterkonfigurationen jetzt nicht gelesen werden; die Station dann erneut laden, wenn der Editor bereit ist); settings_get / settings_set lesen und ändern die Einstellungen des Editors und der Plugins, z. B. RCS_Group/Automation_Api = true vor run_plugin, damit der Agent die API des Simulators selbst einschaltet.

plugin_cmd {plugin, command, ...} ruft einen API-Befehl eines Plugins des Editors auf; die übrigen Felder sind die Parameter des Befehls. Heute: Robot Cell Simulator Lite mit den Befehlen lite_open, lite_archive, lite_calculate, lite_status, lite_matrix, lite_check, lite_report und lite_image (Parameter und Ergebnisse: Robot Cell Simulator Lite - API). Das Plugin benötigt seine eigene Lizenz (Lite: Robot Cell Simulator basic, 140) und die Lizenz API / CLI (248).

Settings > Configure > AI Agent, Registerkarte Command API (lokaler Pfad verdeckt)

AIAgent\dres_api.ps1 '{"cmd":"license"}'
AIAgent\dres_api.ps1 '{"cmd":"license","details":true}'
AIAgent\dres_api.ps1 '{"cmd":"settings_set","key":"RCS_Group/Automation_Api","value":true}'
AIAgent\dres_api.ps1 '{"cmd":"run_plugin","name":"Robot Cell Simulator"}'
AIAgent\dres_api.ps1 '{"cmd":"plugin_cmd","plugin":"Robot Cell Simulator Lite","command":"lite_status"}'
AIAgent\dres_api.ps1 -StartNewSession -SessionName "Station 010"

-StartNewSession [-SessionName "Name"] startet den Editor mit einer neuen leeren Sitzung (ohne Namen oder mit dem angegebenen Namen) statt der letzten und wartet, bis er bereit ist – Details: session.

Der KI-Agent VeRa (Sprachsteuerung, MCP-Server für Claude Code) nutzt diese APIs: VeRa - KI-Agent und Sprachsteuerung.

Client-Skript

template\RCS\AIAgent\rcs_api.ps1 (PowerShell) sendet einen Befehl und gibt die Antwort aus; -WaitIdle wartet, bis der Simulator frei ist (kein Laden, keine Vorbereitung, keine Simulation).

template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"status"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"load","file":"C:/cells/station_folge81.xml","newScene":true}' -WaitIdle
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"fast_run","program":"folge125"}' -WaitIdle
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"run","folge":81,"loops":10,"speed":400,"sps":true}' -WaitIdle -TimeoutSec 900
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"run","up":42,"loops":1,"sps":false}' -WaitIdle
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"sim_action","action":"pause"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"report","file":"C:/reports/variante_c.html","pdf":true,"compareFile":"C:/reports/original.rcsrun.json"}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"zones","programs":["folge81"]}'
template\RCS\AIAgent\rcs_api.ps1 '{"cmd":"check_interlocks"}'

Beispiel: Variante einer Station

Originalstation laden, Folge 81 zehnmal mit dem SPS-Programm der Station fahren, Bericht speichern; die geänderte Kopie der Programme laden, gleich fahren und einen Bericht mit Vergleich zum Original speichern (compareFile = die .rcsrun.json des ersten Berichts). Dieselbe Folge für mehrere Varianten ergibt eine Tabelle der Taktzeiten ohne einen einzigen Klick. Die Simulationsgeschwindigkeit ändert die gemessenen Zeiten nicht (400 % ergibt dieselben Taktzeiten wie 100 %).