# UI Tour

This page explains each major area of the Custom AI Agent interface.

## Top Bar

| Control              | Description                                             |
| -------------------- | ------------------------------------------------------- |
| **MCP toggle**       | Starts/stops MCP runtime.                               |
| **Passive toggle**   | Enables/disables passive scanner.                       |
| **Active toggle**    | Enables/disables active scanner.                        |
| **Backend selector** | Backend for new sessions (available only).              |
| **Status indicator** | Health state (`AI: OK`, `AI: Degraded`, `AI: Offline`). |

![Screenshot: Top bar](https://741304880-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaQ3pR328GUzNEoYZ2fgc%2Fuploads%2Fgit-blob-a09ee04b9168a4628a7fd8c653c4c9cbb6e5068f%2Ftop-bar.png?alt=media)

## Chat Panel

* Session list and per-session metadata.
* Usage stats (messages, chars, token estimates).
* Markdown-rendered streaming responses.
* Input box (`Enter` send, `Shift+Enter` newline).
* **Tools** menu for MCP-assisted prompts.
* Context preview and cancellation controls.
* Markdown export per session.

## Settings Panel

The panel is docked at the bottom of the AI Agent tab and can be resized/collapsed.

| Tab                    | Purpose                                                                |
| ---------------------- | ---------------------------------------------------------------------- |
| **AI Backend**         | Backend commands/URLs/models/auth and health testing.                  |
| **AI Passive Scanner** | Scope/rate/size controls, dedup/cache, context caps, findings.         |
| **AI Active Scanner**  | Concurrency, risk level, scan mode, queue controls, Collaborator.      |
| **MCP Server**         | Host/port/TLS/token/limits/unsafe-tool master switch.                  |
| **Burp Integration**   | Per-tool MCP toggles by category.                                      |
| **Prompt Templates**   | Built-in template editing and BountyPrompt controls.                   |
| **Privacy & Logging**  | Privacy mode, determinism, salt, audit logging, AI request logger.     |
| **AI Logger**          | Real-time AI activity log with filters, trace correlation, and export. |
| **Help**               | Quick docs and setup references.                                       |

<figure><img src="https://741304880-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaQ3pR328GUzNEoYZ2fgc%2Fuploads%2FUKbbEQ0oqbEnG4WZUn3Q%2Fimage.png?alt=media&#x26;token=8c310c9a-42da-4d3e-a4c1-e39a3a00a63a" alt="Settings panel tabs in the AI Agent UI"><figcaption></figcaption></figure>

## Privacy Indicator

Visual pill indicates active mode (`STRICT`, `BALANCED`, `OFF`) so you can confirm policy before sending prompts.

## Context Preview Dialog

Every right-click action that auto-captures context (proxy item, scanner issue, site-map node, Repeater) opens a modal before anything leaves the plugin. The modal shows the action, current privacy mode, the exact prompt, and the exact redacted JSON that will be sent. Confirm with **Send** or abort with **Cancel**. See [Context Menus → Context Preview Dialog](https://burp-ai-agent.six2dez.com/context-menus#context-preview-dialog) for details.

## Keyboard Shortcuts

* `Cmd/Ctrl + N`: new session
* `Cmd/Ctrl + W`: delete session
* `Cmd/Ctrl + L`: clear chat
* `Cmd/Ctrl + E`: export chat
* `Esc`: toggle settings panel

## Findings Panels

Scanner dialogs expose findings, severity/confidence, and queue/runtime metrics.

## Next Steps

* [Context Menus](https://burp-ai-agent.six2dez.com/user-guide/context-menus)
* [Chat & Sessions](https://burp-ai-agent.six2dez.com/user-guide/chat-sessions)
* [Burp Integration](https://burp-ai-agent.six2dez.com/user-guide/burp-integration)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://burp-ai-agent.six2dez.com/user-guide/ui-tour.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.