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-KonfigurationIntegration 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 |
MCPs | Spiegelt |
Ä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 | .coagent\skills\<name>\SKILL.md |
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).
![]() | Der Projekt-Workspace wird beim Öffnen der TwinCAT Solution automatisch geöffnet und beim Schließen der Solution wieder geschlossen. |
