A Summary Report emails your team a recurring digest of a Use Case: headline numbers, charts, and a link to the full report in Roboflow. The Roboflow Agent drafts the report from the fields your events already send, and you pick the schedule and the recipients.
For a one-off answer instead of a recurring report, you can ask the Agent about your events directly.
Create a Report
- Click "Vision Events" in the left sidebar, then open a Use Case.
- Open the "Reports" tab.
- Click "Create with AI".
- Under "What should the report cover?", describe the summary you want (ex: a weekly Friday morning digest of pass and fail counts by line). You can leave this blank and describe it in the chat instead.
- Click "Create Report". This opens the Agent in a new tab.
- The Agent drafts the report and shows a preview built from your real event data. Ask for changes in the chat until it looks right (ex: "add a pie chart of results by shift", "make it every other week").
- Click "Save & Schedule".
The Agent only uses fields your events actually contain, so it will not build a metric for data you never send. If it needs a field that is missing, it says so instead of guessing.
What a Report Contains
A report holds up to 8 sections. Each section is one of:
- A metric shown as a stat, bar, line, area, pie, donut, or table. Metrics can count, sum, average, or find the minimum, maximum, or number of unique values, and can group by event fields or custom metadata. A metric grouped by device shows device names from your device inventory, falling back to the raw device ID if the name is not found. Ask the Agent to name the group column (ex: head it "Line" instead of "device_id"), or to show friendly names in place of other raw group values.
- A list of recent events, up to 25 rows, with the columns you choose. Columns can show built-in event fields or any custom metadata field your events send. Ask the Agent to rename a column header, or to show friendly names in place of raw stream IDs (ex: show "lane-1" as "Lane 1"). A device column shows the device name from your device inventory, falling back to the raw device ID if the name is not found.
- A summary of Operator Feedback.
Device names are read when the report runs, so renaming a device later does not change reports already sent.
Schedule and Recipients
Open the report's menu in the Reports tab and click "Edit schedule, recipients, and lookback".
| Setting | Options |
|---|---|
| Cadence | Daily, Weekly, Every other week, or Monthly |
| Day of the Week | Used for weekly and every other week reports |
| Day of the Month | Used for monthly reports. Short months use the last day |
| Send At | The hour the email goes out |
| Timezone | The timezone used for the send time and for time buckets in charts |
| Lookback Days | How far back each run looks, from 1 to 90 days |
| Recipients | Up to 25 email addresses, all of which must belong to workspace members |
Lookback Days cannot exceed your workspace's Vision Events retention window, which is 14 days by default. See Data Retention.
Manage Reports
From the Reports tab you can:
- Rename a report by clicking its title.
- Pause a report to stop the emails, then click "Enable" to start them again.
- Pin a report, up to 5 per Use Case. A pinned report gets its own tab on the Use Case.
- Click "Edit with AI" to reopen the report in the Agent and change it in chat.
- Delete a report.
The Use Case table on the Vision Events page shows a Reports count. Clicking it opens the Reports tab. A Use Case with no reports shows "Add" instead, which opens the same tab.
Past Reports
Each scheduled run saves a report for that period. Saved reports do not change later, so you can always see the numbers exactly as they were sent.
Open a report to see its history. For any past period you can click "View" to open the full report, or "Re-notify" to email the link again.
Emails
Each run emails recipients the headline numbers and a link to the full report. If a run cannot generate the report, or the email fails to send, the report card in the Reports tab shows what went wrong.
Permissions
Two permissions control access:
- View Vision Events Reports: see reports and the reports they have generated.
- Manage Vision Events Reports: create, edit, pause, delete, and re-send reports.
Workspace owners have both by default. The Agent runs under the same permissions as your user account, so it can only save or send a report if you can.