Build product analytics for AI applications using natural language
Metrics let you track patterns in conversations that would be impossible to capture with traditional event-based analytics. Define what you want to measure using plain text — just like policies — and White Circle handles the rest.
Example Use Cases
Customer Support Bot
- Was the user’s issue resolved?
- How often do users express frustration?
- How often do users ask for help?
AI Code Assistant
- How often do users ask for bug fixes vs. new features vs. documentation?
- Are users asking follow-up questions after code generation?
- What programming languages are most requested?
Educational Tutor
- Did the student understand the explanation?
- How often do users ask for simpler explanations?
- What topics generate the most questions?
Sales Assistant
- Did the conversation lead to purchase intent?
- What objections come up most frequently?
- How often do users ask about pricing?
How Metrics Work
Metrics let you define what you want to measure using plain text — just like policies.
Each metric has two components:
Included Content
Describe what should count toward this metric.
Excluded Content
Describe what should be excluded, even if it seems similar.
Example: Feature Request Detection
To track how often users request new features:
- Included: “User asks for a new capability, requests functionality that doesn’t exist, suggests improvements or additions”
- Excluded: “Bug reports, questions about existing features, general feedback without specific feature requests”
Metrics vs. Policies
While metrics and policies use the same definition approach, they serve different purposes:
Getting Started
Creating a metric follows the same workflow as policies:
Open the Metrics Page
Navigate to the Metrics page in your White Circle dashboard.
Create a New Metric
Click Add Metric and give it a descriptive name like “Feature Requests” or “User Satisfaction”.
Define Your Metric
Write what should be included and excluded using plain language.
Save and Start Tracking
Once saved, metrics are automatically computed for all requests sent to the
/api/sessionendpoint.
Viewing Analytics
On the platform, you can view analytics for each metric individually. This includes trends over time and breakdowns of matched content.
Next Steps
Open the platform and define your first metric
Learn how to attach user information for richer analytics