AddThisFeature

AI Dashboard Insights

Explain what actually changed on a dashboard, in the viewer's own filters and period.

involved AI Analysis & Search

What it adds

A short generated commentary attached to a dashboard, describing the movements that matter under the filters currently applied.

What your agent is told to do

5
  1. 1

    Compute the numbers first, in the app, using the dashboard's existing queries with the viewer's active filters. Pass the model the computed figures and let it write the wording, never the raw rows to add up itself.

  2. 2

    State the period and the comparison period explicitly in every insight. A sentence saying signups are up is meaningless without saying up against what.

  3. 3

    Filter the input to metrics the viewer is permitted to see before it reaches the model. A commentary that mentions revenue to someone whose dashboard hides revenue is a permissions leak.

  4. 4

    Show the commentary as a distinct, labelled block that is clearly generated and carries the time it was produced. Do not weave generated sentences into the dashboard's own labels where a reader cannot tell what came from a model.

  5. 5

    This feature owns the narrative paragraph for a whole dashboard. Per-metric findings with their own supporting query belong to AI Insight Cards; if that feature is present, generate the summary from its cards rather than running a second analysis pass.

Edge cases it handles

8
  • Every figure quoted must come from the app's own aggregation under the viewer's current filters. If the filters changed after the commentary was produced, mark it stale and offer a regenerate rather than showing numbers that no longer match the charts above them.
  • Each statement must name its window and its comparison, such as the last 30 days against the previous 30. Without both, a reader will assume whichever comparison flatters the number.
  • The model will reach for causes it cannot know. Constrain output to what moved and by how much, and forbid explanations of why unless the dashboard actually contains the driver as a dimension.
  • Run the permission filter on the inputs, not the outputs. Generating commentary across all metrics and then trying to strip the forbidden sentences afterwards will eventually miss one.
  • An uneventful period should produce nothing. Say that nothing material changed rather than padding the block with generic observations about steady performance.
  • Cap the tokens and the spend per generation, and cache the result against the exact filter set and period so that reloading the dashboard does not bill for a fresh run.
  • On a timeout, refusal, or truncated response, hide the block entirely and leave the dashboard fully usable. This is commentary on top of the real data, never a prerequisite for it.
  • Partial data, a metric still backfilling, or a period that has not closed must be called out, or the commentary will report a drop that is only late-arriving data.

Definition of done

9
  • Every number in the commentary matches the dashboard under the viewer's current filters.
  • Each statement names its period and comparison period.
  • Metrics the viewer cannot access are excluded before generation, not after.
  • Uneventful periods produce an explicit no-material-change result rather than filler.
  • Results are cached per filter set and marked stale when filters change.
  • A model failure hides the block and leaves the dashboard fully functional.
  • The block is visibly labelled as generated and timestamped.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.