Adding an Analysis widget
In the dashboard builder, choose Analysis from the Other menu in the toolbar’s Add: group, or from the insert menu on the canvas. The new widget is titled Analysis and opens with a prompt box holding a starter prompt, the agent picker, and Run. Edit the prompt and click Run to run the first analysis. Until the first run, the widget’s only action is Delete analysis, a red trash button that appears when you hover the widget.Use cases
- Add an executive summary at the top of a dashboard
- Surface anomalies or notable changes since the last refresh
- Explain numbers to stakeholders who want context without diving into the charts
- Write a TL;DR for periodic dashboard distributions
Writing a prompt
Write the prompt as if you were briefing an analyst — describe the audience, the angle you want, and any specific things to call out. The agent has access to the full dashboard context, so you can reference charts and controls by name.Editing and refreshing
Once an analysis has run, the widget shows a freshness leaf and a settings menu with Edit analysis and Delete analysis:- Edit analysis reopens the prompt box. Run saves the edited prompt and runs it; Cancel keeps the prompt and the analysis as they were.
- The leaf’s color shows how long ago the analysis ran, as on chart widgets, and its tooltip says when, for example Refreshed 5 minutes ago. Its popover holds Refresh, which runs the saved prompt again against the dashboard as it is now.
What re-runs an analysis
An analysis runs again only when someone clicks Refresh on the widget’s own leaf or Run in its prompt box, or on a published dashboard in live mode:- Refresh all charts on the dashboard’s freshness leaf refreshes the charts and leaves every Analysis widget as it is.
- Each live-mode refresh also re-runs every Analysis widget that has already run. The new analysis stays in that browser tab and is not published. A widget that has never run is not run by live mode.
Outdated warning
When the dashboard’s control values, SQL parameters, or charts differ from the state the analysis ran against, a warning icon appears beside the leaf; on a published dashboard, it shows with the leaf when you hover the widget. Its tooltip reads This analysis may not reflect the current filters, parameters, or charts. Refresh to update it. The analysis stays on screen; click Refresh to run it against the dashboard as it is now.Choosing the agent
By default, an Analysis widget uses the agent configured at the dashboard level. You can override the agent per widget when you need a particular agent’s tooling, model, or guardrails for a specific analysis. Use the agent picker next to the Run button. See Which agent answers.What viewers see
The widget stores a reference to the chat thread that produced its analysis. Viewers loading the published dashboard see that stored analysis without it running again. A widget with no stored analysis shows one of these instead:- With a prompt that has never run: Analysis is not run yet, with a Run button.
- With no prompt: No analysis available yet. Edit the dashboard to create one.
- With no configuration at all: No analysis available yet. Run the analysis in the dashboard editor and publish your changes.
showAiWidgets, see Feature visibility) turned off, and in PNG and PDF downloads and deliveries, the widget shows its stored analysis with no Run or Refresh, and live mode doesn’t re-run it.