> ## Documentation Index > Fetch the complete documentation index at: https://learn.kubit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Lumos > Reference for Lumos, Kubit's chat interface: ask questions in plain language, get reports and cohorts back, find reports, and detect and explain anomalies. This page covers Lumos, the chat interface in Kubit. You ask a question in plain language, and Lumos builds the report or cohort, finds existing reports, or flags and explains anomalies. It reads your model's metadata to map your words to events, fields and filters. Lumos was called Ask Kubit in earlier versions. Your data is never used to train models. ![Lumos home page](https://mintcdn.com/kubit/9i8QHxqek50tMBGy/images/lumos/lumos-home.png?fit=max\&auto=format\&n=9i8QHxqek50tMBGy\&q=85\&s=19ff9d2490f1f1fa2b145e5ef517333b) ## When to use | Use case | Example | | - | - | | You don't know which report fits | "Where do new users drop off during onboarding?" | | Exploring step by step | Ask for a chart, then "break that down by plan", then "only users from paid campaigns" | | Finding existing work | "Find reports about trial conversion" | | Checking a spike or drop | "Is there anything unusual in this report?" | | Explaining a change | "Why did activation drop last week?" | ## Open Lumos Open Lumos from the chat box on the home screen, or from the left navigation. Type in the box at the bottom of the chat. Select the schema Lumos should use if your workspace has more than one. In the app on Nov 5, 2026, the chat opens from **Ask** in the left nav. **New Chat** in the top right starts a new chat. ## Ask for reports and cohorts Lumos builds a report or cohort from a question and shows the result in the chat. Follow-up prompts change the last result, such as adding a group-by or a filter. The answer opens with a summary of the numbers, then **Suggested next steps**, then the report itself. ![Lumos answer to Checkouts by SKU category over the last week: a summary of 1,684 checkout events by category, three suggested next steps, and a bar chart report titled Checkout events by SKU category.](https://mintcdn.com/kubit/9i8QHxqek50tMBGy/images/lumos/answer-with-report.png?fit=max\&auto=format\&n=9i8QHxqek50tMBGy\&q=85\&s=48114390a53d3fa7e54c35b1441013ad) A report or cohort from Lumos is the same as one built by hand: | Action | How | | - | - | | Edit it in the builder | Click the report title | | Add it to a dashboard | **Add to Dashboard** | | Favorite it | The star icon | A good prompt names what to measure, the events, the date range and any group-by or filter. Lumos fills in the rest. ### MCP prompt examples > "Show me daily active users by platform for the past 2 weeks" > "How many users abandoned onboarding after talking to the agent last week, compared to the week before? Break that down by primary intent." ## Agents Lumos routes each question to an agent based on what you ask: | Agent | Does | Triggered by phrases like | | - | - | - | | **Report** | Builds and analyzes a report, and points out what stands out | "Show me…", "What does… look like", "Compare…" | | **Historian** | Finds the 5 most relevant existing reports, with a short summary of each | "Find reports about…", "Find similar reports" | | **Detect** | Looks for anomalies in a time series. A light check runs after every report. | "Are there anomalies?", "Is there an issue?" | | **Diagnose** | Drills into dimensions to find why a metric moved | "Why is…", "What's causing…", "Investigate…" | | **Narrative** | Summarizes everything found in the chat | "Summarize my findings" | ### Anomalies Kubit marks anomalies on time series charts in Query reports and in Funnel reports in Conversion mode, with or without a group-by. There are three kinds: | Kind | Means | | - | - | | **Volume** | Record counts outside the normal range | | **Distribution** | Values that don't match historical patterns | | **Freshness** | Data that's missing or late | Click an anomaly marker and choose **View Anomaly** to see its confidence, triggers and Z-score or MAD score. For daily reports, Kubit compares each point with 7, 14 and 30 day means and the same weekday's mean. ### MCP prompt examples > "Are there any anomalies in my daily active users report?" > "Why did project\_created drop on Tuesday?" ## Explain with AI **Explain with AI** summarizes a result. By default the summary has four parts, shown here with their labels in the app. You can turn each off before it runs: | Part | Holds | | - | - | | `Executive summary` | The result in a few sentences | | `Key insights` | The changes and segments that stand out | | `Summary statistics` | Totals, averages and ranges | | `Recommendations` | What to look at next | Your choice carries over to later questions in the same chat. A new chat resets it to all four parts. ## Chat history and timeline Kubit saves each chat in the left panel. Open its menu (three-dot icon) to rename or delete it. Click the arrow at the top left of the chat to show or hide **Chat History**. Kubit names each chat from its first question. ![Ask page with the Chat History panel open on the left, listing one chat named Weekly Checkouts by SKU Category, next to the chat's question and answer.](https://mintcdn.com/kubit/9i8QHxqek50tMBGy/images/lumos/chat-history.png?fit=max\&auto=format\&n=9i8QHxqek50tMBGy\&q=85\&s=ebceaeee5481f0267a8d0da3e78fc9ad) The right-hand panel has two views of the current chat: | View | Shows | | - | - | | **Timeline** | Each question, the agents that ran and what they found, with timestamps | | **Decision Tree** | The branches of an investigation and which agent ran at each one | Click any point in either view to jump to that part of the chat. ## Pre-built prompts A new chat offers 3 pre-built prompts. Admins can edit them for everyone: click the pencil icon on a prompt, change the text, then click the check mark to save. ## Related * [Reports overview](https://learn.kubit.ai/product-analytics/reports/overview.md): the report types Lumos builds. * [Dashboards](https://learn.kubit.ai/product-analytics/dashboards.md): save what you find. * [Set up Kubit with your coding agent](https://learn.kubit.ai/agent-observability/get-started/coding-agent.md): ask the same questions from Claude Code or Cursor through the Kubit MCP server. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.