AddThisFeature

Natural Language Report Builder

Describe the report you want and get a configuration you can check before it runs.

involved AI Analysis & Search

What it adds

A plain-language entry point to the app's report builder that produces a normal, editable report configuration.

What your agent is told to do

5
  1. 1

    Expose the app's defined metrics, dimensions, and grouping options to the model as an explicit vocabulary, and have it return a report configuration in the same shape the builder already saves. It must not invent a metric name or a calculation.

  2. 2

    Show the generated configuration in the builder for review and require the user to run it. Do not execute a potentially expensive aggregation on the model's first guess.

  3. 3

    Maintain a controlled glossary mapping business terms to defined metrics — what active means, what a qualified lead is, which revenue figure counts — and resolve ambiguous language through that glossary rather than letting the model decide each time.

  4. 4

    Validate the configuration against the user's data permissions before it can run, and reject combinations of dimensions that would expose restricted records through a small-group breakdown.

  5. 5

    Once generated, the report must be an ordinary saved report that runs without any model involvement. Filters on a plain list view are owned by Natural Language Filters; this feature covers metric, grouping, and date-range configuration only.

Edge cases it handles

8
  • A request for a metric the app does not define must be refused by name. Restricting the model to the declared vocabulary is what prevents a plausible-looking report built on a number nobody computes.
  • The configuration must be visible and editable before the query runs, because a misread grouping can turn a cheap report into one that scans the whole dataset.
  • Business terms mean different things in different workspaces. Route them through the glossary and show which definition was used, rather than letting the model pick a reasonable meaning silently.
  • Some dimension combinations expose individuals even when each dimension alone is permitted. Block breakdowns that fall below a minimum group size or that cross a permission boundary.
  • A saved report must reproduce identically later without calling the model again. Persist the resolved configuration, not the original sentence, or the report changes meaning between runs.
  • If the model returns a configuration that fails validation, keep the user in the builder with their request intact and explain which part could not be resolved.
  • Report runs can be slow and expensive. Estimate the cost of the generated configuration and warn before running anything unusually large.
  • When the model is unavailable, the manual report builder must remain fully functional with the natural language entry point clearly disabled.

Definition of done

9
  • Generated configurations use only metrics and dimensions the app defines.
  • The configuration is shown for review and requires an explicit run before any query executes.
  • Ambiguous business terms resolve through the glossary and the definition used is visible.
  • Combinations that would expose restricted data or fall below the minimum group size are blocked.
  • A saved report reruns identically with no further model involvement.
  • Validation failures return the user to the builder with an explanation and their request preserved.
  • The manual builder remains fully usable when the model is unavailable.
  • 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.