了解从 Power Apps 下载的对话记录

您可以在 Power Apps 和 Copilot Studio 中查看、导出和下载客户与智能体的交互记录。 每个应用导出的信息略有不同。

重要提示

具有环境创建者角色的制作者不会自动获得访问记录的权限。

本文介绍如何在 Power Apps 中下载对话记录并使用它们在 Power BI 中创建报告。 要直接下载 Copilot Studio 中下载记录，请参阅在 Copilot Studio 中下载对话记录。

默认情况下，Power Apps 下载最近 30 天的对话记录。 您可以更改保留期限。

备注

当使用 SharePoint 作为知识来源时，对话记录中会包含问题以及用于生成回复的源文档内容（标记为 search_results 的字段）。 但回复内容不会包含在内（标记为 REDACTED）。

对话记录不是为以下目的编写的：

  • Microsoft Dataverse for Teams 环境
  • Dataverse 开发人员环境
  • 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 智能体

先决条件

从 Power Apps 门户查看和导出对话记录

  1. 登录到 Power Apps。

  2. 在侧窗格中，选择表格，然后选择全部。

    选中“全部”的“表”节点屏幕截图。

  3. 在搜索框中输入“对话”。

  4. 选择 ConversationTranscript 表。

    ConversationTranscript 表的页面打开。

  5. 在顶部菜单栏中，选择导出>导出数据。

    准备要导出的数据大约需要几分钟。

    显示带“导出数据”选项的“导出”菜单的屏幕截图。

  6. 等待几分钟时间让 Power Apps 准备要导出的数据，然后选择下载导出的数据。

    文件将保存为 ZIP 存档到浏览器的默认下载位置。

了解对话脚本

对话记录以 Dataverse 表形式存在，您可以将其下载为 CSV（逗号分隔值）文件。 用于确定系统何时以及如何将信息记录到对话记录的逻辑如下：

  • 系统会在对话不活跃 30 分钟后，将其保存为记录。 如果对话在不活跃时间后恢复，系统会将新活动保存到一个新记录，其中 Name 值相同，但 ConversationStartTime 值为新的。
  • 对于发布到语音通话通道的智能体，对话将在结束对话事件发生后三分钟超时。
  • 每条记录的记录限制为 1 MB（Content 列）。 当记录超过此限制时，系统会将其拆分为多个记录，这些记录拥有相同的 Name 和 ConversationStartTime 值，但 Metadata.BatchId 值不同。
  • 若要合并记录，获取包含相同 Name 和 ConversationStartTime 值的所有记录，然后按 BatchId 对这些记录进行排序。

下表介绍对话记录中最重要的字段。

