Agenten

Agenten sind spezialisierte Konfigurationen, die einen Systemprompt mit einem definierten Satz an MCP-Tools kombinieren. Jeder Agent deckt einen bestimmten Aufgabenbereich ab. Der aktive Agent wird über das Agent-Dropdown in der Headerleiste ausgewählt. Agenten können Teilaufgaben an andere Agenten übergeben (Delegation, siehe unten).

PLC-Agent

Der PLC-Agent unterstützt die SPS-Entwicklung in Structured Text (IEC 61131-3). SPS-Code wird gelesen, erstellt, geändert und gesucht. Signaturen von Funktionsbausteinen aus referenzierten Bibliotheken werden vollständig berücksichtigt, einschließlich Ein- und Ausgangsparametern, Enumerationswerten und Strukturelementen. Zusätzlich steht eine direkte Suche in der Beckhoff-Dokumentation zur Verfügung.

Alle Schreiboperationen des PLC-Agenten (Erstellen, Ändern, Löschen von POUs) werden nicht direkt in das laufende TwinCAT-Projekt übertragen. Stattdessen werden die Änderungen im Changeset gesammelt und dem Benutzer zur Prüfung vorgelegt (siehe Changeset-Workflow).

Infosys-Explorer

Der Infosys-Explorer ermöglicht die gezielte Suche in der Beckhoff-Dokumentation im Beckhoff Information System (InfoSys). Alle Antworten werden ausschließlich aus der Dokumentation abgeleitet und mit Quellenangaben versehen. Der Agent eignet sich für Fragen zu Funktionsbausteinen, Bibliotheken, EtherCAT-Terminals und Konfigurationsparametern.

System-Manager-Agent

Der System-Manager-Agent ermöglicht die Konfiguration von TwinCAT-Projekten, I/O-Geräten und EtherCAT-Topologien sowie das Deployment auf Zielsysteme.

Hinweis

Datenverlust durch destruktive Aktionen des System-Manager-Agenten

Der System-Manager-Agent kann destruktive Aktionen ausführen, darunter das Löschen von Projektelementen, das Überschreiben von Gerätekonfigurationen und das Aktivieren von Konfigurationen auf dem Zielsystem. Eingerichtete Tool-Freigaben können Bestätigungsdialoge unterdrücken.

  • Prüfen Sie Anfragen an den System-Manager-Agenten sorgfältig.

Orchestrator-Agent

Der Orchestrator-Agent nimmt Anfragen entgegen und übergibt Teilaufgaben an die jeweils zuständigen Agenten, z. B. das Ändern oder Prüfen von SPS-Code, die Suche in der Beckhoff-Dokumentation oder die I/O-Konfiguration. Einfache Fragen werden direkt beantwortet. Bei mehrdeutigen Anfragen wird nachgefragt. Der Orchestrator-Agent besitzt keine eigenen Tools. Die Werkzeuge werden von den beauftragten Agenten verwendet. Delegierte Aufgaben werden im Chat als aufklappbare Abschnitte angezeigt (siehe Kapitel Nachrichtenanzeige).

Eigene Agenten

Eigene Agenten werden unter Settings > Agents verwaltet. Wählen Sie einen vorhandenen Agenten aus oder legen Sie einen neuen an:

1. Wählen Sie für einen neuen Agenten den Geltungsbereich Global oder Workspace. Für Workspace muss eine Solution geöffnet sein.
2. Geben Sie einen eindeutigen Namen ein.
3. Aktivieren Sie bei einem bestehenden eigenen Agenten Edit mode.
4. Bearbeiten Sie unter Properties die Beschreibung, die Sichtbarkeit (Visible) und den Systemprompt (Content).
5. Unter Tools wählen Sie die verfügbaren Werkzeuge aus.
6. Unter Sub-agents legen Sie fest, ob andere Agenten diesem Agenten Aufgaben übergeben dürfen und an welche Agenten dieser Agent delegieren darf (siehe Delegation).
7. Speichern Sie die Änderungen.
8. Beachten Sie Validierungsfehler und Warnungen zu nicht verfügbaren Tools.
Nicht gespeicherte Änderungen müssen vor dem Verlassen des Editors gespeichert oder verworfen werden.
9. Über + legen Sie einen neuen Agenten an.
Ist ein Agent ausgewählt, können Sie ihn über Copy from als Ausgangspunkt für einen neuen Agenten kopieren. Name und Beschreibung müssen eindeutig sein. Doppelte Namen werden beim Speichern abgewiesen.

