What it does
BigQuery Metric Narrator reads a read-only (SELECT-only) metric query result from BigQuery or a warehouse — or accepts a provided query-result export — and turns it into a deterministic analysis: period-over-period change percentage, trend, severity, breakdown share, outlier detection, and a confidence score. An LLM then writes a grounded narrative and decision-support recommendations; every number is code-derived and the LLM never invents or alters figures. Gated: ships with mock fixtures and a provided-export path so it works with no live network; live BigQuery verification is pending a sandbox key. Guardrails: read-only (DML/DDL rejected), credential masking, prompt-injection defang, query row/byte/timeout limits, never a production dataset. Built for SaaS analytics and data teams who want automated warehouse metric narration instead of manually eyeballing dashboards.
Example prompts
- Analyze this month's active users and MRR from our BigQuery export
- What changed period-over-period in these metrics and why?
- Validate that this SQL query is read-only before running it
Before you connect
The credentials this agent will ask you for — the full setup is on the Setup tab.
Needs 3 optional credentials to connect. See setup