字段 说明 示例
Content JSON 格式的整个脚本记录 查看内容字段
ConversationStartTime 对话的开始时间（不是脚本记录写入数据存储的时间） 2021-04-19T20:39:09Z
ConversationTranscript 行 Dataverse 表中的唯一标识符 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata 包含智能体 ID、租户 ID、智能体名称和批处理 ID 的 JSON {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name 从后跟 BotId 的 ConversationId 中创建的自定义行的名称 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript 代理 ID aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on 创建脚本记录的日期和时间 2021-04-20T02:40:13Z

内容字段

Content 字段是用户与代理进行的所有活动的原始记录。 常见活动类型包括消息和事件：

  • 消息活动表示对话中显示的内容。 消息活动可能包含文本、语音、交互式卡以及二进制或未知附件。
  • 事件活动将来自客户端或渠道的程序信息传达给代理。

有关活动类型的详细信息，请参阅 Bot Framework 活动架构。

下表介绍了内容 JSON 中的一些键字段：

项 说明
ID 活动对象的唯一 GUID
valueType 存储在活动中的值的类型；它规定了活动提供的信息（常见活动值类型）
timestamp 以 Epoch 格式生成活动的时间戳（自 UTC 1970 年 1 月 1 日午夜以来的秒数）
type 活动的类型；例如 message、event 或 trace
replyToId 当前活动正在响应的活动的 ID
from 包含字段 id 和 role：
  • id - 调用者的 ID
  • role - 保留 0 或 1
    • 0 - 活动来自代理
    • 1 - 活动来自与代理互动的用户
注意：
如果区域传入用户的唯一 ID，id 可用于计算与代理交互的活动用户数。 如果区域未传递 ID，则传递每个对话的唯一 ID。
出于安全和隐私考虑，系统会在将 ID 写入记录之前对 ID 进行哈希处理。
channelId 活动来源的渠道 ID；例如 directline、msteams 或 facebook
textFormat 文本的格式；例如 plain 或 markdown
attachments 与活动关联的动态丰富数据；例如 AdaptiveCards、HeroCards 或 Carousel data
text message 活动的文本
value 基于值类型的特定于活动的字段；此字段用于显示大部分有用信息
channeldata 包含渠道数据：
  • 对于消息：
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail（包含分配到变量的值）
    • CurrentMessageDetail
  • 对于事件：
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name 事件活动的名称；例如 SetPVAContext

常见活动值类型

活动值类型 描述
ConversationInfo 对话是否来自 Copilot Studio 测试窗格 (isDesignMode) 以及对话的区域设置
CSATSurveyRequest 将向用户显示客户满意度 (CSAT) 调查
CSATSurveyResponse 用户响应 CSAT 调查
DialogRedirect 用户将重定向到另一个主题
ImpliedSuccess 用户已到达主题中的问题节点，其中一个条件指向确认成功 CSAT 系统主题（仅限经典机器人）或调用对话结束系统主题
IntentRecognition 用户触发了一个话题
PRRSurveyRequest 系统询问用户主题是否在结束对话主题中回答了其问题
PRRSurveyResponse 用户响应主题是否在结束对话主题中回答了其问题
SessionInfo 类型（unengaged 或 engaged）、结果（Escalated、Resolved、Abandon）、会话开始和结束时间（startTimeUtc、endTimeUtc），以及会话的回合数
VariableAssignment 给变量赋值

增强型记录

您可以配置智能体生成包含节点级数据的增强型记录。 此数据帮助跟踪主题内的对话流。 例如，在管理订单主题中，用户可以选择提交新订单还是检索现有订单。 节点级数据支持跨这些选项分析用户行为。

打开增强型记录

  1. 打开您的智能体。

  2. 转到设置>高级。

  3. 选择增强会话记录，然后开启在会话记录中包含节点级别详细信息。

显示“增强型记录”设置页面的截图。

节点级数据

启用增强型记录后，记录会包含每个主题调用的节点的 nodeTraceData 活动类型。 下表描述了 nodeTraceData 活动值中的关键字段。

项 描述
nodeID 节点标识符
nodeType 节点类型，例如 SendActivity 或 SearchAndSummarizeContent
startTime 调用节点的时间戳
endTime 节点完成执行的时间戳
topicDisplayName 调用节点的主题

自定义分析

某些场景（如基于自定义变量筛选对话）需要自定义分析方法。 要构建自定义分析解决方案，客户可以将原始记录内容导入其数据管道，或者使用附加产品，如 Copilot Studio 工具包。

Copilot Studio 工具包中的对话 KPI 解决方案KPI 解决方案会自动解析记录，并将聚合数据填充到 Dataverse 表中。

更改默认保留期

Power Apps 批量删除作业会自动删除 30 天以上的智能体记录。 为了使记录保留更长时间，请取消现有作业并创建一个按不同计划运行的新作业。

备注

如果你更改默认的 Dataverse 保留期限，只有自定义分析会受影响。 Copilot Studio 中的分析页面的保留期不受影响。

取消现有批量删除作业

  1. 在 Power Apps 中，选择设置>高级设置。

    Dynamics 365 门户将在新选项卡中打开。

    Power Apps 设置菜单的屏幕截图，突出显示“高级设置”。

  2. 选择设置旁边的箭头。 在系统下，选择数据管理。

    设置菜单的屏幕截图，其中突出显示了“数据管理”。

  3. 选择批量删除记录。

  4. 在视图列表中，选择定期批量删除系统作业。

    定期批量删除作业列表的屏幕截图。

  5. 选择批量删除超过 1 个月的对话脚本记录作业。

    批量删除作业列表的屏幕截图，其中突出显示了第一个作业。

  6. 在更多操作列表中，选择取消。

    已突出显示“取消”的“其他操作”列表的屏幕截图。

创建新的批量删除作业

  1. 选择新建启动批量删除向导。 在向导中，选择“下一步”。

  2. 设置以下搜索条件：

    • 在查找列表中，选择 ConversationTranscripts。
    • 选择 ConversationStartTime，然后选择 X 个月以前，并键入 "12"。
      此设置会将记录保留 12 个月。 如果需要，请选择不同的比较和值。
    • 选择 SchemaType，保持等于，并输入“powervirtualagents”。

    批量删除作业搜索条件设置的屏幕截图。

  3. 选择下一步。

  4. 输入作业的名称，并选择运行此作业的间隔，然后输入 1。 如果您不希望该作业每天运行，请选择其他计划。

    批量删除作业名称和运行设置的屏幕截图。

  5. 选择下一步，然后选择提交。

为什么我在 ConversationTranscript Power Apps 表中看不到我的对话记录？

管理员可以阻止将记录保存到 Dataverse。 有关会话记录的保存方式和访问管理的详细信息，请参阅会话记录访问控制。

重要提示

在开发人员环境中部署的智能体不会存储记录。

有关充分利用对话记录的提示

使用变量存储与智能体内容或智能体用户相关的数据。 通过从对话脚本中分析变量及其值，您可以按变量筛选或切分数据。

对话记录可能只通过 ID 来引用内容。 例如，在重定向节点中，目标主题只用其 ID 表示。 要获取本主题的名称，请查找代理内容中的 ID。

  • Last updated on