On this page

Benutzerdefinierte Agenten

Erstellen Sie benutzerdefinierte Agenten mit eigenem System-Prompt, Modell und Berechtigungen. Agenten sind Markdown-Dateien mit YAML-Frontmatter.

📸 SCREENSHOT: custom-agent-config.png

Konfigurationsdatei fuer benutzerdefinierte Agenten

Datei & Speicherort

Benutzerdefinierte Agenten sind *.md-Dateien in einem agent/- oder agents/-Verzeichnis innerhalb eines .cyberstrike/-Ordners (Projekt oder ~/.cyberstrike/). Die ID des Agenten ist sein Dateiname.

.cyberstrike/
└── agents/
    ├── api-security.md
    └── compliance-audit.md

Frontmatter

---
description: Specialized agent for REST and GraphQL API testing
mode: primary
model: anthropic/claude-sonnet-4-20250514
permission:
  bash: { "*": "ask", "rm -rf *": "deny" }
  edit: allow
---

You are an expert API security tester specializing in REST and GraphQL APIs.
Follow the OWASP API Security Top 10 …

Der Body (nach dem Frontmatter) ist der System-Prompt.

Feld	Typ	Beschreibung
`description`	string	Wofuer der Agent gedacht ist
`mode`	`primary` \| `subagent` \| `all`	`primary`-Agenten koennen direkt ausgefuehrt werden; `subagent`-Agenten werden ueber das Task-Werkzeug delegiert
`model`	string	`provider/model`-Ueberschreibung
`temperature`, `top_p`	number	Sampling-Steuerung
`steps`	number	Maximale agentische Iterationen
`color`	string	Hex- oder Theme-Farbe
`permission`	object	Pro-Werkzeug-Berechtigungen (siehe Berechtigungen)
`hidden`, `disable`	boolean	Aus der Auswahl ausblenden / deaktivieren

Caution

Beschraenken Sie Werkzeuge mit dem permission-Feld. Die alte tools:-Map ist veraltet, und es gibt kein allowedCommands-Feld — Befehlsbeschraenkungen sind permission.bash-Glob-Regeln (z.B. bash: { "nmap *": "allow" }).

Primaer vs. Subagent

Nur primaere Agenten koennen mit --agent oder default_agent ausgewaehlt werden. Wenn Ihr Agent direkt ausfuehrbar sein soll, setzen Sie mode: primary. Andernfalls verhaelt er sich als Subagent, an den der cyberstrike-Agent delegieren kann.

---
description: Read-only auditor
mode: primary
permission:
  edit: deny
  bash: deny
  read: allow
  glob: allow
  grep: allow
---

You are a read-only security auditor …

Einen benutzerdefinierten Agenten verwenden

Sobald es ein primaerer Agent ist, waehlen Sie ihn aus:

cyberstrike --agent api-security

Oder setzen Sie ihn als Standard in cyberstrike.json:

{
  "default_agent": "api-security"
}

Durchsuchen Sie Agenten in der TUI mit /agents.

Best Practices