> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-agent.md). # Luciq Agent ### Your Luciq data, in plain English. Luciq Agent is an AI assistant built into the dashboard that works with your live Luciq data. Ask about crashes, releases, performance, bugs, or user feedback in plain English, and it does the work for you — no filter menus to click through, no exports to build, no context-switching between pages. Whether you're an engineer chasing a regression, a PM sizing up a release, or an EM pulling a weekly report, Luciq Agent gets you from question to action in seconds, with every result backed by a live query against your data. {% hint style="info" %} **In beta, enabled per account.** Luciq Agent is currently in beta and enabled on a per-account basis. Contact your Customer Success Manager or reach out to Luciq Support to enable it. {% endhint %} ### Why Luciq Agent * **One place for every product.** Crashes, APM, bug reports, hangs, surveys, and app store reviews are all just a conversation away. * **Grounded in your data.** Every response is generated from a live query against your own account — no hallucinated numbers, no stale exports. * **Multi-turn by design.** Follow up, refine, or pivot in the same thread. The agent keeps the context you've built up. * **Safe by default.** Any action that modifies your data pauses for your explicit approval before it runs. * **Zero setup.** No SDK to install, no query syntax to learn — open the panel and start typing. ### Opening Luciq Agent Once enabled, the **Luciq agent** button appears in the dashboard header, next to your avatar. Click it to open the chat panel on the right side of the screen. You can close it and reopen it at any time — your conversations stay where you left them. ### Using Luciq Agent #### 1. Ask a question Type your question into the input field and press Enter. Phrasing is flexible — Luciq Agent understands natural language and picks up the app and page you're currently viewing, so you can refer to the current release, screen, or view without spelling it out. If you're not sure where to start, Luciq Agent suggests a few example prompts you can click to try. #### 2. Watch it work Luciq Agent replies in a streaming response. As it works, it may call one or more of its Luciq tools to do the work — for example, listing crashes for a version, pulling APM metrics for a screen, or updating a bug's status. You can expand the **Ran tools** section under any reply to see which tools were called and what inputs were used. #### 3. Follow up Every conversation is multi-turn. Ask follow-up questions, refine what you want, or pivot to a related topic in the same thread — the agent keeps the full context of the conversation. ### What Luciq Agent covers Luciq Agent covers a broad range of product surfaces, including: | Area | Ask about | | ------------------------- | -------------------------------------------------------------------------------------- | | **Crashes & Occurrences** | Top issues, new regressions, specific stack traces, distribution by version and device | | **App Hangs** | UI freezes, force restarts, and their impact on users | | **Performance (APM)** | Slow screens, network calls, app launches, dropped frames, and user flows | | **Bug Reports** | Reports by tag, status, priority, reporter, or release | | **App Store Reviews** | Ratings, review content, and what's changing across releases | | **In-app Surveys** | NPS results, survey responses, and how a survey is performing | | **Issues** | Prioritized issues across crashes, APM, and bugs | | **Opportunities** | AI-synthesized product improvement themes from bug reports and app store reviews | | **Alerts & Rules** | Alert rules, triggered incidents, and how alerting is configured | | **App Health** | A cross-product health snapshot for any app version | ### What you can ask A few things you might ask: **Summarize what's happening** * *"What are the top crashes affecting users this week?"* * *"What are users saying in recent app reviews?"* * *"Summarize app health for the current release."* **Investigate an issue** * *"Why is the checkout screen slow on Android 14?"* * *"Show me the crashes introduced in version 3.2."* * *"Give me the full diagnostic for crash 4521."* **Connect the dots** * *"Which crashes are showing up in our 1-star reviews?"* * *"Compare crash-free rate across versions 3.2, 3.3, and 3.4."* * *"Which user flows are generating the most bug reports?"* **Report and act** * *"Write a weekly health update for stakeholders."* * *"What are our biggest product opportunities right now?"* * *"Triage bug 4521 — set it to major and add a login tag."* ### Conversation history Luciq Agent keeps a history of every conversation you've started, grouped by day. Click the history icon in the panel header to see past chats, jump back into one to continue, or delete a conversation you no longer need. Starting a **New chat** opens a fresh thread without affecting your history. ### Actions requiring your approval Luciq Agent can act on your data as well as answer questions about it — for example, updating a bug's status, priority, or tags, or creating and editing funnels. Before running any action that modifies your data, Luciq Agent pauses and asks for your permission in-chat, showing you the tool it's about to call and the values it plans to use. Click **Allow** to run it once, or **Deny** to skip. Nothing is written to your dashboard without your explicit approval. ### Data access and privacy Luciq Agent runs against your own Luciq account and only sees the data you have access to. It uses the same permissions as your dashboard user — if you can't see a certain application or record, the agent can't either. To learn more about how Luciq handles AI feature data, see [AI Privacy & Data Retention](/organization-settings/ai-privacy-and-data-retention.md). --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.