通过

在 Power Apps 中下载会话记录

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

重要提示

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

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

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

备注

使用 SharePoint 作为知识源的代理回复不包含在对话记录中。

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

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

先决条件

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

  1. 登录到 Power Apps。

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

    此屏幕截图显示在“表”节点上选择了“所有”。

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

  4. 选择 ConversationTranscript 表。

    ConversationTranscript 表的页面打开。

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

    编译数据以供导出可能需要几分钟时间。

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

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

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

了解对话脚本

对话记录是 CSV（逗号分隔值）文件。 下表介绍对话记录中最重要的字段。

字段 Description 示例
Content JSON 格式的整个脚本记录 查看内容字段
ConversationStartTime 对话的开始时间（不是脚本记录写入数据存储的时间） 2021-04-19T20:39:09Z
ConversationTranscript Dataverse 表中行的唯一标识符 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata 包括代理 ID、租户 ID 和代理名称的 JSON {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name 从后跟 batch number 和BotId 的 ConversationId 中创建的自定义行的名称。 当对话有多个分析会话时，批号表示顺序。 经典机器人不包括批号。 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript 代理 ID aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on 创建脚本记录的日期和时间 2021-04-20T02:40:13Z

内容字段

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

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

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

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

项 Description
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 进行哈希处理。
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

常见活动值类型

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

增强型记录

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

打开增强型记录

  1. 打开您的代理。

  2. 转到设置>高级。

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

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

节点级数据

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

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

自定义分析

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

Copilot Studio 工具包中的会话关键绩效指标解决方案会自动解析记录，并将汇总数据填充到 Dataverse 表格中。

更改默认保留期

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

取消现有批量删除作业

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

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

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

  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。