# 语音指标

Bird 仪表板中的 **指标** 页面汇总了工作区发起和接收的通话分段：有多少接通、持续多久、如何结束以及去往何处。可用于一段时间内的通话报告。要跟踪某一通具体的通话，请打开[通话日志](/docs/guides/voice/call-log)。

一通电话可以包含多个通话分段，例如转接或拨打另一方时建立的连接。这些指标会分别统计每个分段。

每个分段按其开始时间计入，并在结束后被汇总，因此只要仍有通话进行中，最近的时间桶就会持续填充。该页面需要工作区角色同时具备语音和分析的读取权限。

## 查看指标

打开 **Voice** > [**指标**](https://bird.com/dashboard/w/voice/metrics)。四个选项卡共用一个时间范围选择器和一行筛选条件：**概览**、**通话质量**、**号码与路由** 和 **流量模式**。切换选项卡时，范围和筛选条件保持不变。

时间范围选择器提供最近 24 小时或 7、30、90 天，默认为 7 天。按天的范围以本地日历日为分桶单位；24 小时范围是 24 个小时桶的滚动窗口。在时间图表上拖选可将页面上所有卡片缩小到该时段。

四个筛选条件可以组合使用：**您的号码**（通话分段中您所在的一端）、**目的地**（分段的目的地国家/地区）、**SIP 中继**和**结果**。每个已应用的筛选条件都有可单独移除的标签，大多数卡片也提供控件，可按您正在查看的行应用筛选。

### 接通率与通话时长

**概览** 选项卡以五个指标卡片开头。前四个显示与上一个等长时间窗口的变化：

- **接通率**：已接听分段数除以范围内的尝试总数。未接听的尝试仍计入分母，因此路由无法接通或所拨号码无人接听时，ASR 都会下降。其变化以百分点差值表示。
- **平均通话时长**：已接听分段的平均计费时长。不计入未接听分段，因此 ACD 不能说明接通的频率。少数持续很久的分段会使平均值高于中位数；**通话质量**选项卡的时长分布会显示这种差异。
- **分段总数**和**已接听分段**：计算 ASR 所用的两个计数。
- **不同号码数**：远端有多少个不同号码，每个号码无论参与多少分段都只计一次。结合分段总数，可以区分流量是分散到多方还是集中在少数几方。

### 通话量与接通率随时间的变化

趋势图在左轴将已接听分段与其他分段堆叠为该时段的总量，并在右侧 0 至 100% 的轴上用折线显示 ASR。分桶粒度随范围变化：24 小时范围按小时，其余范围按天。结合两者可以区分流量增长和质量下降：堆叠量上升而折线持平，表示流量增加且路由仍能接通；堆叠量持平而折线下降，则表示路由开始无法接通。卡片下方的**查看所有分段**会打开同一时间窗口的分段日志。

### 通话如何结束

圆环图和图例按最终结果划分范围内的分段尝试次数，并显示每种结果的数量及其占分段总数的比例：

| 结果       | 含义                       |
| ---------- | -------------------------- |
| **已接听** | 分段已接通                 |
| **未接听** | 超时，但不代表电话曾响铃   |
| **失败**   | 被对端或网络拒绝           |
| **已拒绝** | 被对端拒接，或被 Bird 拒绝 |
| **未知**   | 无法确定结果               |
| **其他**   | 此列表尚未列出的结果       |

范围内没有分段的结果不会显示。要了解拒绝的原因而不只是频率，请打开具体分段：[被拒绝的通话](/docs/guides/voice/call-log#rejected-calls)说明了 Bird 为每个分段记录的原因。

### 主要国家/地区

国家/地区表按分段数量列出前 10 个目的地国家/地区，表格底部显示范围内有活动的国家/地区总数。这里指分段的目的地：出站分段为您拨打的国家/地区，入站分段为您自己的号码所属国家/地区。

按天选择范围时，表格底部还会显示该表覆盖的分段比例，每行也会用条形显示其占比。24 小时范围不显示这两项：明细按完整的本地日历日读取，上方卡片则覆盖滚动的 24 小时，两者的总数衡量不同的范围，计算它们之间的占比会造成误导。需要覆盖率时，请切换到 7 天或更长的范围。

每行包含分段数量、该国家/地区的**出站 / 入站**划分，以及自身的 ASR。某个国家/地区的 ASR 明显低于页面整体值，通常是仅影响某一目的地的路由问题的首个迹象。如果无法确定方向划分，则显示短横线。

### 通话质量

**通话质量** 选项卡包含连接指标和时长分布。某项指标在 Bird 于该范围内有测量值时才显示；缺失则表示 Bird 未测量到任何数据，这与分数差是两回事：

- **振铃延迟**，中位数和第 95 百分位数：主叫从拨号到听到振铃的等待时间。两者相差较大，说明路由通常接通很快，但偶尔会延迟。
- **音频质量**：平均意见分，即对通话听感的标准 1 至 5 分评分，取已测量分段的平均值。正常连接的评分高于 4。低于该值时，请筛选到一个中继或一个目的地，查看下降是否仅发生在某条路由，并检查同一选项卡中的短时分段，因为接通却没有音频的路由会同时影响这两项指标。
- **短时分段**：已接听且持续不足 30 秒的分段，显示为占已接听分段的比例。对于出站流量，该比例上升通常表示路由可以接通但没有音频。

**分段持续时长**将已接听分段按计费时长划分为六个区间，从不足 30 秒到 10 分钟及以上，并在上方显示平均时长。计费时长指接听后的时间，因此该分布对应您的语音费用。

### 呼入与呼出流量

**号码与路由**选项卡将混合视图中难以分辨的两个方向分开显示。卡片统计**出站分段**和**入站分段**，以及相较上一时间窗口的变化；旁边的**活跃号码**和**活跃中继**统计承载过流量的号码与中继。**方向随时间的变化**按时间桶堆叠两个方向，因此仅发生在入站流量上的变化也能显示出来，而不会被混合趋势掩盖。

图表下方的表格按您的号码、号码所属国家/地区、SIP 中继或方向细分该时段，并提供可排序的分段数、已接听分段数、ASR 和 ACD 列。您的号码所属国家/地区是分段中您所在的一端，与**概览**选项卡中的目的地国家/地区是不同的维度。中继行可以帮助您找出质量下降的中继，因此应比较各行的 ASR，而不是只看其中一行。号码和中继标签链接到对应记录，号码汇总则打开可搜索、可分页的视图，列出承载过分段的每个号码。

### 流量模式

**流量模式** 选项卡以您的本地时区分析通话到达的时间分布：一周中最繁忙的星期几和小时、按星期几和小时划分的网格图以及按小时的曲线。网格图和小时曲线需要超过一天的范围，且网格图最多显示最近 30 天的数据，因此在 90 天范围下会注明。按星期几汇总的曲线在范围达到 14 天时才出现，低于该值时每个星期几仅有一个观测值。

## 编程访问

使用 CLI 或 MCP 的统计操作来获取仪表板背后的聚合数据。这些聚合操作尚未发布公开的 HTTP 或 SDK 契约。如需 HTTP 或 SDK 报告，请使用下文描述的公开分段记录来自行计算聚合。

- **CLI。** [`bird voice stats summary`](/docs/cli/reference/voice-stats-summary) 返回指标卡片显示的时段聚合，[`bird voice stats daily`](/docs/cli/reference/voice-stats-daily) 和 [`bird voice stats hourly`](/docs/cli/reference/voice-stats-hourly) 返回趋势图背后的时间序列。分项数据包括 [`by-country`](/docs/cli/reference/voice-stats-by-country)、[`by-trunk`](/docs/cli/reference/voice-stats-by-trunk)、[`by-number`](/docs/cli/reference/voice-stats-by-number)、[`by-number-country`](/docs/cli/reference/voice-stats-by-number-country)、[`by-weekday`](/docs/cli/reference/voice-stats-by-weekday)、[`by-hour-of-day`](/docs/cli/reference/voice-stats-by-hour-of-day) 和 [`by-response-code`](/docs/cli/reference/voice-stats-by-response-code)，最后一项按最终 SIP 代码对通话分组，未在仪表板中图表化。这些命令接受与页面相同的窗口、时区以及目的地、号码、中继和结果筛选条件，但有一个例外：`by-response-code` 仅接受窗口、时区和 `--direction`，且其窗口为日历日而非时刻，因此覆盖的群体比筛选后的页面更广。仅需 `bird auth login` 授予的只读权限即可调用所有这些操作。参阅 [Bird CLI](/docs/cli) 指南完成安装和身份验证。
- **智能体。** [MCP 服务器](/docs/ai/mcp-server) 以工具形式暴露相同的统计读取接口。
- **自定义聚合。** 如需自定义报告或数据仓库，[`GET /v1/voice/legs`](/docs/api/reference/list-voice-legs) 返回筛选后的分段记录，分段日志的 [CSV 导出](/docs/guides/voice/call-log#getting-the-records-out)涵盖与当前筛选条件匹配的记录。[语音事件](/docs/guides/voice/events)将通话状态变更发送到您的端点。请将它们与已完成的分段记录进行核对，因为事件可能缺失或乱序到达。

在相同窗口和时区下，CLI 和仪表板的数值一致。仪表板在每次读取时发送你存储的时区；不带 `--timezone` 的命令按 UTC 分桶。

## 后续步骤

| 页面                                           | 涵盖内容                                         |
| ---------------------------------------------- | ------------------------------------------------ |
| [通话日志](/docs/guides/voice/call-log)        | 这些聚合背后的各个分段，以及某通通话被拒绝的原因 |
| [语音事件](/docs/guides/voice/events)          | 用于自定义报告的通话事件                         |
| [发起通话](/docs/guides/voice/placing-calls)   | Bird 从 `INVITE` 读取的内容，以及通话如何计费    |
| [故障排查](/docs/guides/voice/troubleshooting) | 当指标异常变动时，从症状追溯到原因               |

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/voice-api) (product)
- [Voice overview](/docs/guides/voice/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=voice)