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.
|
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:
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. |
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 |
| Steht in allen Projekten zur Verfügung. |
Projekt-Workspace | .coagent\agents\mein-agent\agents.md | 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 |
|---|---|---|
| string | Basis-Name des Agenten (erforderlich). |
| string | Kurzbeschreibung für das Agent-Drop-down-Menü. |
| bool |
|
| 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 |
|
| Liste | Andere Agenten, an die dieser Agent delegieren darf: Namen, Muster 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.