Skip to main content

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

On this page

Agentes Personalizados

Crie agentes personalizados com seu proprio prompt de sistema, modelo e permissoes. Agentes sao arquivos Markdown com frontmatter YAML.

📸 SCREENSHOT: custom-agent-config.png

Arquivo de configuracao de agente personalizado

Arquivo e Localizacao

Agentes personalizados sao arquivos *.md em um diretorio agent/ ou agents/ dentro de qualquer pasta .cyberstrike/ (projeto ou ~/.cyberstrike/). O id do agente e o nome do arquivo.

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

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 …

O corpo (apos o frontmatter) e o prompt do sistema.

CampoTipoDescricao
descriptionstringPara que serve o agente
modeprimary | subagent | allAgentes primary podem ser executados diretamente; agentes subagent sao delegados via ferramenta de tarefa
modelstringSobrescrita provider/model
temperature, top_pnumberControles de amostragem
stepsnumberMaximo de iteracoes agentivas
colorstringCor hex ou de tema
permissionobjectPermissoes por ferramenta (veja Permissoes)
hidden, disablebooleanOcultar do seletor / desabilitar

Caution

Restrinja ferramentas com o campo permission. O antigo mapa tools: esta obsoleto, e nao existe campo allowedCommands — restricoes de comando sao regras glob de permission.bash (ex: bash: { "nmap *": "allow" }).

Primario vs Subagente

Apenas agentes primary podem ser selecionados com --agent ou default_agent. Se voce quer que seu agente seja executavel diretamente, defina mode: primary. Caso contrario, ele se comporta como um subagente ao qual o agente cyberstrike pode delegar.

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


You are a read-only security auditor …

Usando um Agente Personalizado

Uma vez que e um agente primario, selecione-o:

Terminal window
cyberstrike --agent api-security

Ou defina como padrao em cyberstrike.json:

{
  "default_agent": "api-security"
}

Navegue por agentes na TUI com /agents.

Boas Praticas

  1. Escopo focado — um proposito claro por agente.
  2. Menor privilegio — permita apenas as ferramentas que o agente precisa via permission.
  3. Prompt claro — seja especifico sobre metodologia e formato de saida.
  4. Controle de versao — faca commit de .cyberstrike/agents/ com o projeto.

Documentacao Relacionada