Skip to main content

Cyberstrike is now open source! AI-powered penetration testing for security professionals. Star on GitHub

On this page

Agents personnalises

Creez des agents personnalises avec leur propre prompt systeme, modele et permissions. Les agents sont des fichiers Markdown avec un en-tete YAML.

📸 SCREENSHOT: custom-agent-config.png

Fichier de configuration d’agent personnalise

Fichier et emplacement

Les agents personnalises sont des fichiers *.md dans un repertoire agent/ ou agents/ a l’interieur de n’importe quel dossier .cyberstrike/ (projet ou ~/.cyberstrike/). L’identifiant de l’agent est son nom de fichier.

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

En-tete (frontmatter)

.cyberstrike/agents/api-security.md
---
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 …

Le corps (apres l’en-tete) est le prompt systeme.

ChampTypeDescription
descriptionstringA quoi sert l’agent
modeprimary | subagent | allLes agents primary peuvent etre executes directement ; les agents subagent sont delegues via l’outil de taches
modelstringRemplacement fournisseur/modele
temperature, top_pnumberControles d’echantillonnage
stepsnumberNombre maximal d’iterations agentiques
colorstringCouleur hexadecimale ou couleur du theme
permissionobjectPermissions par outil (voir Permissions)
hidden, disablebooleanMasquer du selecteur / desactiver

Caution

Restreignez les outils avec le champ permission. L’ancienne map tools: est obsolete, et il n’existe pas de champ allowedCommands — les restrictions de commandes sont des regles glob permission.bash (ex. bash: { "nmap *": "allow" }).

Primaire vs sous-agent

Seuls les agents primaires peuvent etre selectionnes avec --agent ou default_agent. Si vous voulez que votre agent soit executable directement, definissez mode: primary. Sinon, il se comporte comme un sous-agent auquel l’agent cyberstrike peut deleguer.

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


You are a read-only security auditor …

Utiliser un agent personnalise

Une fois que c’est un agent primaire, selectionnez-le :

Terminal window
cyberstrike --agent api-security

Ou definissez-le comme agent par defaut dans cyberstrike.json :

{
  "default_agent": "api-security"
}

Parcourez les agents dans le TUI avec /agents.

Bonnes pratiques

  1. Perimetre cible — un seul objectif clair par agent.
  2. Moindre privilege — n’autorisez que les outils dont l’agent a besoin via permission.
  3. Prompt clair — soyez precis sur la methodologie et le format de sortie.
  4. Controle de version — commitez .cyberstrike/agents/ avec le projet.

Documentation associee