> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights overview

**Insights** tells you how your agents perform: how conversations end, how well the agent handles them, how customers react, and what it all costs.

## How Insights works

Insights turns each conversation into metrics in four steps:

```mermaid theme={null}
%%{init: {'theme': 'base', 'themeVariables': {'background': 'transparent', 'primaryColor': '#EAF8E4', 'primaryTextColor': '#1a1a1a', 'primaryBorderColor': '#5CC83A', 'lineColor': '#5CC83A', 'secondaryColor': 'transparent', 'tertiaryColor': 'transparent', 'clusterBkg': 'transparent', 'clusterBorder': '#5CC83A', 'titleColor': '#1a1a1a', 'clusterLabelBackground': 'transparent', 'edgeLabelBackground': '#EAF8E4'}}}%%
flowchart LR
    A["Conversations happen"] --> B["Platform records them"]
    B --> C["Pipelines analyze them"]
    C --> D["Dashboards show results"]
```

1. **Conversations happen.** Every chat, API call, and phone call with your agents starts the flow.
2. **The platform records them.** It stores messages, tool calls, handoffs, errors, timings, tokens, and cost, plus any [custom tags](https://koreai.mintlify.site/agent-platform/analytics-insights/custom-tags.md) you add.
3. **Pipelines analyze them.** Built-in and custom [pipelines](https://koreai.mintlify.site/agent-platform/analytics-insights/analytics-pipelines.md) read each finished conversation and score it with an LLM.
4. **Dashboards show the results.** The prebuilt pages, custom dashboards, and Analytics Explorer read from one analytics store.

Three more sources feed Insights: your settings (costs, thresholds, and billing policy), customer surveys, and telephony call reports. To learn how each metric is calculated and how to compare numbers across pages, see [How Insights metrics work](https://koreai.mintlify.site/agent-platform/analytics-insights/how-metrics-work.md).

## Before you begin

* Enable the built-in pipelines in **Insights → Pipelines**. The quality, sentiment, and outcome metrics and the other dashboards depend on them.
* Platform counts update in real time, and LLM-scored metrics appear after the conversation ends. A dash means no data yet, not zero.

> [!WARNING]
>
> Never run the sample data generator in a project with real traffic. Its sample conversations appear in every dashboard and can't be removed there.

## Insights dashboards

In the product, the **Insights** sidebar groups the dashboards as follows:

| Document | Sidebar group and pages | When to use it |
| :- | :- | :- |
| [How Insights metrics work](https://koreai.mintlify.site/agent-platform/analytics-insights/how-metrics-work.md) | All pages | Read first. Shows where each number comes from, when it updates, and why pages can show different totals. |
| [Usage insights](https://koreai.mintlify.site/agent-platform/analytics-insights/executive-dashboard-usage.md) | **Overview**: At a Glance; **Usage**: Billing & Usage | Start here. Shows outcome, quality, sentiment, and cost for a period, and reconciles consumed usage with billed usage. |
| [Quality insights](https://koreai.mintlify.site/agent-platform/analytics-insights/performance-quality.md) | **Quality & Performance**: Quality Monitor, Agent Performance | Use when the quality figure on At a Glance changes. Shows which quality aspect and which agent caused it. |
| [Customer voice](https://koreai.mintlify.site/agent-platform/analytics-insights/customer-voice.md) | **Customer Voice**: Customer Insights, Feedback Insights | Use to see the customer's side: what they asked for, how sentiment changed, and what they said in surveys. |
| [Voice analytics](https://koreai.mintlify.site/agent-platform/analytics-insights/voice-analytics.md) | **Channels**: Voice Analytics | Use when voice conversations underperform chat. Separates agent reasoning issues from call quality, speech recognition, and latency issues. |
| [Agent transfer](https://koreai.mintlify.site/agent-platform/analytics-insights/agent-transfer.md) | Agent Transfer | Use to track escalation volume, queue performance, and human handling of transferred conversations. |
| [Analytics explorer](https://koreai.mintlify.site/agent-platform/analytics-insights/analytics-explorer.md) | **Explore & Build**: Analytics Explorer | Use when prebuilt pages don't answer your question. Shows near real-time event, model, token, and cost data, with session and trace drill-down and custom queries. |
| [Custom dashboards](https://koreai.mintlify.site/agent-platform/analytics-insights/custom-dashboards.md) | **Explore & Build**: Custom Dashboards | Use when no prebuilt page shows the metric you need. Build charts from SQL or visual queries over the project's analytics data, and share them with the project. |
| [Analytics pipelines](https://koreai.mintlify.site/agent-platform/analytics-insights/analytics-pipelines.md) | **Explore & Build**: Pipelines | Use to see which evaluations run, or to add your own LLM analysis, such as whether the customer's goal was met. See [Custom pipelines](https://koreai.mintlify.site/agent-platform/analytics-insights/analytics-pipelines.md#custom-pipelines). Fields a custom pipeline stores are available to custom dashboards. |
| [Custom tags](https://koreai.mintlify.site/agent-platform/analytics-insights/custom-tags.md) | Agents, Settings | Use to tag conversations with business data, such as payment type or customer ID, so you can chart and filter by it. |
| [Insights metrics reference](https://koreai.mintlify.site/agent-platform/analytics-insights/metrics-reference.md) | All pages | Use to look up the definition, calculation, and source of any metric. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.