> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samplevault.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Assistant

> Chat-based sample discovery and music production help

## Overview

The AI Assistant is a chat panel that searches your sample library, suggests samples by description, and answers production questions. It can draw on every sample in your processed library, on the manuals for major DAWs and plugins, and on Sample Vault's own documentation — so "how do I sidechain this?" and "how does indexing work?" are both fair game. Answers pulled from documentation link back to the page they came from.

## Modes

The dropdown next to the chat input switches between three response modes:

* **Creative** (default) — more expressive, exploratory responses. Best when you want variation, fresh ideas, or arrangement and composition suggestions. Unlimited on paid plans, subject to fair-use.
* **Fast** — quick, lighter responses for simple requests, documentation questions, and general chat. Unlimited on paid plans, subject to fair-use.
* **Smart** (Home Studio, Professional Suite) — deeper reasoning for complex tasks like detailed sample analysis or multi-step arrangement help. Each message draws one **Premium request** from your monthly pool.

<Note>
  On **Demo Room** — and a Lifetime license without a subscription — Creative and Fast draw from the one-time starter **AI actions** grant shared across the assistant's AI features. Smart Mode requires Home Studio or Professional Suite. See [Plans & Usage](/reference/plans-usage#starter-pools).
</Note>

## Chat input

The chat input supports multi-line text and submits on Enter. The button at the far left of the input opens your chat history. The lightbulb button to the right offers categorized prompt suggestions you can insert and edit before sending.

## Sample results

When the AI finds samples, they appear inline as collapsible playable cards. Each card includes:

* Play/pause and waveform
* **Copy** to clipboard
* **Drag handle** — drag straight into your DAW
* **Info** for full metadata
* **Right-click menu** — find similar, get creative suggestions, analyze, add to favorites or collections, show other samples in the same directory

The AI returns one sample per directory by default to keep results varied. Use **Show other samples in directory** from the right-click menu to see the rest of a folder.

When a reply includes  more than one sample, an actions row beneath it works on the whole set at once: copy them all to your clipboard (applying your playback cleanup the same way copying or dragging a single sample does), add them all to a collection, send them to the [Sequencer](/core-features/sequencer) as a kit, or select them all to drag as a batch or bulk-edit.

### Selecting chips across the chat

`Cmd/Ctrl + click` a sample chip in any message to add it to the selection. `Shift + click` ranges within a single message. With a chip focused (or an existing selection active), `Cmd/Ctrl + A` selects every chip across the whole chat — when nothing is focused, it falls through to text selection as you'd expect. Selected chips feed the same selection bar used everywhere else, so you can drag the whole batch into your DAW or bulk-edit through the **More** menu. See [Multi-select & batch actions](/core-features/sample-browser#multi-select-batch-actions).

## Building a kit

Ask the assistant for a kit or a starting beat and it assembles one from your own library — choosing sounds that fit the vibe you describe and saving them as a named kit you can reopen later. The reply includes a link that opens the kit in the [Sequencer](/core-features/sequencer); when the Sequencer is already open with unsaved changes, it confirms before replacing them. Nothing is synthesised — every pad is a file you already own.

## Workspaces

Workspaces carry context — BPM, key, genre, mood, notes, todos — that the AI reads on every message. Switch between workspaces from the title bar [Workspace Selector](/reference/ui-reference#title-bar-controls). Project notes live in the [Note Editor](/core-features/note-editor); recent activity feeds the AI through [Recall](/core-features/recall).

## Tool calls

When the AI searches or fetches data, you'll see a status indicator: a spinner while running, a checkmark when complete. Common actions: "Searching for samples...", "Finding similar samples...", "Browsing local files...", "Fetching sample details...".

## Troubleshooting

### The AI gives generic responses instead of understanding my style

Add more detail to your **AI Assistant Instructions** in [Settings](/reference/settings#ai-assistant-instructions). Replace "I make electronic music" with something like: "I produce melodic techno at 120–125 BPM. I prefer organic percussion over synthetic drums and synth patches with movement and modulation."
