Fenster KI-Agent (AI Agent) API / CLI
Der Editor hat einen eigenen Chat mit einem KI-Agenten. Sie schreiben in einfachen Worten, was der Agent tun soll – z. B. „Prüfe die ersten und letzten Punkte aller Folgen“ oder „Zeige mir alle Schweißpunkte mit Offset 0“ –, und ein Sprachmodell plant die Schritte und benutzt die Befehle des Editors wie die Menüs, Schaltflächen und Dialoge. Es liest die Programme, die Punkttabellen und die Roboterdaten aller Roboterprojekte des Projektbaums, vergleicht sie und antwortet mit Tabellen und Schlussfolgerungen. Sie müssen die Befehle nicht kennen: der Agent schlägt die nächsten Schritte selbst vor.
Der Chat zeigt Ihre Nachrichten, die Antworten des Agenten und jeden Befehl mit seinem Ergebnis. Das Fenster ist dasselbe wie das Fenster KI-Agent des Robot Cell Simulators (Statuszeile, Neuer Chat, Schaltfläche Einstellungen, Senden, Stopp, Schriftgröße, Antwort live, Tabellen, Warteschlange der Nachrichten) – nur die Befehle sind die des Editors. Der Agent antwortet in der Sprache Ihrer Nachricht.
Öffnen
- Menü Tools > Show / hide AI Agent chat (Alt+4) oder
- die Schaltfläche KI (Funkel-Symbol) in der Symbolleiste, neben der Mikrofon-Schaltfläche von VeRa.
Das Fenster ist unten im Hauptfenster angedockt. Es kann geschlossen und wieder geöffnet werden; das Gespräch bleibt bis
Neuer Chat erhalten. Bei jedem Öffnen und nach Neuer Chat zeigt der Chat eine kurze Begrüßung mit einem Link auf
diese Seite und dem Hinweis /help eingeben. Darunter zeigt eine Zeile, sobald der Lizenzschlüssel gelesen ist, das
Wissen des Agenten, z. B. Loaded 11 knowledge file(s) - cost about 18000 tokens per request (die Größe aller
Wissensdateien, die mit jeder Anfrage gesendet werden). Können einige Wissenspakete nicht gelesen
werden (keine Lizenz, Jahr des Pakets nicht abgedeckt), ist die Zeile rot und endet mit K not loaded (/knowledge);
/knowledge zeigt, welche Dateien.
Abdocken und verschieben: das Fenster KI-Agent lässt sich wie die Konsole abdocken und verschieben – an seiner Titelleiste (der Statuszeile) ziehen, darauf doppelklicken oder die Schaltflächen am rechten Ende der Leiste nutzen: Fenster abdocken / andocken (auch Doppelklick auf diese Leiste) und Fenster schließen.
Konsole neben dem Chat: im Kontextmenü der Konsole (Rechtsklick) legt Dock next to the AI Agent window die Konsole als Reiter neben das Fenster KI-Agent – Reiter Console | KI-Agent an derselben Stelle unten, wie Meldungsfenster und KI-Agent im Robot Cell Simulator; die Reiter stehen oben (siehe Konsole als Reiter). Schriftgröße: Larger font (Ctrl + wheel) / Smaller font im Kontextmenü oder Strg + Mausrad – in der Konsole und im Chat; die Größe wird gespeichert.
Per Sprache: ein gesprochener Befehl, den VeRa nicht kennt ("Vera, wie viele Roboterprojekte sind offen?"), geht als Nachricht an dieses Fenster – das Fenster öffnet sich, VeRa sagt "Ich habe es an den KI-Agenten weitergegeben" und der Agent antwortet im Chat. Einstellung: Settings > Configure > AI Agent > VeRa voice control, standardmäßig an; sie braucht wie das Fenster selbst die Lizenz API / CLI.
Das Fenster – Schaltflächen und Menüs
/knowledge: die Wissenspakete des Agenten; Oberfläche auf Englisch)| Nr. | Element | Funktion |
|---|---|---|
| 1 | Statuszeile (Titelleiste) | Verbindung zum Modell (Anbieter und Modell), anonymous bei eingeschaltetem anonymen Modus, während der Arbeit The agent is working... mit dem Fortschritt; nach der ersten Anfrage der Verbrauch: Kontext in % und die Tokens des Chats (Farben grün / orange / rot, siehe Verbrauch). Leiste ziehen = Fenster verschieben, Doppelklick = ab- / andocken. |
| 2 | Abdocken / Schließen | Undock / dock the window und Close the window (Alt+4 oder die Schaltfläche AI öffnen es wieder; der Chat bleibt). |
| 3 | New chat | Vergisst das Gespräch und beginnt ein neues. Mit der Option Save the knowledge automatically before a new chat speichert der Agent zuerst, was Sie ihm beigebracht haben (siehe Den Agenten anlernen), dann beginnt der neue Chat. |
| 4 | Learn (Doktorhut) | Den Agenten anlernen: er schreibt, was Sie ihm in diesem Chat beigebracht haben (Regeln der Zelle, Abläufe, Korrekturen, wie Ihre Aufgaben zu erledigen sind), als Wissensdateien in den Ordner Ihrer Wissensdateien und lädt sie in jedem neuen Chat. Aktiv, wenn der Chat seit dem letzten Speichern neue Nachrichten hat. |
| 5 | Einstellungen (Schraubenschlüssel) | Öffnet Settings > AI Agent > AI Agent window: Verbindung, API-Schlüssel, Modell, Grenzen, anonymer Modus, Wissensdateien, automatisches Speichern des Wissens und Ordner Ihrer Wissensdateien (siehe Einstellungen). |
| 6 | Chat | Ihre Nachrichten, die Antworten des Agenten mit Tabellen und Farben, jeder Befehl mit seinem Ergebnis. Strg + Mausrad ändert die Schriftgröße. Rechtsklick: Menü unten. |
| 7 | Nachrichtenfeld | Ihre Nachricht in normalen Worten. Enter sendet, Umschalt+Enter neue Zeile; / zeigt die Chat-Befehle und
die Befehle des Editors (Befehle im Chat). Eine Nachricht, die während der Arbeit des Agenten geschrieben wird, wartet in einer Warteschlange. |
| 8 | Send | Sendet die Nachricht (wie Enter). |
| 9 | Stop | Hält den Agenten nach dem laufenden Befehl an; der Chat bleibt. |
Menü des Chats (Rechtsklick im Chat) und Menü des Nachrichtenfelds (Rechtsklick im Feld):
- Copy, Copy Link Location, Select All – markierter Text / Link des Chats.
- Larger font (Ctrl + wheel), Smaller font – Schriftgröße des Chats und des Felds; sie wird gespeichert.
- Copy the whole conversation – der ganze Chat als Text in die Zwischenablage (z. B. für eine Mail oder ein Ticket).
- Teach the agent - save what it learned as a knowledge file – wie die Schaltfläche Learn (grau, wenn nichts Neues beigebracht wurde).
- Save the knowledge automatically before a new chat – schaltet das automatische Speichern ein / aus (dieselbe Option wie in den Einstellungen).
- Clear (new chat) – wie die Schaltfläche New chat.
- Nachrichtenfeld: Undo, Redo, Cut, Copy, Paste, Delete, Select All, die Schriftgröße und Clear (leert das Feld).
Was der Agent macht
Der Agent arbeitet im Editor mit der Befehls-API des Editors (Werkzeug editor_command), direkt im Programm – ohne Pipe, ohne Fenster. Er kann:
- Dateien öffnen, aktivieren, speichern, schließen und neu laden; die offenen documents auflisten;
- die Roboterprojekte des Projektbaums auflisten (projects), ein Roboterprojekt aus seiner Konfigurationsdatei öffnen (open_project) und das aktive setzen (set_active_project);
- die Syntax prüfen (check_syntax – der Agent bekommt die falschen Zeilen mit ihren Meldungen in der Antwort, das Ergebnisfenster des Editors wird selbst geschlossen und wartet auf keinen Klick), den Cursor bewegen (goto: Zeile, Fold, Punkt, Tech, UP-Aufruf), undo / redo (nicht in KRC-Programmen – sie haben kein Rückgängig);
- in KRC- / KUKA-iiQKA-Programmen ganze Folds auflisten, kopieren, ausschneiden, löschen, einfügen und verschieben und die Parameter eines Befehls lesen und ändern (fold) – mit denselben Fold-Regeln wie die Tastatur, auch für edit / replace;
- die Parameter von Technologiebefehlen auflisten und ändern (tech, siehe unten);
- Roboterdaten finden und prüfen – Roboterkonfiguration, Programmdateien, Punkttabellen und TCP-Bahnen aller Roboterprojekte (search, robot_data, points, siehe RobotDataSpy);
- Plugins auflisten und starten (plugins, run_plugin), z. B. den Robot Cell Simulator (solange der Editor die Sitzung wiederherstellt oder Dateien öffnet, antwortet status mit busy = true und run_plugin wartet, bis er bereit ist – Feld waitingFor in der Antwort; bis das Programm gestartet und die letzte Sitzung wiederhergestellt ist – Feld startupDone von status – lehnt der Editor alle anderen Befehle außer lesenden, ai_chat und Antworten auf einen modalen Dialog mit Editor busy: ... ab, damit kein Plugin und keine Funktion auf halb geladenen Roboterprojekten läuft);
- jede Menüaktion ausführen (ui_actions, ui_click) und Dialoge bedienen (ui_windows und die anderen UI-Befehle).
Mit dem Werkzeug read_doc liest der Agent Seiten dieser Dokumentation (editor_ai_agent, vera – die Editor-API, vera_menu_reference – alle Menüaktionen, rcs_api – die UI-Befehle), bevor er einen Befehl benutzt, den er nicht kennt.
Befehle, die der Agent benutzt
Die wichtigsten Befehle der Editor-API für den Agenten (Einzelheiten, Parameter und Antworten: VeRa > Editor-API):
| Befehl | Was er dem Agenten liefert |
| tech | Parameter der Technologiebefehle: VKRC-TECH-Folds, SERVOZANGE-Folds, Fanuc CALL VW_USER(...) – Liste von der Festplatte über alle Roboterprojekte (mit Zusammenfassung der Werte und Bedingungen wie Offset > 0), Änderung zuerst mit dryRun, Export als CSV |
| search | regulärer Ausdruck über die Dateien der Roboterprojekte auf der Festplatte; benannte Gruppen sind die Werte, mit ihrer Anzahl je Projekt und Datei |
| robot_data | Daten der Roboter aus ihrer Konfiguration – was die Registerkarten Robot info, Profinet und CTB data zeigen (Werkzeuge, Basen, Lasten, IP, VW User, Kalibrierung …), auch für inaktive Projekte |
| points | Punkttabelle eines Programms, Länge der TCP-Bahn, Bewegungszeit, Prozesslänge (z. B. Kleber); für viele Programme die Prüfungen samePoints und callStart, verglichen in Weltkoordinaten |
| open_project | öffnet ein Roboterprojekt aus seiner Konfigurationsdatei ($config.dat, system.va, system.xml, SYSTEM.SYS) wie File > Open robot project |
| save_knowledge | speichert, was Sie dem Agenten beigebracht haben, als eigene Wissensdatei und fügt sie dem Wissen des Agenten hinzu (siehe Den Agenten anlernen) |
| ai_chat | das Fenster KI-Agent selbst, für Skripte und VeRa (siehe API); im Chat nicht benutzt |
| ui_set scroll | blättert ein Textfeld oder eine Liste: "top", "bottom",
0..1 oder "find:Text" – z. B. das Gespräch dieses Fensters für einen Screenshot |
Wissensdateien – Ihre eigenen Benutzer-Plugins
Was der Agent weiß und wie er arbeitet, steht in Wissensdateien: Markdown-Dateien (.md) in einfachem
Englisch. Alle .md- und .mdk-Dateien des Ordners <Installation>\AIAgent\knowledge werden beim Start
des Fensters KI-Agent automatisch geladen (Robot Cell Simulator: <Installation>\template\RCS\AIAgent\knowledge).
Sie gehen als Anweisungen an das Modell.
Wissenspakete von DrAmaT (*.mdk) AI agent knowledge
(seit 2026-10-21): das Installationsprogramm liefert das Wissen von DrAmaT nur als Wissenspakete – signierte
und verschlüsselte Dateien, die außerhalb von DReS weder lesbar noch änderbar sind. Ein Paket wird nur geladen, wenn der
Schlüssel Folgendes hat:
- die Lizenz 247 AI agent knowledge und
- die Update-Lizenz des Jahres des Pakets (z. B. Update 2026, Merkmal 207). Ein Paket einer neueren Version, das in eine ältere Installation kopiert wird, wird daher ohne das Update seines Jahres nicht geladen.
Der Agent gibt das Wissen von DrAmaT nicht heraus: er zeigt es nicht wörtlich, nicht vollständig, nicht übersetzt und schreibt es nicht in eine Datei; Learn speichert nur das, was Sie ihm im Chat beigebracht haben. Fragen Sie ihn, was er kann – er antwortet in eigenen Worten. Beim Anbieter Claude Code werden die entschlüsselten Anweisungen in einer temporären Datei übergeben, die DReS löscht, sobald Claude Code gestartet ist.
Ein nicht geladenes Paket ist in der Liste der Wissensdateien der Einstellungen
rot; sein Tooltip nennt den Grund, z. B. License 247 - AI agent knowledge ... not
found oder The knowledge pack of 2026 requires the license Update 2026 (feature 207). Die Zusammenfassung des
Wissens im Chat meldet Not loaded: Datei (Grund). Der Agent arbeitet dann ohne dieses Wissen.
Help > License info listet alle installierten Pakete mit ihrem Zustand. Ihre
eigenen .md-Dateien brauchen keine Lizenz.
Nach Themen aufgeteilt, gemeinsames Wissen (seit 2026-10-20): das Wissen ist auf
mehrere Dateien verteilt, und der Ordner <Installation>\AIAgent\knowledge\common enthält das Wissen, das
beide Agenten lesen (der Editor und der Robot Cell Simulator):
dres_00_overview.md, vw_10_program_structure.md, vw_20_interlocks.md,
vw_30_optimization_patterns.md, vw_40_good_programs.md, vkrc_commands.md, fanuc_commands.md.
Reihenfolge beim Laden:
- die Anleitung des Agenten (
editor_agent_instructions.md, Simulator:rcs_agent_instructions.md); - die gemeinsamen Dateien (
knowledge\common\*.md); - die übrigen Dateien des Ordners des Agenten, alphabetisch – die Nummern im Namen bestimmen die Reihenfolge
(z. B.
editor_10_commands.md); - Ihre eigenen Wissensdateien, in den Einstellungen hinzugefügt (wie bisher) – sie haben Vorrang für konkrete Anlagen und Stationen.
Der Agent kann Ihre eigenen Wissensdateien auch selbst schreiben: was Sie ihm im Chat beibringen, speichert er mit Learn oder auf Ihren Wunsch (siehe Den Agenten anlernen). Die installierten Dateien ändert er nie.
Eine Wissensdatei wirkt wie ein Benutzer-Plugin für den Editor – ein KI-Agent, in Worten geschrieben statt in
Code. Sie beschreibt, was zu prüfen ist, welche Befehle des Editors zu benutzen sind und wie zu antworten ist; der Agent
benutzt dann die Funktionen des Editors (die API-Befehle oben): er liest und prüft die Programme aller Roboterprojekte, ändert
sie (immer zuerst mit dryRun) und speichert sie auf Wunsch. Die installierten Pakete lassen sich nicht bearbeiten – schreiben
Sie eigene .md-Dateien und fügen Sie sie mit Add… in den Einstellungen
hinzu (außerhalb der Installation ablegen, siehe unten). Schreiben Sie die Anweisungen am besten auf Englisch, wie die eingebauten Dateien.
Ideen für eigene Benutzer-Plugins:
- Prüfungen der Firma vor der Auslieferung eines Roboters (z. B. HOME am Anfang und Ende jeder Folge, kein Punkt mit Werkzeug 0, alle benutzten Werkzeuge und Basen definiert, Versionen der User-Dateien);
- Namensregeln für Programme, Punkte und Kommentare;
- Standardparameter von Technologiebefehlen (z. B. die erlaubten FahrzeugTyp und Offset der Schweißpunkte, Kleberparameter) – der Agent listet die Abweichungen und bietet die Änderung an;
- Berichte in fester Form (Tabelle je Roboter, CSV für Excel) für die Inbetriebnahme oder den Kunden.
Version: jede Wissensdatei hat oben eine Versionszeile, z. B. Version: 1.6 (2026-10-18), und am Ende
eine Versionsgeschichte. Die Version steht in der Liste der Wissensdateien in den Einstellungen, z. B.
editor_agent_instructions.md (version 1.6) [knowledge folder], und im Chat, wenn das Wissen geladen wird. Geben Sie auch
Ihren eigenen Dateien eine Versionszeile – dann sehen Sie sofort, welchen Stand eine Installation benutzt.
Nach einer Änderung einer Datei: Refresh knowledge in den Einstellungen oder /reload im Chat
lädt die Dateien neu; das Gespräch bleibt. /knowledge im Chat listet die Wissensdateien, die der Agent benutzt,
mit Version, Titel und dem ersten Satz jeder Datei, und die Dateien, die nicht geladen sind.
| Eingebaute Wissensdateien (Editor) | Inhalt |
editor_agent_instructions.mdk | Regeln des Editor-Agenten: wie die Befehle zu benutzen sind, nie ungefragt speichern, dryRun vor einer Änderung, Tabellen und Farben in den Antworten, echte Projektnamen (Version 2.0) |
editor_10_commands.mdk | die Befehle der Editor-API für den Agenten und ihre Verwendung |
common\*.mdk | gemeinsames Wissen beider Agenten: Überblick über DReS, VW-Programmstruktur, Verriegelungen, Optimierungsmuster, gute Programme, Befehle VKRC und Fanuc |
robot_data_spy_agent.mdk | RobotDataSpy – Roboterdaten finden und prüfen ohne XML-Muster oder JavaScript-Regeln; unabhängig vom Plugin Robot Data Spy |
.md-Dateien stehen. Haben eine .md-Datei und ein Paket denselben Namen, liest DReS die
neuere Datei. Geben Sie eigenen Dateien eigene Namen (z. B. company_checks.md), am besten in einem Ordner
außerhalb der Installation, und fügen Sie sie mit Add… in den Einstellungen hinzu.Den Agenten anlernen – eigene Wissensdateien
Der Agent lernt von Ihnen. Verbinden Sie Ihren eigenen KI-Anbieter (einen OpenAI-kompatiblen Dienst wie Azure OpenAI oder den LLM-Dienst Ihrer Firma, die Anthropic-API oder Claude Code – siehe Verbindung), erklären Sie im Chat, wie die Dinge in Ihrer Anlage gemacht werden, korrigieren Sie den Agenten, wenn er falsch liegt – und lassen Sie ihn das als Wissensdatei speichern. Die Datei wird den Wissensdateien hinzugefügt und in jedem neuen Chat automatisch geladen; Sie müssen dasselbe nicht noch einmal erklären.
Was der Agent speichert: nur bleibendes Wissen – Regeln der Zelle oder der Anlage, Abläufe, wie Ihre Aufgaben im
Editor erledigt werden, Codemuster, Prüfungen von Programmen, Bedeutungen von Signalen und Namen. Kurz und genau, in Markdown
mit Überschriften, eine Datei je Thema mit einem kurzen englischen Namen (z. B. cell_rules.md); eine vorhandene
Datei desselben Themas bekommt einen neuen Abschnitt. Passwörter, Schlüssel, persönliche Daten und einmalige Ergebnisse
werden nicht gespeichert. Am Ende sagt der Agent in ein oder zwei Sätzen, was er wo gespeichert hat.
Wege zum Speichern:
- Schaltfläche Learn (Doktorhut mit KI-Funken) in der Spalte der Schaltflächen rechts vom Chat, unter New chat: der Agent sieht sich diesen Chat an und speichert, was Sie ihm beigebracht oder korrigiert haben; wurde nichts Neues beigebracht, meldet der Chat das und speichert nichts;
- Kontextmenü des Chats (Rechtsklick): Teach the agent - save what it learned as a knowledge file – dasselbe wie die Schaltfläche;
- automatisch: der ankreuzbare Eintrag Save the knowledge automatically before a new chat im selben Kontextmenü oder das Kontrollkästchen Save what the agent learned automatically before each new chat in den Einstellungen. Vor New chat (auch Clear (new chat) im Kontextmenü) speichert der Agent zuerst das Wissen dieses Chats, danach beginnt der neue Chat. Das kostet eine Anfrage an das Modell; Stop während des Speicherns lässt das Gespräch stehen;
- in eigenen Worten, z. B. „Merke dir diese Regel“ oder „Speichere dieses Wissen in einer neuen Wissensdatei“.
Ordner: das Feld Your knowledge files: in den Einstellungen; leer = der Ordner
knowledge im Ordner der Dateien des Agenten (Settings > AI Agent > Command API, Standard
Dokumente\DReS AI\knowledge). Dateien, die Sie woanders ablegen: mit Add… in der Liste der
Wissensdateien hinzufügen. Der Agent schreibt nie in die Installation.
Die Dateien gehören Ihnen: einfaches Markdown (.md, UTF-8), keine Lizenz nötig – öffnen Sie sie in
einem beliebigen Texteditor, korrigieren oder kürzen Sie sie, löschen Sie, was falsch ist. Eine neue Datei bekommt eine
Versionszeile, z. B. Version: 1.0 (2026-10-24); ein hinzugefügter Abschnitt beginnt mit
## Added 2026-10-24. Nach einer Änderung lädt /reload im Chat das Wissen neu; /knowledge
listet die Dateien, die der Agent benutzt. Speichert der Agent eine Datei während seiner Arbeit, wird sie im nächsten Chat oder
nach /reload geladen; ist er untätig (z. B. der Befehl aus einem Skript), sofort.
API: der Editor-Befehl save_knowledge schreibt eine solche Datei;
ai_chat learn, autoLearn und learnDir tun dasselbe wie die Schaltfläche und die
Einstellungen (siehe API).
Befehle im Chat
Sie wirken lokal – keine Anfrage an das Modell, keine Tokens:
/help– was der Agent macht, Beispiele, die Befehle, die aktuelle Verbindung und der Pfad des Protokolls des Agenten;/reload– lädt die Wissensdateien neu (das Gespräch bleibt);/knowledge(auch/wissen,/wiedza) – listet das Wissen des Agenten: die Kopfzeile Knowledge of the agent: N loaded, K not loaded, dann ein Eintrag je Datei – [pack] (Wissenspaket.mdk) oder [file] (.md), Name, Version, Titel und der erste Satz der Datei; ein Paket, das nicht gelesen werden kann, erscheint als [locked] Datei - Grund (Lizenzen: Help > License info);/anonymous on|off(kurz:/anon on|off) – schaltet den anonymen Modus ein oder aus (ein neuer Chat beginnt);/mode– zeigt den Modus und, wenn er an ist, den Schlüssel R1 = 0001R01, ….
Namen in den Antworten: der Agent schreibt die echten, vollständigen Namen der Roboterprojekte (z. B. 0001R05, nicht R05); gekürzt auf R1, R2 … werden sie nur im anonymen Modus.
Farben in den Antworten: der Agent markiert wichtige Werte mit
{red}…{/red}, {green}…{/green} und
{orange}…{/orange}; der Chat zeigt sie rot,
grün und orange (auch in Tabellen). Sie
können es im Prompt verlangen, z. B. „Markiere die Werte 0 rot“.
Direkte Befehle des Editors (ohne Modell)
Jede andere Nachricht, die mit / und einem Buchstaben beginnt, ist ein Befehl der
Editor-API und wird sofort im Programm ausgeführt: ohne Modell und ohne Tokens, auch
während der Agent arbeitet. Syntax: /name schlüssel=wert … oder /name {json}.
Vorschläge: nach / öffnet sich eine Liste der Befehle (auch /help, /reload,
/knowledge, /mode, /anonymous on | off), die beim Tippen kürzer wird; Enter oder Tab übernimmt den gewählten
Befehl, Esc schließt die Liste. Beispiele:
/status– Zustand des Editors;/documents– offene Dokumente (Datei, geändert, aktiv);/projects– Roboterprojekte des Projektbaums;/set_active_project name=R03– setzt das aktive Roboterprojekt;/open {"file":"D:/x/KRC/R03/Program/folge81.src","line":40}– öffnet eine Datei in einer Zeile.
Die JSON-Antwort erscheint im Gespräch (ein Fehler in Rot). Befehle, die etwas ändern, brauchen die Lizenz API /
CLI, wie in der Befehls-API. /ai_chat ist im Chat nicht verfügbar.
Parameter von Technologiebefehlen ändern
Der Agent liest und ändert die Parameter von Technologiebefehlen mit dem API-Befehl tech: VKRC-TECH-Folds (%VUSER) und SERVOZANGE-Folds (%VSERVOGUN) von Folge-, UP- und Makro-Programmen sowie Fanuc CALL VW_USER(...) – in den offenen Programmen oder in allen Programmen der Roboterprojekte (scope projects). Eine vollständige Analyse: Beispiel 2. Weitere Nachrichten:
- Zeige alle SERVOZANGE-Befehle der offenen Programme
- Setze FahrzeugTyp auf 2 in allen Schweißpunkten der offenen Programme – zeig mir zuerst, was sich ändern würde
- Finde alle SERVOZANGE-Befehle in allen Projekten und exportiere ihre Parameter als CSV
Alle Roboterprojekte: der Agent durchsucht die Folge-, UP- und Makro-Dateien der VKRC- und Fanuc-Projekte des Projektbaums auf der Festplatte (wahlweise nur einige Projekte, z. B. R04 und R05, oder nur einige Programme, z. B. nur UP-Programme; standardmäßig höchstens 300 Dateien). Lesen öffnet nichts – die Dateien werden von der Festplatte gelesen, nichts wird geändert. Nur für eine Änderung werden die Dateien mit passenden Befehlen im Editor geöffnet – sie bleiben offen, damit Sie sie prüfen und speichern können. Bedingungen wie Offset > 0 oder FahrzeugTyp != 6 wählen die Befehle aus. CSV: die Liste der Befehle lässt sich in eine CSV-Datei schreiben (eine Zeile je Befehl, Spalten Project;File;Line;Command, eine Spalte je Parameter und Text; Trennzeichen ;, UTF-8 mit BOM – öffnet sich in Excel).
Zuerst ein Probelauf: vor einer Änderung führt der Agent tech mit dryRun aus und zeigt Ihnen die Liste der Änderungen (Zeile, alter und neuer Text, Fehler). Erst nach Ihrer Bestätigung ändert er die Programme.
- Die Parameternamen sind die Namen aus dem Dialog des Befehls (aus den Definitionen des VW User, z. B. Fzg-Typ, Techaufruf); SERVOZANGE: Programmnummer, Punktnummer, FahrzeugTyp, Offset, TeachIn, Ausgleich, Kraft, Blechdicke, …, Bedingung. Strom, Doppelhub und Messen lassen sich nur im Dialog des Folds ändern. Werte einer Liste können als Nummer oder als Text angegeben werden.
- VW User: die VKRC-TECH-Definitionen kommen vom in der Symbolleiste gewählten VW User (Select vw user), der beim Aktivieren eines Roboterprojekts automatisch gesetzt wird. Dateien des aktiven Projekts werden geändert. Eine Datei eines anderen Projekts: nur geändert, wenn ihr VW User (gelesen aus KRC\R1\VW_User\vw_usr_s.src) derselbe ist wie in der Symbolleiste, sonst aktiviert der Agent zuerst dieses Projekt (set_active_project). Eine Datei außerhalb aller Projekte nur mit useSelectedVwUser. Fanuc: nur Dateien des aktiven Projekts. SERVOZANGE-Folds brauchen keinen VW User.
- Die Änderung bleibt im Editor – die Dokumente sind geändert, nicht gespeichert; der Agent speichert sie nur auf Ihren Wunsch. Rückgängig (Undo) funktioniert für diese Änderungen nicht. Beim Speichern wird der KRL-Code neu erzeugt (z. B. VW_SGB_SPOT_ADV/MAIN(...,FahrzeugTyp,...)); das Speichern eines VKRC-Programms normalisiert sein Format.
- Erfordert die Lizenz API / CLI.
RobotDataSpy – Roboterdaten finden und prüfen
Der KI-Agent des Editors enthält das Wissen RobotDataSpy (Datei AIAgent\knowledge\robot_data_spy_agent.md,
wird beim Start des Fensters KI-Agent immer geladen). Es ist unabhängig vom Plugin Robot Data Spy: keine
XML-Muster und kein JavaScript nötig. Sie sagen in einfachen Worten, was gefunden werden soll – welche Werte,
welche Fehler, welche Roboter –, und der Agent baut die Suche selbst mit den Editor-Befehlen
search, robot_data,
points und tech. Er antwortet mit einer kompakten Tabelle und
den Schlussfolgerungen und sagt in einer Zeile, wie er gesucht hat (z. B. up*.src von 5 Robotern durchsucht, 21
Dateien). Er liest nur – nichts wird geöffnet, nichts wird geändert. Eine vollständige Prüfung:
Beispiel 1.
Datenquellen:
- Roboterkonfiguration – was die Registerkarten Robot info, Profinet und CTB data zeigen: Name, Modell, Seriennummer, Software, VW User, IP-Adresse, Werkzeuge, Basen, Lasten, Profinet-Geräte, EtherCAT-Module (KUKA), Kalibrierung (Justage), Achsgrenzen – für alle Roboterprojekte des Projektbaums, auch die inaktiven (VKRC, KRC, Fanuc, ABB, Yaskawa);
- Programmdateien auf der Festplatte – Suche mit einem regulären Ausdruck in den Dateien der Roboterprojekte (Folge, UP, Makro, $config.dat, $machine.dat …), die gefundenen Werte mit ihrer Anzahl;
- Punkttabellen – X, Y, Z, A, B, C, S, T, Werkzeug und Basis jedes Punkts (wie der Export der Punkttabelle), die Länge der TCP-Bahn, die Bewegungszeit und die Prozesslänge (z. B. Kleber) zwischen den Zeilen, die den Prozess ein- und ausschalten.
Weitere Beispiele für Nachrichten:
- Zeige die Koordinaten der Punkte von UP42 von 0001R05 in einer Tabelle und die Länge der TCP-Bahn
- Wie lang ist die Kleberbahn in UP12? (der Agent sucht zuerst die Zeilen, die den Kleber ein- und ausschalten, und sagt, welche Zeilen er benutzt hat)
- Welche Roboter fordern die Kollisionsbereiche A81 bis A96 an und wo?
Ein großes Ergebnis wird zusammengefasst; der Agent bietet einen CSV-Export an (öffnet sich in Excel). Wenn der Agent etwas mit seinem Wissen nicht kann, sagt er es – neue Funktionen kommen auf Wunsch der Kunden hinzu, und Sie können eigene Wissensdateien hinzufügen.
Verbrauch in der Statuszeile
Nach der ersten Antwort zeigt die Statuszeile (Titelleiste des Fensters) Kontext NN % – die Eingabe-Tokens der letzten Anfrage geteilt durch die Einstellung Context window [tokens] – und die Tokens in diesem Chat (Summe aller Anfragen, ein und aus), wahlweise mit (NN % des Limits) der Einstellung Token limit per chat. Farben: grün unter 60 %, orange unter 85 %, rot ab 85 % – dann einen Neuen Chat beginnen.
Konsole als Reiter
Tools > Show / hide console (Alt+3) und Tools > Show / hide AI Agent chat (Alt+4) schalten die Fenster ein und aus – wie den Dateibaum. Im Kontextmenü der Konsole (Rechtsklick) legt Dock next to the AI Agent window die Konsole als Reiter neben das Fenster KI-Agent unten im Hauptfenster – wie Meldungsfenster und KI-Agent im Robot Cell Simulator. Standardmäßig teilen sich Konsole und Chat die Breite halb / halb. So stehen die Meldungen des Editors und der Chat an einer Stelle.
Die angedockte Konsole hat ihre Reiter oben und keine Leiste Tools und keine Schaltfläche Clear: Save, Print, Print to pdf, Export, Show debug output, Larger font (Ctrl + wheel), Smaller font und Dock next to the AI Agent window stehen im Kontextmenü der Konsole.
Anonymer Modus
Im anonymen Modus sieht das Modell die Namen der Anlage nicht: DReS ersetzt sie durch Kennungen, bevor ein Text an das Modell geht, und setzt in dem, was vom Modell kommt, die echten Namen wieder ein (in beide Richtungen).
| Daten | Was das Modell sieht |
| Namen der Roboterprojekte (z. B. 0001R01) | R1, R2 … |
| Dateipfade | <file N> |
| Kennungen der Anlage | <name> |
Umschalten: /anonymous on | off (oder /anon on | off) im Chat,
Kontrollkästchen Anonymous mode in den Einstellungen oder ai_chat anonymous in der
API. Eine Änderung beginnt einen neuen Chat. Mit Claude Code darf der Agent in diesem Modus keine Dateien
lesen (die Dateien enthalten die echten Namen).
Frage vor den ersten echten Daten: ist das Kontrollkästchen Ask before the first sending of real data (YES / ANON / NO) an (im Editor standardmäßig aus, im Simulator standardmäßig an) und der anonyme Modus aus, wird die erste Nachricht an das Modell zurückgehalten, und der Chat fragt: YES (JA) – echte Daten senden, ANON – anonymen Modus einschalten, NO (NEIN) – nichts wird gesendet. Einzelheiten: Fenster KI-Agent des Simulators.
Verbindung zum Modell
Alle Wege brauchen die Zusatzlizenz API / CLI.
Ihr eigener Zugang zum KI-Modell: Der Agent nutzt Ihr Konto oder Ihren API-Schlüssel (Anthropic, ein OpenAI-kompatibler Dienst wie VW LLMaaS / Azure OpenAI, Ihr eigenes claude.ai-Konto) oder ein lokales Modell (z. B. Ollama). Die Nutzung des Modells bezahlen Sie direkt bei Ihrem KI-Anbieter im Rahmen Ihres eigenen Vertrags – DReS berechnet keine KI-Gebühren und setzt keine eigenen Nutzungsgrenzen; die DReS-Lizenz deckt nur das Programm ab.
| Weg | Wie es funktioniert |
| A. Anthropic API – API-Schlüssel | DReS spricht direkt mit dem Modell (console.anthropic.com, Sie bezahlen die Tokens); der schnellste Weg |
| B. Claude Code – Ihr claude.ai-Konto | kein API-Schlüssel; DReS startet Claude Code mit dem
MCP-Server VeRa (AIAgent\vera_mcp.py, Python 3); Claude Code steuert den Editor über die Befehls-API.
Die Befehls-API muss eingeschaltet sein: Settings > Configure > AI Agent > Command API. Nur für
die eigene Nutzung |
| C. OpenAI-kompatible API | VW LLMaaS, Azure OpenAI, OpenAI, ein lokales Ollama oder ein anderer Anbieter: Adresse, Token und Modell |
Die Schritte (Konto, Schlüssel, Anmeldung von Claude Code, Python) sind dieselben wie beim Simulator: Einrichtung Schritt für Schritt.
Einstellungen
Settings > Configure > AI Agent, Registerkarte AI Agent window (die Seite hat vier Registerkarten; die anderen beschreibt VeRa). Die Schaltfläche Einstellungen im Chat öffnet direkt diese Registerkarte.
| Feld | Bedeutung |
| Provider | Anbieter: Anthropic API (Claude) – mit API-Schlüssel; OpenAI-compatible API (VW LLMaaS, Azure OpenAI, OpenAI, local Ollama); Claude Code - your claude.ai account (own use only) (siehe Verbindung) |
| Claude Code program, Python | nur für Claude Code: claude.exe (wird im PATH automatisch gefunden) und
das Python 3, das den MCP-Server AIAgent\vera_mcp.py ausführt |
| Address | Adresse der API, vorbelegt mit der Standardadresse des Anbieters; VW LLMaaS: die Adresse aus dem LLMaaS-Portal (…/chat/completions) |
| API key / token | der Schlüssel des Anbieters; gespeichert in den Einstellungen dieses Windows-Benutzers (verschleiert) |
| Key header | nur für die OpenAI-kompatible API: Authorization (Bearer-Token, Standard) oder z. B. api-key (Azure OpenAI) |
| Model | Name des Modells, z. B. claude-sonnet-5-5; leer = Standard des Anbieters |
| Steps per message | höchste Anzahl Befehle des Agenten für eine Nachricht – schützt vor Schleifen und Kosten |
| Context window [tokens] | Größe des Kontexts des Modells, für den Prozentwert in der Statuszeile |
| Token limit per chat | Grenze eines Chats (ein + aus) für den farbigen Prozentwert; no limit möglich |
| Anonymous mode | siehe Anonymer Modus |
| Ask before the first sending of real data (YES / ANON / NO) | siehe Frage vor den ersten echten Daten; im Editor standardmäßig aus, im Simulator standardmäßig an |
| Knowledge files | die Liste der Wissensdateien mit ihren Versionen; die Dateien des Wissensordners sind mit [knowledge folder] markiert und werden immer geladen; Add… / Remove für weitere Dateien, Default – nur die installierten Dateien, Refresh knowledge – Liste speichern und Dateien neu laden; ein Wissenspaket, das sich nicht laden lässt, ist rot, der Grund steht im Tooltip |
| Save what the agent learned automatically before each new chat | vor New chat / Clear speichert der Agent zuerst, was Sie ihm in diesem Chat beigebracht haben, als Wissensdateien (eine Anfrage an das Modell), danach beginnt der neue Chat; Standard aus; siehe Den Agenten anlernen |
| Load the AI knowledge on startup (warm-up in the background) | etwa 8 Sekunden nach dem Start liest das
Programm in einem Hintergrund-Thread die Wissensdateien und startet einmal Claude Code (claude --version)
und Python, damit die erste Nachricht im Chat schneller beantwortet wird; keine Anfrage an das Modell, kein
Netzwerkverkehr, keine Token; tut nichts, wenn keine Verbindung zum Modell eingestellt ist (Claude Code nicht
gefunden, kein API-Schlüssel, kein OpenAI-Schlüssel mit Adresse); Standard aus; getrennt für Editor und
Simulator |
| Your knowledge files: | Ordner der Wissensdateien, die der Agent schreibt (Learn,
save_knowledge); leer = <Ordner der Dateien des Agenten>\knowledge, Standard
Dokumente\DReS AI\knowledge; nur im Editor |
| Getrennt pro Programm | Editor | Robot Cell Simulator |
Wissensordner (alle .md- / .mdk-Dateien werden geladen) | <Installation>\AIAgent\knowledge |
<Installation>\template\RCS\AIAgent\knowledge |
| Gemeinsames Wissen (lesen beide, nach der Anleitung des Agenten) | <Installation>\AIAgent\knowledge\common | |
| Kontrollkästchen Ask before the first sending of real data (YES / ANON / NO) | Standard aus | Standard an |
Lizenz: das Fenster braucht die Zusatzlizenz API / CLI. Ohne sie wirken nur die lesenden
direkten Befehle (sowie /help, /reload).
Protokoll des Agenten: %TEMP%\dres_rcs_agent\ai_agent_JJJJMMTT.log (eine Datei pro Tag, gemeinsam mit
dem Simulator); /help zeigt den Pfad.
API
Editor-Befehl ai_chat (Pipe DReS_API, siehe Editor-API); braucht die Lizenz API / CLI:
| Parameter | Bedeutung |
| show | true zeigt das Fenster, false blendet es aus |
| message | sendet eine Nachricht an den Agenten (zeigt auch das Fenster); Antwort auf die Frage:
"yes" | "anon" | "no" |
| stop | true hält den Agenten an |
| newChat | true beginnt einen neuen Chat wie die Schaltfläche New chat (mit
autoLearn speichert der Agent zuerst das Wissen dieses Chats) |
| learn | true – wie die Schaltfläche Learn: der Agent speichert, was ihm in diesem Chat
beigebracht wurde, als Wissensdateien (Den Agenten anlernen) |
| autoLearn | true | false – die Einstellung Save what the agent learned
automatically before each new chat |
| learnDir | Ordner Ihrer Wissensdateien (die Einstellung Your knowledge files:); "" =
Standardordner |
| anonymous | true | false – anonymer Modus |
| warmUp | true | false – die Einstellung Load the AI knowledge on startup
(warm-up in the background) |
| last | Anzahl der letzten Einträge des Gesprächs in transcript (Standard 20) |
Antwort: visible, busy, anonymous, autoLearn, learnDir (der benutzte Ordner),
warmUp (die Einstellung), connectionConfigured (true, wenn eine Verbindung zum Modell eingestellt
ist: Claude Code gefunden / API-Schlüssel / OpenAI-Schlüssel und Adresse), consentPending (die Frage YES / ANON / NO wartet), transcript. Beispiel: {"cmd":"ai_chat","message":"Zeige die Roboterprojekte","last":5}. Das Gespräch lässt
sich mit ui_set scroll blättern ("top", "bottom",
0..1, "find:Text").
Probleme
| Symptom | Was tun |
| Claude Code reaches the editor through its command API - switch it on… | Settings > Configure > AI Agent > Command API: die Befehls-API des Editors einschalten |
| Nachrichten werden abgelehnt, roter Text in der Statuszeile | die Lizenz API / CLI oder der API-Schlüssel fehlt |
| Kontext NN % rot | einen Neuen Chat beginnen |
| eine geänderte Wissensdatei wirkt nicht | Refresh knowledge oder /reload; die Version in der
Liste der Wissensdateien prüfen |
eine Wissensdatei *.mdk ist rot, Not loaded: … im Chat | die Lizenz 247 AI agent knowledge oder die Update-Lizenz des Jahres des Pakets fehlt (Tooltip der Datei, Help > License info) – Lizenz kaufen oder verlängern bei dramat.eu |
| Anmeldung von Claude Code, Python, HTTP-Fehler | siehe Probleme des Fensters KI-Agent des Simulators – die Ursachen sind dieselben |

