> For the complete documentation index, see [llms.txt](https://burp-ai-agent.six2dez.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://burp-ai-agent.six2dez.com/user-guide/prompt-templates.md).

# Prompt Templates

Prompt templates define default instructions for context menu actions. They are sent together with selected Burp context.

Edit them in **Prompt Templates** in the bottom settings panel.

## Default Template Style

Built-in templates use a structured format with explicit sections (`ROLE` / `TASK` / `SCOPE` / `OUTPUT`) to improve consistency and reduce speculative output.

Use [Prompt Defaults](https://burp-ai-agent.six2dez.com/reference/prompt-defaults.md) to review exact built-in defaults.

## Built-In Request Prompts

These templates are used for request/response actions:

| Template                 | Used By                | Purpose                                                                                      |
| ------------------------ | ---------------------- | -------------------------------------------------------------------------------------------- |
| **Find Vulnerabilities** | `Find vulnerabilities` | Broad security analysis across injection, auth/access, disclosure, and configuration issues. |
| **Analyze this request** | `Analyze this request` | Concise endpoint summary.                                                                    |
| **Explain JS**           | `Explain JS`           | JavaScript behavior and risk analysis.                                                       |
| **Access Control**       | `Access control`       | Authorization testing guidance.                                                              |
| **Login Sequence**       | `Login sequence`       | Login flow extraction and replay guidance.                                                   |

## Built-In Issue Prompts

These templates are used for scanner issue actions:

| Template                    | Used By                   | Purpose                                   |
| --------------------------- | ------------------------- | ----------------------------------------- |
| **Analyze this Issue**      | `Analyze this issue`      | Root cause analysis and validation steps. |
| **Generate PoC & Validate** | `Generate PoC & validate` | Step-by-step PoC with expected evidence.  |
| **Impact & Severity**       | `Impact & severity`       | Impact and severity reasoning.            |
| **Full Report**             | `Full report`             | Complete report structure for delivery.   |

## BountyPrompt Controls

BountyPrompt settings are no longer part of **Prompt Templates**. They live beside the saved prompt library in **Custom Prompts → BountyPrompt integration**. See [BountyPrompt Actions](https://burp-ai-agent.six2dez.com/user-guide/bountyprompt-actions.md) for the controls, runtime behavior, and curated IDs.

## Custom Prompt Library

The saved free-form prompt library has its own **Custom Prompts** settings tab, alongside the BountyPrompt integration controls. Manage entries (add/edit/duplicate, ★ favorites, live search, JSON import/export, per-entry context-menu visibility) from that tab; the right-click submenu surfaces the result.

See [Custom Prompts](https://burp-ai-agent.six2dez.com/reference/settings-reference.md#custom-prompts) for the full field/control reference and [Context Menus → Custom Prompt Library](https://burp-ai-agent.six2dez.com/user-guide/context-menus.md#custom-prompt-library) for the launch flow and audit metadata.

## Guide: Prompt Engineering for Pentesters

### Role Prompting

Start with a clear role definition, for example:

> Act as a senior offensive security expert specialized in web application penetration testing.

### Evidence-Based Reasoning

Require concrete evidence:

> Always cite specific header values, parameter names, or response patterns to justify findings.

### Output Formatting

Request a stable structure:

> Provide findings in Markdown with sections for Type, Evidence, Severity, Impact, and Remediation.

### Language Control

To keep team output consistent:

> Always answer in English.

### Scope Limiting

Reduce speculation:

> Only report findings supported by evidence in the provided request/response context.

## Customization Workflow

1. Open **Prompt Templates** in the bottom settings panel.
2. Edit the desired template text.
3. Run a context action to validate result quality.
4. Iterate until output quality matches your workflow.

Tip: clearing a template field falls back to built-in defaults.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://burp-ai-agent.six2dez.com/user-guide/prompt-templates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
