Skip to main content

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

On this page

Пользовательские агенты

Создавайте пользовательских агентов с собственным системным промптом, моделью и разрешениями. Агенты — это Markdown-файлы с YAML-метаданными.

📸 SCREENSHOT: custom-agent-config.png

Файл конфигурации пользовательского агента

Файл и расположение

Пользовательские агенты — это файлы *.md в каталоге agent/ или agents/ внутри любой папки .cyberstrike/ (проекта или ~/.cyberstrike/). ID агента — это имя файла.

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

Метаданные

.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 …

Тело (после метаданных) является системным промптом.

ПолеТипОписание
descriptionstringДля чего предназначен агент
modeprimary | subagent | allprimary агенты запускаются напрямую; subagent агенты делегируются через инструмент задач
modelstringПереопределение provider/model
temperature, top_pnumberНастройки семплирования
stepsnumberМаксимум агентных итераций
colorstringHex или цвет темы
permissionobjectРазрешения для инструментов (см. Разрешения)
hidden, disablebooleanСкрыть из picker / отключить

Caution

Ограничивайте инструменты с помощью поля permission. Старая карта tools: устарела, и поля allowedCommands нет — ограничения команд задаются glob-правилами permission.bash (например, bash: { "nmap *": "allow" }).

Primary vs Subagent

Только primary агенты могут быть выбраны через --agent или default_agent. Если вы хотите, чтобы ваш агент запускался напрямую, установите mode: primary. В противном случае он ведёт себя как подагент, которому агент cyberstrike может делегировать задачи.

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


You are a read-only security auditor …

Использование пользовательского агента

После создания primary агента выберите его:

Terminal window
cyberstrike --agent api-security

Или установите как агента по умолчанию в cyberstrike.json:

{
  "default_agent": "api-security"
}

Просматривайте агентов в TUI с помощью /agents.

Лучшие практики

  1. Узкий scope — одна чёткая цель на агента.
  2. Минимальные привилегии — разрешайте только необходимые инструменты через permission.
  3. Чёткий промпт — будьте конкретны в отношении методологии и формата вывода.
  4. Контроль версий — коммитьте .cyberstrike/agents/ вместе с проектом.

Связанная документация