Skip to main content

Agent Reports

BlazeSQL's Agent Reports feature enables blaze to monitor anything, alert you in case of significant changes, and provide a detailed report with a deep dive explaining the change.

Updated today

To stay informed by looking at dashboards you need to:

  1. Regularly look at each dashboard

  2. Mentally interpret everything and look for important changes

  3. Check whether the change can be explained by seasonality or normal variability

  4. Do a deeper analysis to understand the change, and what might have caused it

Blaze can now do all of this for you, so you can focus on real work.


Getting Started

  1. Open Agent Reports from the left sidebar.

  2. Click New report.

  3. Write a prompt describing what you'd like Blaze to monitor (e.g. "Track revenue trends").

  4. Optionally attach saved queries or dashboards to give Blaze additional context.

  5. Click Trigger test run to preview what the report will look like.

  6. Once you're happy with the output, click Activate to set up the schedule and delivery.


Writing a Prompt

The prompt is the core of your report. Describe in natural language what you want Blaze to analyze. A few tips:

  • Be specific"Analyze sign-up trends split by user segment" works better than "Tell me about sign-ups."

  • Mention what matters — If you only care about large changes, say so: "Only highlight changes greater than 5%."

Attaching Queries & Dashboards

You can attach saved queries and dashboards to your report. These give Blaze concrete data points to reference when building the report — think of them as "sources" the agent can pull from.

Click the attachment icon in the prompt composer to select from your saved queries and dashboards.


Test Runs

Before activating a report, run a test to see what Blaze will generate. Click Trigger test run in the prompt composer. The report will run immediately and you can review the output.

The detail page has two tabs:

  • Analysis — Shows the agent's step-by-step reasoning and the queries it ran, similar to a chat conversation.

  • Report — Shows the final formatted output with headlines, summaries, charts, and data tables.

You can iterate on your prompt and run as many test runs as you want before activating.


Activating a Report

When you're ready to go live, click Activate. The activation dialog lets you configure:

Name

Give your report a descriptive name (e.g. "Weekly Revenue Summary" or "Daily Churn Monitor").

Schedule

Choose how often the report runs:

Frequency

Options

Daily

Every day, or weekdays only. Requires Team Advanced or Enterprise plan.

Weekly

Pick a day of the week.

Monthly

Pick a day of the month (1–31). For shorter months, the report runs on the last day.

Set the time and timezone for when the report should run.

Significance Filter

Toggle "Only send significant updates" to have Blaze evaluate whether the report contains meaningful changes before sending. If the data hasn't changed much, the report is suppressed and no notification is sent. This is enabled by default.

You can always view suppressed reports in the app — they just won't be delivered to your inbox or channels.

Delivery Destinations

Choose where reports are delivered:

  • Email — Enter one or more email addresses (comma-separated).

  • Slack — Select Slack channels from your connected workspace. Requires a Slack integration to be set up.

  • Microsoft Teams — Select Teams channels from your connected workspace. Requires a Microsoft Teams integration to be set up.

You can use any combination of destinations.


Report Status

Each report has a status:

Status

Meaning

Draft

Not yet activated. You can edit the prompt and run tests.

Active

Running on schedule. Delivery is enabled.

Paused

Schedule is suspended. No runs will occur until resumed.

  • Pause/Resume — Toggle an active report on and off without losing your configuration.

  • Edit prompt — You can update the prompt at any time. For active reports, changes take effect on the next scheduled run.

  • Delete — Remove a report entirely.

Run Status

Each report run has its own status:

Status

Meaning

Completed

Report generated and delivered successfully.

Suppressed

Report generated but the significance filter determined no update was needed.

Failed

Something went wrong during analysis.

Delivery Failed

Report was generated but delivery to one or more destinations failed.


Viewing Reports

Report List

The main Agent Reports page shows all your reports as cards. Each card displays:

  • The report name and prompt

  • Key insights from the latest run (as bullet points)

  • When the report last ran and when it will run next

  • The current status (Draft / Active / Paused)

Report Detail

Click a report card to open the detail view. From here you can:

  • View the full report output (headlines, executive summary, charts, data tables)

  • Switch to the Analysis tab to see the agent's reasoning

  • View historical runs

  • Edit the prompt or report settings

  • Trigger a manual test run

Opening in Chat

Each report includes a link to continue the conversation in Chat. This lets you ask follow-up questions about the report's findings using the full BlazeSQL chat experience.

Did this answer your question?