The Analyze tab of an agent shows how it performs: who reached each step, how much it is used, how conversations end, and every run it has made. It reads live data for the published flow.
Open it
Open Agent Builder, go to Agents, select the agent's name (or Edit flow) and then Analyze. Edit flow is only shown to people who can edit agents. The page has five tabs: Flow, Overview, Outcomes, Conversations and Runs.
Flow, Overview and Outcomes need builder.analytics:read. Without it they show Couldn't load analytics. Runs needs only builder.bots:read. Conversations is shown to people with builder.analytics:read, but it also needs builder.conversations:read to load. See Read agent conversations.
Choose a date range
The bar at the top applies to every tab except Runs. Pick Today, Last 7 days (the default), Last 30 days, Last 90 days or Custom with From and To dates. A start date after the end date is refused. Ranges are counted in UTC days, so Today is the current UTC day. The range stays in the address when you switch tabs, so you can share the link.
Flow
The published flow, drawn like the editor, with traffic on top.
- The header says how many users entered the flow.
- Each step that leads on shows the percentage of users who dropped off here.
- Each line shows the share of users who took that path. Hover a line to see the number of users.
- The legend marks Reached and Drop-off.
- With no traffic you see No traffic in this range. With no published flow you see Nothing published yet.
If the draft has changes that are not live, a note says you are looking at the published flow.
Overview
Three headline numbers, each compared with the previous period of the same length:
| Metric | Meaning |
|---|---|
| New users | People talking to the agent for the first time. |
| Active users | People who talked to it in the range. |
| Messages | Messages exchanged. |
Under them, Activity over time charts one metric at a time. Switch the metric, and group the data Daily, Weekly, Monthly or Yearly. Quiet periods count as zero. No prior data appears when there is nothing to compare.
Outcomes
- Most used flows shows the published flow, named after its start step: how many people entered it and the share who reached an end step. Select the row to jump to the Flow tab.
- Handed to a human counts handovers and gives the share of conversations.
- Conversation outcomes splits conversations into Resolved, Still open and Abandoned (still open, pending or snoozed, with no activity for 7 days).
- Satisfaction shows the score and how many responses it comes from, or No responses yet.
Conversations
A list of conversations with transcripts. See Read agent conversations.
Runs
Every flow run, newest first: webhooks, schedules, app triggers, tests and message runs. It does not use the date range.
- 1Trigger filter
- 2Status filter
Filter by trigger — All, Webhook, Schedule, App, Test or Message.
Filter by status — All, Succeeded, Failed, Skipped, Running or Pending.
Select a run to see its run id, Started and Finished times, the Payload it received and its Result.
A run shown as Step failed finished but a step reported an error, and the failing step is named. Halted means a step was set to stop the flow on failure. The status filter uses the engine's own values, so a halted run appears under Succeeded even though its badge differs; open the run to see why. Skipped means an app trigger recorded an item it did not run, and the run says why. The list refreshes while any run is pending or running.