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