Projekt-Workspace

Der Projekt-Workspace ermöglicht eine projektspezifische Konfiguration von Agenten und MCP-Servern. Die Konfiguration wird im Verzeichnis .coagent/ im Ordner der TwinCAT-Solution gespeichert und beim Öffnen der Solution in Visual Studio automatisch aktiviert.

Verzeichnisstruktur

.coagent/
├── COAGENT.md        ← Projektspezifische Anweisungen
├── agents/           ← Projektspezifische Agenten-Definitionen
│   └── mein-agent/
│       └── agents.md
├── skills/           ← Projektspezifische Skills
│   └── mein-skill/
│        └── SKILL.md
└── mcp.json         ← Projektspezifische MCP-Server-Konfiguration

Integration im Solution Explorer

Wenn ein TwinCAT-Projekt mit einem .coagent/-Ordner in Visual Studio geöffnet ist, wird im Solution Explorer automatisch ein CoAgent Workspace-Knoten eingeblendet. Der Knoten enthält folgende Unterknoten:

Unterknoten

Beschreibung

Agents

Spiegelt den Inhalt von .coagent/agents/: zeigt Agenten-Ordner und deren Definitionsdateien.

MCPs

Spiegelt .coagent/mcp.json: zeigt die projektspezifische MCP-Server-Konfiguration.

Änderungen im Dateisystem werden im Solution Explorer sofort angezeigt. Ein Doppelklick auf einen Eintrag öffnet die Datei im Editor. Anweisungen (COAGENT.md) und Skills werden derzeit nicht im Solution Explorer angezeigt. Sie werden im Dateisystem gepflegt (siehe unten).

Agenten konfigurieren

Legen Sie Agenten vorzugsweise unter Settings > Agents mit dem Geltungsbereich Workspace an. Die Definition liegt als agents.md in einem eigenen Unterordner von .coagent/agents/. Das Dateiformat ist im Kapitel Agenten beschrieben. Neue Dateien und Ordner werden im Solution Explorer angezeigt.

Anweisungen und Skills

Eine Datei COAGENT.md enthält Anweisungen, die in jedem Chat berücksichtigt werden. Skills sind wiederverwendbare Vorgehensweisen, die als SKILL.md in einem eigenen Unterordner abgelegt und vom Agenten bei Bedarf geladen werden. Beide können global oder je Projekt abgelegt werden:

Speicherort

Anweisungen

Skills

Global

%PROGRAMDATA%\Beckhoff\TwinCAT\Functions\CoAgent\COAGENT.md

%PROGRAMDATA%\Beckhoff\TwinCAT\Functions\CoAgent\skills\<name>\SKILL.md

Projekt-Workspace

.coagent\COAGENT.md
im Solution-Ordner

.coagent\skills\<name>\SKILL.md
imSolution-Ordner

Globale und projektspezifische Anweisungen werden gemeinsam verwendet. Ein Projekt-Skill überdeckt einen globalen Skill gleichen Namens. Skills aus installierten Addons werden mit dem Namen des Addons als Präfix geführt (z. B. plc:deploy ) und kollidieren dadurch nicht mit eigenen Skills.

Agenten-Dateien, COAGENT.md, Skills, .coagentignore, mcp.json, Einstellungsdateien und Textanhänge werden als UTF-8, UTF-16 oder ANSI gelesen, mit oder ohne Byte-Order-Mark. Dies schließt Dateien ein, die mit Windows PowerShell 5.1 erzeugt wurden. Von CoAgent gespeicherte Dateien sind stets UTF-8.

MCP-Server konfigurieren

Projektspezifische MCP-Server werden in .coagent/mcp.json konfiguriert (siehe Kapitel Eigene MCP-Server).

Projekt-Workspace 1:

Der Projekt-Workspace wird beim Öffnen der TwinCAT Solution automatisch geöffnet und beim Schließen der Solution wieder geschlossen.