> For the complete documentation index, see [llms.txt](https://docs.fullsession.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullsession.io/daleel.md).

# 24. Daleel

Ask Daleel, FullSession's in-app AI assistant, questions about your site in plain language and get answers, charts, and sessions.

**Daleel** is FullSession's built-in AI assistant. You ask a question about your site in plain language, like *"where do shoppers leave the checkout?"* or *"which pages have the most rage clicks in the last 30 days?"*, and Daleel looks up the answer in your FullSession data. It shows the numbers in chat, adds charts to a side **canvas**, and links to the sessions behind them. If your role allows it, Daleel can also build things for you, such as a funnel, a segment or a dashboard card, after you approve each change.

Daleel uses the same tools as the [FullSession MCP Server](https://docs.fullsession.io/mcp-server.md), but runs inside the app. You don't need an external AI client or a connection step.

> Daleel is in **beta**. It's a plan feature: on a plan that doesn't include it, the **Daleel** button in the header shows a lock and opens the upgrade dialog instead of the chat ([Chapter 17](https://docs.fullsession.io/billing-subscriptions.md)).

***

### 24.1 Opening Daleel

The **Daleel** button sits in the top header, next to Alerts, with a **BETA** badge. Clicking it opens Daleel over the page you're on, so you can ask a question without losing your place. Click it again or use **Close** to go back.

The button is:

* **Hidden** if your role doesn't include the **Use Daleel** permission (section 24.7)
* **Locked** (with a lock icon) if your plan doesn't include Daleel. Clicking it opens the upgrade dialog
* **Disabled** until the tracker setup for the site is complete, when no site is selected, or after a trial has ended

Daleel always works on the **site currently selected** in the app. Switching sites switches Daleel's data and its conversation history with it.

***

### 24.2 First-Run Setup

The first time you open Daleel on a site, a short **Set up Daleel** dialog appears before the chat.

#### Step 1: What best describes your work?

Pick every role that fits from the cards:

| Role                    | Focus                              |
| ----------------------- | ---------------------------------- |
| **Marketing or growth** | Campaigns, acquisition, conversion |
| **Ecommerce**           | Shoppers, checkout, revenue        |
| **UX or design**        | Usability, journeys, friction      |
| **Product**             | Features, adoption, retention      |
| **Analytics**           | Metrics, funnels, reporting        |
| **Engineering**         | Errors, performance, bugs          |

If none of them fits, type your own role in **Something else? Type your role** and click **Add**. You can hold up to **10 roles**, each up to 100 characters. Daleel receives your roles as context with every question, so its answers focus on what matters to you. Roles are saved per person and per site.

#### Step 2: Where would you like to start?

Daleel suggests **three starter questions** based on the roles you picked, one from each role when you pick several. Click a question to open the chat with it already asked, or click **Open Daleel** to ask your own. **Change** (or **Back**) returns to the role picker.

If you'd rather not answer, **Skip onboarding** goes straight to the chat. Either way, the dialog doesn't come back once you've finished or skipped it.

> If you were already using Daleel before this setup existed, it won't interrupt you. You'll get a small invitation to set your roles instead.

***

### 24.3 Asking Questions

Type into **Ask Daleel…** and press Enter. The answer streams in as Daleel works. Use **Stop responding** to cut it short.

Daleel can answer anything the MCP tool set ([section 21.3](https://docs.fullsession.io/mcp-server.md)) covers on the current site, for example:

* **Sessions:** find sessions with rage clicks, errors or abandoned forms, and summarize what a visitor did
* **Heatmaps and frustration:** rank pages by rage, dead or error clicks, and look at the elements behind them. Rage-click figures match the **Rage** tile on the page's heatmap for the same period
* **Funnels and conversion:** find the biggest drop-off, compare periods, help choose a conversion goal
* **Trends and breakdowns:** sessions by device, country, browser or landing page, compared with the previous period
* **Feedback, Lift AI and dashboards:** read survey responses, Lift AI recommendations and existing dashboard cards

The same limits as the MCP server apply: a maximum window of **90 days**, and paged results rather than full dumps. Name the period you mean (*"in October"*, *"the last 30 days"*) for the most precise answer.

#### Attaching files

Alongside a typed message you can attach files for Daleel to read. Supported types:

| Category  | Formats                                 |
| --------- | --------------------------------------- |
| Images    | PNG, JPG, WEBP, GIF (still images only) |
| Documents | .docx, .txt, .csv                       |
| PDFs      | Up to 100 pages                         |

* Up to **5 files** per message, **10 MB** per file.
* Attach from the **paperclip button** in the message input, by dragging files onto the panel, or by pasting an image from the clipboard.
* Each attached file shows as a chip or thumbnail before you send, with a remove button. You can send files with or without text.

**What Daleel receives.** Images and PDFs are passed to the model in full. Text files (.docx, .txt, .csv) have their content extracted and included with your message. In a long conversation, older attachments are referenced by name rather than re-sent in full.

**Files are private to you.** Only you can read or delete your uploads, and another user's file always returns a not-found response. Attachments stay visible when you reopen a past conversation from history. Files that are uploaded but never sent are automatically removed after 24 hours.

#### The canvas

When the shape of the data matters, Daleel adds a chart to the **Canvas**, a panel beside the chat. It can show metrics, time series, breakdowns, page rankings, session lists, feedback, journeys and funnels. The **Canvas** button shows how many items it holds, and you can change a chart's type from the canvas. Hovering a message highlights the charts it produced.

#### Context usage

A **Context** indicator shows how much of the conversation Daleel can still hold. In very long conversations, older messages are summarized automatically to make room, and the chat marks the point with *Older messages summarized to save context*. Start a **New session** for an unrelated question.

***

### 24.4 Letting Daleel Make Changes

Daleel can also **create and edit** things in your account: segments, funnels, saved heatmaps, dashboards and chart cards. It never does this silently. Before any change, it shows an approval card with the tool it wants to run and the exact values it will send:

| Button                           | Effect                                                                       |
| -------------------------------- | ---------------------------------------------------------------------------- |
| **Allow once**                   | Run this one change                                                          |
| **Allow \<action> this session** | Run it, and don't ask again for the same kind of change in this conversation |
| **Deny**                         | Don't run it. Daleel is told you declined                                    |

Changes that delete something or **fully replace** a segment or funnel are marked **Destructive**. The approval card stays in the conversation afterwards as a record of what you decided (**Allowed**, **Allowed for this session** or **Denied**).

To make any change, your role needs the **Let Daleel make changes** permission, in addition to the normal permission for that action (for example, **create funnels**). Without it, Daleel is read-only for you: it can still analyse your data and draft a definition, but it won't offer to save it.

> **Note:** when a file is attached to the conversation, write tools always ask for approval regardless of your approval mode setting. This is a safety measure because file content is user-supplied.

***

### 24.5 Conversations

Daleel keeps your conversations so you can return to them. They are **private to you** and kept **per site**.

* **New chat** (the **+** button) starts a fresh conversation
* **History** lists recent conversations, with a search box (**Search conversations**)
* **Pin** keeps a conversation at the top of the list
* **Delete** removes a conversation after you confirm

On the full-page view, the same actions sit in a sidebar with **Pinned** and **Recent** sections and a **Search work…** box.

***

### 24.6 What Daleel Can See

Daleel sees the same data you see in the app, and nothing more:

* It only reads the **site you have selected**, and only the sites your account can access
* Every tool checks **your role's permissions**, per site. If your role can't view funnels, Daleel can't read them either, and Daleel won't offer tools your role can't use. If it does hit a limit, it tells you which permission an admin would need to grant
* **Masking and exclusion rules still apply** ([Chapter 22](https://docs.fullsession.io/privacy-security-compliance.md)). Data that was never recorded can't be surfaced

***

### 24.7 Permissions

| Permission                                     | Grants                                                                                 |
| ---------------------------------------------- | -------------------------------------------------------------------------------------- |
| `daleel:use` — Use Daleel                      | See the Daleel button, chat with Daleel, keep conversations, and attach files          |
| `daleel:actions:use` — Let Daleel make changes | Let Daleel create, edit or delete things on your behalf, after approval (section 24.4) |
| `daleel:knowledge:view`                        | View the knowledge sources Daleel uses for the site                                    |
| `daleel:knowledge:create`                      | Add knowledge sources                                                                  |
| `daleel:knowledge:delete`                      | Remove knowledge sources                                                               |

Built-in roles get them as follows:

| Role      | Use Daleel | Make changes | Knowledge: view | Knowledge: add / remove |
| --------- | ---------- | ------------ | --------------- | ----------------------- |
| **Owner** | ✓          | ✓            | ✓               | ✓                       |
| **Admin** | ✓          | ✓            | ✓               | ✓                       |
| **User**  | ✓          | —            | ✓               | —                       |

So by default a basic **User** can ask Daleel anything their role can see, but can't have it change anything. Grant **Let Daleel make changes** through a custom role ([Chapter 16](https://docs.fullsession.io/team-account-management.md)) to change that. Like all FullSession permissions, these are enforced **per site**.

***

### 24.8 Limits

* **Beta.** Answers are generated by an AI model and can be wrong. Check important numbers in the feature itself before you act on them.
* **One site at a time.** Daleel answers for the selected site. Switch sites in the app to ask about another one.
* **90-day window** and **paged results**, the same as the MCP server ([section 21.5](https://docs.fullsession.io/mcp-server.md)).
* **No scheduled or background work.** Daleel answers when you ask; it doesn't monitor your site or send reports. Use [Alerts](https://docs.fullsession.io/alerts-notifications.md) and [Lift AI](https://docs.fullsession.io/lift-ai.md) for that.
* **File attachments:** up to 5 files per message, 10 MB per file, PDFs up to 100 pages, and at most 50 unsent files waiting in your queue at once.

***

### 24.9 Related

* [FullSession MCP Server](https://docs.fullsession.io/mcp-server.md): the same tools, from an external AI client such as Claude Desktop or Cursor
* [Lift AI](https://docs.fullsession.io/lift-ai.md): automated, ongoing conversion analysis for a funnel
* [Team & Account Management](https://docs.fullsession.io/team-account-management.md): roles and custom permissions

> **The big picture:** Daleel is an AI assistant inside FullSession. A short first-run setup records your role, and from then on you ask questions in plain language and get answers, charts on a canvas, and links into sessions, all for the selected site. You can also attach images, PDFs, and documents to any message, and Daleel reads them as part of the conversation. With the **Let Daleel make changes** permission it can also build segments, funnels, heatmaps and dashboard cards, asking for your approval each time. It sees only what your role can see.
