Analytics
Analytics is the Usage tab of the canvas. The canvas shows what is attached to this agent. The Usage tab adds how many requests came in through each path and what they cost.
When to use it
Section titled “When to use it”- After you turn on Live, to see how many credits visitor chats use.
- To find which API key your integrations call the most.
- To find the day channel or routine usage went up.
To compare every agent at once, use the usage dashboard. Analytics looks at one agent.
Getting there
Section titled “Getting there”-
Open the agent’s Studio.
-
Select the Usage tab at the top of the canvas. The Analytics cell under the agent card takes you to the same view.
-
Pick a period at the top right: 7, 30 or 90 days. The period only exists on the Usage tab.
Figures on the canvas
Section titled “Figures on the canvas”On the Usage tab, the nodes in the left column (Requests come in) show figures.
| Node | What it shows |
|---|---|
| Channel, Live, API header rows | Chats and credits for that source |
| Channel connection, API key, Live address | Chats, replies and credits for that one path |
| Other requests | Usage with no path to configure, such as app chats, routines and spaces |
The line into the agent gets thicker with usage. Paths with no usage in the period are drawn as faint dashed lines.
The API header total includes calls made with account-wide keys. The canvas only draws keys dedicated to this agent, so the key nodes can add up to less than the header row.
The chart below
Section titled “The chart below”A daily bar chart sits under the canvas. Bars stack by source, and every day in the period gets a slot. Days with no usage are empty.
- The chart header shows the period totals: chats, replies, tokens and credits.
- Choose Tokens, Credits or Replies for the bars.
- Select a source chip below the chart to hide or show that source.
- If you collapse the chart, it stays collapsed next time.
Chats are not drawn as bars. Adding daily chat counts would count a chat that spans several days more than once. Read the period’s chat count in the chart header.
Focusing on a path
Section titled “Focusing on a path”Select a node on the Usage tab to open the Analytics panel on the right. The chart then shows only that path.
- A source (the Channel, Live or API header row, or Other requests) keeps only that source’s bars in full color.
- An API key or channel connection shows that path’s daily values against the day’s total.
The Analytics panel has two tables.
- Sources: chats, replies, tokens, credits and share for all six sources. Sources with no usage stay as rows so you can compare.
- Paths: calls, tokens and credits by API key and by channel connection. Keys only show their prefix. Select › at the end of a row to open that key’s or channel’s settings.
The focused path shows as a chip in the chart header and the panel header. Select × on the chip to go back to everything.
Reading the numbers
Section titled “Reading the numbers”- Chats are conversations this agent answered at least once in the period. Conversations it never answered are not counted.
- Replies are the number of times the agent answered.
- Credits are the settled cost. One credit is US$1.
- For the same period, the token total matches the Agents tab of the usage dashboard.
Who can see it
Section titled “Who can see it”Only the agent’s owner. Other people don’t see the Usage tab or the Analytics cell. When someone else uses this agent, that usage is counted on their account and does not appear here.
Limits
Section titled “Limits”- Tool calls (connectors and skills) are not counted yet. That is why the right column of the canvas has no figures.
- Device costs (computer and browser) are not included.
- Usage is recorded when a run finishes. A run in progress shows up after it ends.