# Add AI Insights

### Overview

This feature demonstrates how AI insights work, how to enable them for your visualizations, interpret the generated insights, and use them to make data-driven decisions. Learn to understand insight notifications, explore detailed analysis recommendations, and integrate AI suggestions into your dashboard storytelling. AI insights transform raw data into actionable intelligence, helping you focus on what matters most without manually analyzing every chart.

### Step 1: Add a text box to the dashboard

"**Add**" -> "**Static Widget**" -> "**Text Box**"

<figure><img src="/files/aYDcXFoLHgIfn6mBpfEG" alt=""><figcaption></figcaption></figure>

### Step 2: Tell AI which chart to look at

Click the "Star" icon on the top left of the text box to toggle into AI Insight mode. You will notice a check box appears on every chart in the dashboard. Tick the charts that you need insights from or tick "Select All Visualization" in the header.

<figure><img src="/files/kV8x2jwXcJGtxnuN213O" alt=""><figcaption></figcaption></figure>

Once you have selected, click "**Generate Insights**"

<figure><img src="/files/0gnwyF7CY7QSHijQvlaO" alt=""><figcaption></figcaption></figure>

You can give optional instructions to the AI to ask them focus on certain aspects or structure when writing the insights. For example, we ask it to write around 100 words

<figure><img src="/files/TytYlMvucz6lBjJd9P8i" alt=""><figcaption></figcaption></figure>

Done! There we go with some AI insights. Note that the dashboard will not automatically update the AI insights at the moment. Use with care!


---

# Agent Instructions: 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:

```
GET https://docs.smaq.io/documentation/features/dashboard/add-ai-insights.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.