Eigene Agenten können Sie nach Bestätigung löschten. Agenten aus installierten Addons sind in dieser Ansicht schreibgeschützt.

Delegation

Im Reiter Sub-agents des Agenten-Editors wird festgelegt, wie ein Agent mit anderen Agenten zusammenarbeitet. Der Reiter zeigt, welche Agenten diesen Agenten verwenden und welche Agenten von ihm verwendet werden:

Agenten 1:

Bereich

Eigenschaft

Bedeutung

Used by other agents

Automatic selection

Andere Agenten dürfen diesen Agenten automatisch für Teilaufgaben auswählen.

Used by other agents

What this agent is for

Beschreibung, wofür der Agent eingesetzt wird und wofür nicht. Der Text wird delegierenden Agenten bei jeder Anfrage mitgegeben.

Used by other agents

Example requests

Beispielanfragen, die an diesen Agenten delegiert werden sollen (höchstens drei).

Uses other agents

Available sub-agents

Agenten, an die dieser Agent Teilaufgaben übergeben darf.

Uses other agents

Filters

Regeln zur Auswahl mehrerer Agenten, z. B. * für alle automatisch wählbaren Agenten oder ! zum Ausschließen eines Agenten.

Delegiert ein Agent eine Teilaufgabe, wird diese im Chat als aufklappbarer Abschnitt angezeigt (siehe Kapitel Nachrichtenanzeige).

Agenten-Dateien

Ein Agent wird in einer Markdown-Datei mit einem YAML-Block am Anfang (Frontmatter) gespeichert. Änderungen werden automatisch geladen. Gültige Agenten mit visible: true stehen in der Agenten-Auswahl zur Verfügung.

Agentendefinitionen können an zwei Orten abgelegt werden:

Speicherort

Pfad

Gültigkeit

Global

%PROGRAMDATA%\Beckhoff\TwinCAT\Functions\CoAgent\agents\mein-agent.md

Steht in allen Projekten zur Verfügung.

Projekt-Workspace

.coagent\agents\mein-agent\agents.md
im Solution-Ordner

Aktiv, solange das jeweilige Projekt geöffnet ist (siehe Projekt-Workspace).

Minimales Agentenbeispiel:

---
name: 'MyAgent'
description: 'Agent description'
visible: true
tools: []
---

You are a helper assistant for TwinCAT PLC projects. Explain the code provided and point out any possible errors.

Der YAML-Block enthält die Konfiguration, der anschließende Text den Systemprompt. Im Beispiel sind noch keine Tools zugeordnet. Wählen Sie diese unter Tools aus, statt Werkzeugnamen aus anderen Installationen zu übernehmen.

Konfigurationsfelder:

Eigenschaft

Typ

Bedeutung

name

string

Basis-Name des Agenten (erforderlich).

description

string

Kurzbeschreibung für das Agent-Drop-down-Menü.

visible

bool

true = in der Agentenauswahl sichtbar. false = versteckt (nur für Unteragenten).

tools

Liste

Exakte Tool-Kennungen aus dem verfügbaren Tool-Katalog.

usage

string

Beschreibung für delegierende Agenten, wofür der Agent eingesetzt wird (What this agent is for).

examples

Liste

Beispielanfragen, die an diesen Agenten delegiert werden sollen (Example requests).

delegatable

bool

true = andere Agenten dürfen diesen Agenten automatisch auswählen (Standard). false = nur bei namentlicher Angabe.

available_subagents

Liste

Andere Agenten, an die dieser Agent delegieren darf: Namen, Muster mit * und Ausschlüsse mit !.

Eine Datei definiert genau einen Agenten mit dem angegebenen name. Abschnittsüberschriften erzeugen keine zusätzlichen Agenten oder Namenszusätze. Die Beschreibung kann in der Auswahl als Beschriftung erscheinen. Visible blendet einen Agenten aus der Auswahl aus. Zum Entfernen verwenden Sie die Löschfunktion für eigene Agenten.

Die Schlüssel für den Chat-Verlauf, für Audioinformationen zu Tool-Aufrufen und für einen Folgeagenten werden nicht mehr unterstützt und haben keine Wirkung. Agenten mit diesen Schlüsseln werden weiterhin geladen. Unter Settings > Agents wird eine Warnung angezeigt. Für die Übergabe an einen anderen Agenten wird die Delegation verwendet.