# AI assistant Ask Brizz in plain language — about your own telemetry and about the product itself — and get answers with inline charts, clickable entity cards, and downloadable CSV or JSON reports. The **AI assistant** is Brizz's in-product agent. Ask it a question in plain language and it answers from your data — sessions, issues, events, users, journeys, organizations, intents, cost — or from the product docs when you ask how something works. It's the fastest way to get an answer without knowing which page to open first. ## What it is A conversational assistant that reasons over two things: - **Your own telemetry.** It can answer questions about your sessions, issues, events, users, journeys, organizations, intents, and cost — the same data the rest of the dashboard is built on. - **Brizz itself.** It can answer product and how-to questions from the documentation, so "how do I build a custom chart?" gets a real answer, not a shrug. You don't pick between the two — ask your question and the assistant works out whether it's about your data or about the product. ## What you can ask The assistant is built for the questions you'd otherwise click through several pages to answer. The suggested prompts it offers are the best guide to what it's good at. A few illustrative examples: - "Show me failed sessions." - "What are my top issues?" - "Top user intents." - "Who are my most active users?" - "How much did I spend this week?" - "How did my error rate change week over week?" - "Export the last 20 sessions as a CSV." Treat these as a starting shape, not a fixed menu — phrase your own question naturally and the assistant will map it to the data it has. When you're not sure what to ask, the in-product suggestions are the live source of truth for what it can do. ## Where to find it There are three ways in, each suited to a different moment: - **Full-page view.** A dedicated page at `/agent` — the place to go for a longer back-and-forth or when the assistant is your starting point. - **Global side panel.** A floating action button (FAB) is available across the dashboard; open it and the assistant slides in as a side panel, so you can ask a question without leaving the page you're on. - **Fix with your agent.** Launched from an issue, this opens the assistant already scoped to that issue — you skip straight to "help me understand this one" instead of describing it from scratch. ## Charts and entity cards in answers Answers aren't just text. Where it helps, the assistant renders results inline: - **Generated charts.** A question about a trend or a breakdown comes back with a chart drawn right in the conversation, so you see the shape of the answer, not just a number. - **Entity cards.** When an answer points at a specific thing — a session, an issue, a journey, an organization, or an intent — the assistant shows it as a clickable card that deep-links into the relevant page. Read the summary in chat, then click through to the full record when you want the detail. ## Downloadable reports When you want results as a file to keep or share — not just an answer in the chat — ask the assistant to create a report. It saves your query and gives you a **Download** button for a **CSV** or **JSON** file. - **Just ask for it.** "Export the last 20 sessions as a CSV," "give me a JSON report of my top intents this month" — the assistant works out the query, previews it back to you for approval, and saves it as a report. Yes, the assistant can create reports for you; you don't need to export anything by hand. - **Choose the format.** Ask for CSV or JSON, or the assistant asks you to pick before it runs the query. - **A button, not a link.** Clicking Download re-runs the saved query against your data on the spot and streams the result straight to you — there's no separate file sitting in storage and no link to copy or share. It's authenticated to your logged-in session, so it never expires; click it again any time for a fresh export. - **Come back to it later.** Your reports are saved to your account, so in a future conversation you can ask the assistant to find a report you made before, download it again, or update it with a new query. ## When it asks you to clarify If your request is ambiguous, the assistant asks a clarifying question rather than guessing. "Show me the slow ones" might prompt "slow by latency, or by number of turns?" This is by design — a quick clarification up front beats a confident answer to the wrong question. Answer it and the assistant continues with the narrower request. ## Tips for good answers - **Say the time window.** "This week," "last 30 days," "since Monday" — a bounded range gives a sharper answer than an open-ended one. - **Name the entity type when you know it.** "Top issues," "most active users," "which intents" — pointing at sessions vs. users vs. issues helps the assistant frame the query. - **Follow up in the same thread.** The assistant keeps context, so "now just the checkout service" or "break that down by model" refines the previous answer instead of starting over. - **Answer its clarifying question rather than rephrasing from scratch.** When it asks, the fastest path forward is to reply to the question it asked. - **Click through to verify.** Use the entity cards to open the underlying session or issue when the answer matters — the chat summary is a hint, the record is the truth. ## Availability The AI assistant is available to any member of the tenant. Your tenant needs the assistant enabled and a plan that includes it. **Fix with your agent** is gated separately — a tenant can have the assistant without that entry point, or the other way around. If you don't see the assistant or the Fix with your agent action, the corresponding capability isn't enabled for your tenant yet. ## See also - [Sessions](/docs/platform/sessions.md) — the session data the assistant reasons over. - [Issues](/docs/platform/issues.md) — where "Fix with your agent" starts. - [Custom charts](/docs/platform/custom-charts.md) — build persistent versions of the charts the assistant generates inline.