site/docs/red-team/strategies/hydra.md
The Hydra strategy (jailbreak:hydra) runs a multi-turn attacker agent that adapts to every response from your target system. It maintains structured memory, evaluates past attempts, and branches into new attack approaches when the direct path fails.
Unlike single-turn jailbreaks that retry variations of one payload, Hydra continuously reasons about prior turns, retries with fresh context, and shares learnings across every test in the same scan.
Add the strategy to your promptfooconfig.yaml to enable multi-turn adaptive testing:
redteam:
strategies:
# Basic usage
- jailbreak:hydra
# With configuration
- id: jailbreak:hydra
config:
# Optional: maximum turns before hydra stops (default: 10)
maxTurns: 12
# Optional: how many times to backtrack after refusals in stateless mode (default: 10)
maxBacktracks: 5
# Optional: set true if your target expects session state on each request
stateful: false
::::info Cloud Required
Hydra relies on Promptfoo Cloud to coordinate the attacker agent, maintain scan-wide learnings, and manage branching logic. Set PROMPTFOO_REMOTE_GENERATION_URL or sign in to Promptfoo Cloud before running this strategy.
::::
| Option | Default | Description |
|---|---|---|
maxTurns | 10 | Maximum conversation turns Hydra will take with the target before stopping. Increase for deeper explorations. |
maxBacktracks | 10 | Number of times Hydra can roll back the last turn when it detects a refusal. Set to 0 automatically when stateful: true. |
stateful | false | When true, Hydra sends only the latest turn alongside the session identifier. Keep false (stateless mode) if your target expects the full conversation each time. |
::::tip
Hydra automatically manages backtracking and session handling. In Promptfoo Cloud, it derives session support from the target’s configuration. When using the open-source CLI/UI, set stateful: true in the Hydra configuration if your provider expects persistent sessions.
::::
maxBacktracks, or reaches maxTurns.Hydra keeps a per-scan memory so later test cases can reuse successful tactics discovered earlier in the run.
| Strategy | Turn Model | Best For | Cost Profile |
|---|---|---|---|
jailbreak | Single-turn | Fast baselines, low cost | Low |
jailbreak:meta | Iterative taxonomy | Broad single-shot coverage | Medium |
jailbreak:hydra | Multi-turn branching | Stateful agents, evasive defenses | High |
Hydra is most effective when paired with plugin suites like harmful, pii, or rbac that define concrete failure conditions via graders.