对话记录工具提供了一个界面，用于浏览和分析代理与最终用户之间的实际生产对话。您可以使用此工具评估代理的功能性能或调试问题。
通过流和页面分析，您可以通过代理的流图了解流量和上报。通过此分析，您可以分析流量、发现问题热点（例如，查明高升级率），并深入了解导致问题的特定页面和意图。您可以将流程和页面分析与对话记录过滤条件结合使用，以研究相关的流量子集。
限制
对于配置较大的代理，加载流分析表和流分析图表视图可能会很慢。为了缩短加载时间，请使用 intent 过滤器和一周的日期范围。
系统最多会为每个对话记录 500 轮。
所需权限
使用此工具需要 dialogflow.conversations 权限。您可以将此权限添加到自定义角色。管理员角色和其他 Dialogflow CX 角色也拥有此权限。
启用和停用对话历史记录
对话记录工具会显示来自代理的对话。如需启用或停用此功能，请前往启用对话记录设置。
您还可以使用 retention_window_days 安全设置来管理数据的保留时长。
音频播放
对话记录功能可提供对话的音频播放。您可以在常规设置中启用此功能。如果您在加载对话之前未启用此功能，控制台会显示一条通知，指出音频播放功能不可用。
借助此功能，您可以使用签名网址直接在控制台中收听对话音频。音频播放功能使用签名网址，提供对存储在 Cloud Storage 存储桶中的音频文件的限时访问权限，从而无需向用户授予对 Cloud Storage 存储桶的直接访问权限。
如需播放音频，您必须拥有生成签名音频网址的权限。您还必须已将语音对话导入控制台，并且音频 URI 指向 Cloud Storage 存储桶中的音频文件。
浏览对话记录
如需使用对话记录工具，请执行以下操作：
- 前往 Conversational Agents 控制台。
- 选择您的项目。
- 选择您的代理。
- 在导航菜单中，选择对话记录。
- 在表格中查看对话。
- （可选）使用表格上方的过滤条件控件应用过滤条件。
- 选择本文档后面部分所述的其中一个标签页。
将对话记录下载到 CSV 文件
您最多可以将 50 个对话下载到 CSV 文件中。使用对话记录页面上的过滤对话字段，选择要导出的特定对话。如需导出更大批量的对话，请使用 BigQuery。
- 在导航菜单中，选择对话记录。
选择一个对话，然后点击在预览面板中打开对话。
点击导出所有对话。系统会将包含对话内容的 CSV 文件下载到您的计算机。
对话
您可以在对话摘要视图和对话详情视图中查看对话。
对话摘要视图
对话摘要视图会列出所有对话，并为每个对话提供以下元数据：
| X | 项 |
|---|---|
| 对话 ID | 对话的标识符。 |
| 时长 | 对话时长。 |
| 转向 | 对话轮数。 |
| 渠道 | 聊天（文本）、语音或未确定（尚未向对话提供最终用户输入）。 |
| 语言 | 对话所用的语言。 |
| 环境 | 代理的环境。 |
| 开始时间 | 对话的开始时间。 |
| 标志 | 可设置为人工客服转接标志（如果对话升级到人工客服）、Abandoned（如果最终用户离开了未完成的对话）或 TU,TD 标志（如果对话中的回答获得了最终用户评分）。 |
您可以按元数据（环境和时长除外）以及以下其他过滤条件选项过滤结果：
| X | 项 |
|---|---|
| Intent | 在对话中的某个时间点匹配到了提供的意图。 |
| 无匹配 | 部分对话轮次导致意图不匹配。 |
| Flow | 提供的流是某些对话轮次结束时的最终活跃流。 |
| 页面 | 提供的页面是某个对话轮次结束时的最终活跃页面。 |
| 是否移交给人工客服 | 转接人工客服标志已设置。 |
| 已放弃 | Abandoned 标志已设置。 |
| 对话 ID | 选择特定对话。 |
| 开始时间 | 提供日期范围。 |
| 智能体话语 | 提供的文本是代理在对话中某个时间点使用的语句的子字符串。子字符串必须包含完整字词，并以空格字符或字符串的任一端为界，就像在语音中一样。 |
| 用户话语 | 提供的文本是用户话语的子字符串。子字符串必须包含完整字词，并以空格字符或字符串的任一端为界，就像在语音中一样。 |
| 有“我喜欢”反馈 | 针对对话中的回答提供了“我喜欢”反馈；TU 标志已设置。 |
| 有“不喜欢”反馈 | 针对对话中的回答提供了“不喜欢”反馈；TD 标志已设置。 |
对话详情视图
您可以在对话详情视图中浏览特定对话的逐轮视图。每个轮次都提供最终用户消息、代理消息和以下元数据：
| X | 项 |
|---|---|
| Intent | 匹配或不匹配的 intent 显示名称。 |
| 页面 | 最终活跃页面名称。 |
| Flow | 最终活跃流程名称。 |
| 播放对话 | 对话播放控件，包括音频（如有）。 |
| 参数 | 在对话轮次期间收集的参数。 |
用例示例
找出导致问题上报给人工客服的代理问题。在对话摘要视图中，将是否移交给人工客服过滤条件设置为是。
检查其中一些对话，找出常见模式。例如，您可能会发现，在大多数对话中，特定页面上的轮次都会出现 No Match 标志。这表示您需要创建 intent 路由，或者现有 intent 路由在需要时不在范围内。
流量分析表
通过流分析 - 表格标签页，您可以以表格形式分析流和页面中的流量和退出情况。
系统会显示以下指标：
| X | 项 |
|---|---|
| 工作流名称 | 代理中每个流的流名称。 |
| 相对流量 | 通过此流程进行的对话数量。 |
| 上报率 | 在通过此流程的所有对话中，导致请求人工上报的对话所占的百分比。 |
| 退出率 | 在经历过此流程的所有对话中，在此流程后结束或从此流程过渡到SESSION_END的对话所占的百分比。 |
点击列表 按钮，打开该行相关对话的示例。您可以通读这些示例，更好地了解具体而细微的问题。例如，您可以检查升级发生的原因。如需查看样本的完整详细信息，请点击对话详情链接。
点击某个流程的详细统计信息，以查看所选流程的流程转换统计信息。
系统会显示以下指标：
| X | 项 |
|---|---|
| 下一个流程 | 从所选流程过渡到其他流程的统计信息。 |
| 旧版流程 | 从其他流程转换到所选流程的统计信息。 |
点击任意流程行，即可深入了解构成该流程的页面。
系统会显示以下指标：
| X | 项 |
|---|---|
| 相对流量 | 访问过此网页的对话数量。 |
| 上报率 | 在访问过此页面的所有对话中，导致请求人工升级的对话所占的百分比。 |
| 退出率 | 在访问过此页面的所有对话中，在访问此页面后直接退出流程或退出会话 (END_SESSION) 的对话所占的百分比。 |
| 无匹配率 | 在访问过此页面的所有对话中，导致无匹配结果的对话所占的百分比。 |
点击某个页面的详细统计信息，即可查看流量统计信息，其中显示了所选页面的页面转换统计信息。
系统会显示以下指标：
| X | 项 |
|---|---|
| Intent | 该网页的意图匹配统计信息。 |
| 下一页 | 从所选页面过渡到其他页面的统计信息。 |
| 上一页 | 从其他页面跳转到所选页面的统计信息。 |
流分析图
通过流分析图标签页，您可以分析流程和页面中的流量和退出情况。
点击任一流程，即可深入了解该流程中各页面的流量。
使用缩放滑块可更改图表上的详细程度。在较低的缩放级别下，可视化图表中会隐藏低流量路径。即使在较高的设置下，系统也始终会隐藏流量非常低的路径。
指标采用颜色编码，可帮助您识别严重程度较高的问题。
点击列表 按钮，即可显示相关对话。
选择一个流程，即可查看该流程中的页面。您可以查看以下叠加层指标：相对流量、无匹配率、上报率和退出率。
通过 API 访问对话记录
您可以通过 API 访问对话记录。请参阅 V3beta1 参考文档。
隐私权
启用对话记录功能后，Google 会收集并存储您的对话数据一段时间，然后将其永久删除。默认值为 365 天，但您可以使用 SecuritySettings 中的 retention_window_days 字段缩短此时间段。
您对存储的数据拥有完整的所有权。Google 不会出于客户支持之外的任何其他目的使用或访问您的数据。