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

# Analytics Chat

> Ask questions about your data in plain English

Analytics Chat is AstroBee's natural language interface for querying your data. Ask questions in plain English and get answers with full transparency into the SQL and logic used.

<Frame caption="Chat interface with question and response">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/31-chat-response.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=9e09073ceef00c4da3b5e3b9b0bd113e" alt="Analytics chat" width="2850" height="1608" data-path="screenshots/31-chat-response.png" />
</Frame>

## Starting a Chat

Click **New Chat** in the sidebar to start a conversation. Each chat is saved and accessible from the sidebar.

## Asking Questions

Type your question in plain English:

```
How many customers do we have?
```

```
What are the top 5 products by revenue?
```

```
Show me customers who placed more than 2 orders last month
```

AstroBee interprets your question, generates SQL against your data layer, executes it, and returns the answer.

## Understanding Responses

Each response includes multiple views:

### Answer

The direct answer to your question in natural language:

> You have 20 customers in your database.

### SQL View

Click **SQL** to see the exact query AstroBee generated:

<Frame caption="Generated SQL query">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/32-chat-sql-view.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=1daf0053af85f4f9c22c1612fbc63ca4" alt="SQL view" width="2850" height="1608" data-path="screenshots/32-chat-sql-view.png" />
</Frame>

The SQL shows:

* Which tables and entities were queried
* Join conditions used
* Aggregations and filters applied

<Tip>
  You can copy the SQL and run it directly in your warehouse for verification or further analysis.
</Tip>

### Logic View

Click **Logic** to understand AstroBee's reasoning:

<Frame caption="Explanation of how the answer was derived">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/33-chat-logic-view.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=10ab45f02f6c6ad5793a9ea84d151d4c" alt="Logic view" width="2850" height="1608" data-path="screenshots/33-chat-logic-view.png" />
</Frame>

The Logic view explains:

* How AstroBee interpreted your question
* Which entities and relationships it used
* Why it chose that particular approach

### Full Report

Click **Full Report** for a complete breakdown:

<Frame caption="Complete answer report">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/34-chat-full-report.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=5363b7f3808cc9ca1c78f6e023ced285" alt="Full report" width="2850" height="1608" data-path="screenshots/34-chat-full-report.png" />
</Frame>

The report includes:

* Original question
* Answer
* SQL query
* Full logic explanation
* Timestamp

## Browsing the Data Layer

While chatting, click **Data Layer** to browse available entities:

<Frame caption="Data layer browser in chat">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/30-browse-data-layer.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=27f8c98dc0e85751375b471f00f36879" alt="Browse data layer" width="2850" height="1608" data-path="screenshots/30-browse-data-layer.png" />
</Frame>

The browser shows:

* All entities in your data layer
* Entity descriptions
* Option to preview data or show fields

This helps you understand what data is available when forming questions.

## Chat History

### Saved Conversations

All chats are automatically saved and appear in the sidebar under **CHATS**. Click any chat to continue the conversation.

### Renaming Chats

Click the chat title to rename it. Descriptive names help you find conversations later.

### Deleting Chats

Click the delete button next to a chat title to remove it.

## Question Tips

<AccordionGroup>
  <Accordion title="Be specific">
    "Show revenue by product category" is better than "Show me revenue"
  </Accordion>

  <Accordion title="Use time ranges">
    "Orders from last month" or "Customers who signed up in 2024"
  </Accordion>

  <Accordion title="Ask for comparisons">
    "Compare revenue between Q1 and Q2" or "Top 10 vs bottom 10 customers"
  </Accordion>

  <Accordion title="Request visualizations">
    "Show a bar chart of..." or "Visualize..." (coming soon)
  </Accordion>

  <Accordion title="Follow up">
    Build on previous answers: "Now break that down by region"
  </Accordion>
</AccordionGroup>

## Reporting Issues

If an answer seems incorrect, click **Report Issue** to flag it for review. Include details about:

* What you expected
* What was returned
* Why you think it's wrong

Your feedback helps improve AstroBee's accuracy.

## Limitations

* Questions must relate to data in your connected data layer
* Complex multi-step calculations may require refining your data layer
* Very large result sets are automatically limited

## Next Steps

<CardGroup cols={2}>
  <Card title="Build Your Data Layer" icon="sitemap" href="/features/data-layer">
    Define entities and relationships for better answers
  </Card>

  <Card title="MCP Integration" icon="terminal" href="/features/mcp">
    Query from Claude Desktop or VS Code
  </Card>
</CardGroup>