对话记录操作指南

功能简介

对话记录用于查询用户与大模型实时互动产生的历史记录，帮助开发者回溯一次完整对话，查看实例、设备和用户信息，并核对互动过程中的语音与文本内容。

典型用途包括：

• 根据用户或实例定位一次历史互动。
• 回溯用户与 Agent 的对话过程。
• 试听互动中的音频内容，复现用户反馈的问题。
• 结合实例 ID、设备 ID 和时间范围排查业务或接入异常。

“对话记录”用于查询已经发生的日常互动；“语音调测”用于在联调期间额外录制原声、ANS 后、AEC 后和 AGC 后音频。两者用途不同。

使用前提

• 已开通百度智能云实时音视频 RTC 和大模型实时互动服务。
• 已创建互动应用，并已通过客户端、服务端或控制台 Demo 产生互动实例。
• 当前账号具有目标互动应用及其对话记录的查看权限。
• 部分历史范围、音频回溯或扩展能力可能需要开通相应资源或申请权限，以控制台提示为准。

进入对话记录页面

1. 登录百度云智能平台
2. 进入 实时音视频 RTC。
3. 在左侧导航中展开 大模型实时互动。
4. 选择 互动记录。
5. 切换到 对话记录 页签。

查询对话记录

1. 在“应用名称/ID”中选择目标互动应用。
2. 根据已知信息设置用户筛选条件；页面默认提供“用户 ID”维度。
3. 如已知实例 ID，可在“实例 ID”中输入完整实例 ID，进一步缩小查询范围。
4. 设置“时间范围”。页面默认显示最近 1 天的时间区间。
5. 单击 查询。

如果需要重新设置条件，单击 重置，再重新选择应用和筛选条件。

查询条件说明

如果使用 互动应用 > 体验 Demo 产生测试数据，请先正常结束体验，再回到对话记录页面查询。新记录可能需要等待短暂的后台处理时间。

查看对话详情

1. 找到目标互动记录。
2. 在对应行的“操作”列进入详情。
3. 按时间顺序查看用户与 Agent 的对话内容。
4. 对照文本和音频，确认用户输入、Agent 回复及事件发生顺序。
5. 完成查看后返回列表，可继续查询其他实例。

详情页用于还原一次对话场景。根据互动类型和已开通能力，页面可能展示：

• 用户和 Agent 的文本消息。
• 用户输入或 Agent 回复对应的音频内容。
• 消息发生时间及对话顺序。
• 与本次互动关联的实例、用户或设备信息。
• 页面提供的试听或下载操作。

试听互动音频

1. 在详情页定位需要核对的对话轮次。
2. 单击该条音频的播放控件。
3. 结合相邻文本内容判断音频是否属于目标问题。
4. 重点检查音量、底噪、回声、卡顿、截断、识别结果和回复内容是否符合预期。

如果需要对比语音处理前后的差异，请转到 语音调测。对话记录侧重还原实际互动内容，不等同于原声、ANS、AEC、AGC 四路调测录音。

使用实例 ID 精确排查

当业务日志或用户反馈中已经提供实例 ID 时，建议按以下方式查询：

1. 选择实例所属的互动应用。
2. 将实例 ID 粘贴到“实例 ID”输入框。
3. 将时间范围覆盖到该实例发生的时间。
4. 单击 查询。
5. 核对结果中的设备 ID、用户 ID 和时间范围，确认记录无误后进入详情。

实例 ID 是跨控制台记录、业务日志和问题反馈定位同一次互动的优先标识。

对话记录与语音调测的区别

常见问题

“查询”按钮不可用

请检查页面中的必填筛选条件（应用名称/ID、用户/设备ID）是否已经完整填写。

完成互动后查询不到记录

依次检查：

1. 是否选择了实际发生互动的应用。
2. 用户 ID、实例 ID 是否输入正确。
3. 时间范围是否覆盖互动发生时间。
4. 互动是否已经正常结束。
5. 新记录是否仍在后台处理中。
6. 当前账号是否具有该应用和记录的查看权限。

使用 Demo 后没有立即出现记录

确认 Demo 已正常结束，并重新进入对话记录页面或刷新查询时间的结束时间。页面默认结束时间取进入页面时的当前时间；如果互动发生在页面打开之后，应更新结束时间再查询。

详情中没有音频

可能原因包括互动本身未产生对应音频、记录仍在处理、音频已超过可用范围，或账号尚未开通相应能力。请先检查文本记录和实例信息，再根据控制台提示确认权限或资源状态。

需要比较降噪、回声消除或增益效果

