> For the complete documentation index, see [llms.txt](https://docs.crobox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crobox.com/how-to-guides/sagent/analytics/ask-analytics.md).

# Ask Analytics

Explore filtered Sagent conversation data with plain-language questions.

Use **Ask Analytics** to query conversation data in plain language.

This tab turns a question into a chart and summary.

### How to use Ask Analytics

{% stepper %}
{% step %}

#### Open Ask Analytics

Open **Analytics** and click **Ask Analytics**.
{% endstep %}

{% step %}

#### Set filters first

Choose the **Locale** and **Date range** before asking a question. These filters define the result's scope.
{% endstep %}

{% step %}

#### Start with a suggested prompt

The interface shows example prompts you can select. They help you start quickly.
{% endstep %}

{% step %}

#### Enter an analytics request

Use the input field at the bottom of the page. Enter your request in plain language.
{% endstep %}

{% step %}

#### Review the generated answer

The result includes a written summary and a chart. Use both when interpreting the output.
{% endstep %}

{% step %}

#### Add useful results to Dashboard

Use **Add to Dashboard** to keep the chart.
{% endstep %}
{% endstepper %}

### Suggested prompts

Example prompts include:

* Average sentiment score as a line graph.
* Number of messages and unique users per day.
* Most recommended product per week.
* Most mentioned topics in a table.
* Intents per day.
* Most active day of the week.

These examples show the types of questions this tab supports.

### Generated result view

The result area includes:

* A chat-style user request.
* A written explanation of the result.
* A chart card with a title and subtitle.
* An **Add to Dashboard** button.

A result can include a line chart for average user sentiment over time.

Ask Analytics generates an interpretation from filtered conversation data. Check the filters, chart, and written summary before acting. Treat generated findings as analysis support, not final evidence.

### Reset the chat

Use **Reset Chat** to clear the current conversation. This helps when you want to start a new analysis path.


---

# 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.crobox.com/how-to-guides/sagent/analytics/ask-analytics.md?ask=<question>&goal=<endgoal>
```

`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.