了解从 Copilot Studio 下载的会话数据

可以在 Power Apps 和 Copilot Studio 中查看、导出和下载客户与代理交互的会话。

从 Copilot Studio 下载会话信息时,会以逗号分隔值 (CSV) 文件的形式获取可从 Power Apps 下载的信息子集。 CSV 文件包括实际对话以及有关会话的某些指标和信息(请参阅 使用会话脚本 获取 CSV 文件中包含的指标列表)。 若要查看所有活动,请通过 Power Apps 下载脚本。

ChatTranscript 字段中,每个机器人响应的限制为 512 个字符。 任何超过 512 个字符的机器人响应仅显示 CSV 文件中的前 512 个字符。 512 个字符的限制是针对每个响应,而不是针对每个会话,并且在一个给定的会话中可以有多个机器人的回答。

重要提示

具有 “环境创建者” 角色的创建者不会自动访问脚本。 访问记录需要机器人记录查看器角色权限。

如果管理员选择阻止访问与代理对话的文字记录,则无法下载这些记录。

可以直接从 Copilot Studio 下载过去 29 天的聊天脚本。

备注

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

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

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

先决条件

要查看记录:

  • 智能体的数据必须包含至少一个对话的会话(即数据不能只是基于触发器的运行)。

  • 需要 机器人脚本查看器 安全角色。 只有管理员可以通过在代理共享期间分配 机器人脚本查看器 安全角色来授予此角色。

下载智能体会话记录

  1. 打开所需智能体。

  2. 在顶部菜单栏上,选择分析

  3. 选择要下载的日期范围。

  4. 概览卡上方,选择下载会话

    或者,在有效性下,在对话结果卡上选择查看详细信息,然后选择下载会话

  5. 下载会话窗格中,选择一行来下载指定时间范围内会话记录。

    备注

    会话被分成代表 1 天增量的行,每个行最多有 5 万个会话。

    对于经典聊天机器人:如果指定的日期范围包括过去 24 小时内的日期,单个行最多表示 2,500 个会话。 否则,会话被拆分为代表 1 天增量的行,每行最多有 2,500 个会话。

    下载将立即开始。 该文件将保存到浏览器的默认下载位置。

使用会话记录

会话记录是一个逗号分隔值 (CSV) 文件,其中包含以下信息:

  • SessionID:每个会话的唯一标识符。

  • StartDateTime:会话开始的时间。 条目按此列使用降序排序。

  • SessionOutcome:会话结果 (ResolvedEscalatedAbandonedUnengaged)。

  • OutcomeReason:关于会议结果原因的额外信息。

  • IsResolvedImplied:如果为真,则会话因完成且未经过用户确认而基于代理逻辑而被解决。 如果为假,则会话被解决,因为 End of Conversation 话题被触发且用户确认互动成功。 如果结果不是 resolved,则该字段为空。

  • Turns:本场次的总回合数。 在 Copilot Studio 的会话文字记录中,轮值由用户消息或代理的单一回复组成。

  • ChatTranscript:会话的文字记录格式如下:“用户说: <UserInput>;特工说: <副驾驶响应>;

    • 使用分号分隔对话回合。
    • <CopilotResponse> 不包括向用户显示的选项。

    示例: User says: store hours; Bot says: Which store are you asking about?; User says: Bellevue; Bot says: Bellevue store is open from 10am to 7pm every day.;

  • InitialUserMessage:用户键入的第一条消息。

  • TopicName:在此会话中触发的最后一个作者主题的名称。

  • TopicId:在此会话中触发的最后一个撰写的主题的唯一标识符。

  • ChannelId:该会话执行的通道(例如, directlinemsteamsfacebookconversationconductor)。

  • Comments: 所有用户评论列表,包含点赞和点踩反馈。