请使用 语音调测，并在互动开始前添加正确的调测标识、打开“开启调试”开关。

语音调测操作指南

功能简介

语音调测用于定位设备端语音互动中的音频问题。开启调测后，设备与 Agent 进行语音互动时，云端会录制 Agent 接收到的以下音频：

• 原声
• ANS（Automatic Noise Suppression，自动噪声抑制）处理后的音频
• AEC（Acoustic Echo Cancellation，声学回声消除）处理后的音频
• AGC（Automatic Gain Control，自动增益控制）处理后的音频

调测完成后，可在控制台查看最近一次已完成的互动实例，并下载录制音频进行对比分析。

说明：语音调测面向开发和联调场景，用于比较不同处理阶段的音频效果；“对话记录”面向日常互动查询，用于按应用、用户、实例和时间查询已发生的互动。

使用限制

• 最多同时调测 5 个设备。
• 每个调测设备仅支持下载最近一次已完成对话的音频。
• 调测标识最多 64 个字符，仅支持英文字母、数字和下划线（_）。
• 调测标识必须与创建互动实例时传入的自定义参数一致，否则互动不会关联到该调测设备，也不会生成对应的录制结果。
• 应在开始语音互动前添加调测设备并保持“开启调试”开关打开。

进入语音调测页面

1. 登录百度智能云控制台
2. 进入 实时音视频 RTC。
3. 在左侧导航中展开 大模型实时互动。
4. 选择 互动记录。
5. 切换到 语音调测 页签。

页面说明

语音调测列表包含以下字段：

添加调测设备

1. 在 语音调测 页签中，单击 新增设备。
2. 在“应用名称/ID”中选择需要调测的互动应用。
3. 输入“调测标识”。
4. 单击 确定。

添加成功后，设备出现在调测列表中，“开启调试”默认打开。

参数说明

示例：

1voice_debug_device_01

调测标识不是仅用于控制台展示的备注。设备端或服务端创建互动实例时，必须传入相同参数，云端才能将该实例的音频关联到当前调测配置。

完成一次语音调测

1. 确认目标设备的 开启调试 开关处于打开状态。
2. 在设备端创建互动实例，并传入与控制台一致的调测标识。
3. 与 Agent 完成一次语音互动。
4. 正常结束本次互动，等待云端完成音频处理。
5. 返回控制台的 互动记录 > 语音调测 页面。
6. 查看“最近调试实例 ID”和“时间范围”是否已更新。

若使用控制台互动应用的 Demo 进行验证，可进入 互动应用，在目标应用的操作列单击 体验 Demo，完成一次音频畅聊。使用 Demo 前仍需确认实例创建参数与调测标识一致；仅选择同一个应用并不足以关联调测记录。

下载录制音频

1. 等待目标互动完成，并确认列表已显示“最近调试实例 ID”和“时间范围”。
2. 在目标设备所在行的操作列中选择下载操作。
3. 按页面提示下载需要分析的录制音频。
4. 分别试听原声、ANS 后、AEC 后和 AGC 后音频，对比各处理阶段的效果。

建议重点关注：

新的对话完成后，列表中的“最近调试实例 ID”和可下载音频会更新为最近一次结果。如需保留历史样本，请在下一次调测前及时下载。

开启或停止调测

• 打开“开启调试”开关后，后续匹配该调测标识的互动可进入录制流程。
• 关闭开关后，后续互动不再生成该设备的调测录音。
• 不再需要调测时，建议及时关闭开关，避免产生无关录制。

删除调测设备

1. 在目标设备所在行的操作列中单击 删除。
2. 核对待删除的调测配置。
3. 按确认提示完成删除。

删除后，该调测标识不再出现在列表中；后续使用相同标识创建的互动也不会继续生成该配置下的调测录音。如仍需调测，应重新添加设备。

常见问题

互动已经完成，但列表仍显示 -

依次检查：

1. 互动开始前是否已添加调测设备。
2. “开启调试”开关是否打开。
3. 创建实例时传入的自定义参数是否与调测标识完全一致。
4. 实际互动所用应用是否与调测配置中的应用一致。
5. 对话是否已经正常结束，云端是否仍在处理录音。

为什么只能看到一次调测结果

当前仅保留最近一次已完成对话的可下载音频。完成新的匹配对话后，列表将更新为新的实例和时间范围。

为什么无法新增更多设备

系统最多支持同时调测 5 个设备。请关闭或删除不再使用的调测配置后再添加。

调测标识为什么校验失败

请确认长度不超过 64 个字符，并且只包含英文字母、数字和下划线。连字符（-）、空格和中文均不支持。