> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marsmind.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 明细数据

> 按条件筛选沟通记录并导出为 xlsx，还能下钻到单条消息，核对 AI 当时的参考知识与处理步骤。

「明细数据」用来逐条查看 AI 与客户的原始沟通记录：按窗口、时间和条件筛出你要的那批消息，导出成表格，并能下钻到某一条问询，看 AI 当时参考了哪些知识、走了哪些处理步骤。

## 什么时候会用到它

* 客户反馈某条回复有问题：找到那条消息，看 AI 当时参考了什么知识、执行到哪一步。
* 抽查接待质量：按用户、群或意图分类筛出一批记录，逐条读用户问询与 AI 响应。
* 交付与存档：把某段时间的沟通明细导出成 xlsx，发给同事或本地留存。
* 复核含人工坐席的会话：切到「坐席混合数据」，连同坐席收发的消息一起看。

## 进入路径

左侧菜单 → 数据看板 → 明细数据，顶栏面包屑显示「数据看板 → 明细数据」。

进入后先确认左侧的「统计窗口」（部门管理员上方还有「账号」）；页面主体是两个 Tab：「沟通数据详情」（默认，只有 AI 与客户的对话）和「坐席混合数据」（包含人工坐席的消息）。

<Frame>
  <img src="https://mintcdn.com/marsmind/HNHRs6vacagNDtPr/images/cn/guide/dashboard/data-export/01-overview.jpg?fit=max&auto=format&n=HNHRs6vacagNDtPr&q=85&s=c122be4a3a6c3a2d7a72f929e0c131f2" alt="明细数据整页：顶部是「沟通数据详情」「坐席混合数据」两个 Tab，工具栏含搜索框与「更多筛选」「导出当前查询结果」「搜索」按钮，表格列为时间、用户、群、用户问询、AI响应、操作；左侧是统计窗口切换器" width="1600" height="900" data-path="images/cn/guide/dashboard/data-export/01-overview.jpg" />
</Frame>

## 操作步骤

<Steps>
  <Step title="确认统计窗口和查询时间">
    左侧「统计窗口」选中要查的渠道（或「全部窗口」）。页面打开时会自动按默认条件（时间范围「最近30天」）查询一次；之后切换「统计窗口」或「账号」，也会自动重新查询。

    时间在「更多筛选」里的「日期」中选：当天、最近3天、最近7天、最近30天、自定义。选「自定义」后还要在下方日历里选起止日期，范围限 2–31 天；只选了开始日期就点搜索，只会提示「选择日期范围」，结果不会更新。

    判断标准：表格上方的范围行给出这次查询的起止日期与条数（形如「当前结果与导出范围：开始日期 至 结束日期，共 N 条」）。

    注意：「统计窗口」选错，查到的是另一个渠道的记录。
  </Step>

  <Step title="按需补充筛选条件">
    工具栏左侧的搜索框按「用户问询内容」搜；其余条件收在「更多筛选」里：

    * 「用户名」「群名」：定位某个人或某个群的记录；
    * 「AI响应内容」：按 AI 回复的文本筛；
    * 「AI响应」：选「有AI响应」或「无AI响应」，只看 AI 有没有回过；
    * 「意图分类」：先选「一级分类」或「二级分类」，再输入完整分类名称。层级停在「不限层级」或分类名为空时，这个条件不生效。

    改动过筛选后，筛选条标签会变成「待查询的筛选条件」，下方出现黄色提示「筛选条件已修改。请先查询，随后才能导出与表格一致的结果。」——看到它，说明当前表格还是上一次查询的结果。

    条件加多了可用「重置」清空回默认值（清空后同样要重新「搜索」才生效）。

    提示：从「业务表现」点分类或「查看当前范围记录」跳过来时，日期、窗口、账号和分类会自动带入，不用重填。
  </Step>

  <Step title="点「搜索」，确认结果范围">
    改完条件点「搜索」（在任一输入框里按回车也一样）。表格上方的范围行会更新为「当前结果与导出范围：开始日期 至 结束日期，共 N 条」；底部的「每页条数」（10/20/50）和翻页只影响显示，不影响导出。

    判断标准：范围行的日期、条数与你要查的一致；筛选条标签回到「已应用筛选」；黄色提示消失。

    查询失败时会显示红色提示条（「查询失败，尚无可显示的结果；请重试。」或「查询失败，仍显示上次成功的结果；请重试后再导出。」），点「重试查询」重试；失败状态下不要导出。
  </Step>

  <Step title="需要看含人工坐席的会话，切到「坐席混合数据」">
    点第二个 Tab。筛选条变为「日期」「会话ID」「消息类型」（全部类型、用户、AI 助手、坐席），搜索框变为「消息内容」；表格列是创建时间、会话ID、消息内容、消息类型、发送者。

    用法和「沟通数据详情」一样：改动筛选后要重新「搜索」。两个 Tab 的筛选、查询结果和导出互不影响。

    判断标准：切换 Tab 后表头和筛选条一起变化；「消息类型」列里能看到用户、AI 助手和坐席三类消息。

    <Frame>
      <img src="https://mintcdn.com/marsmind/HNHRs6vacagNDtPr/images/cn/guide/dashboard/data-export/03-agent-data-tab.jpg?fit=max&auto=format&n=HNHRs6vacagNDtPr&q=85&s=3c113417a013d0f43a4adfc0759a8569" alt="「坐席混合数据」Tab：筛选条为日期、会话ID、消息类型，表格列为创建时间、会话ID、消息内容、消息类型、发送者" width="1600" height="1000" data-path="images/cn/guide/dashboard/data-export/03-agent-data-tab.jpg" />
    </Frame>
  </Step>

  <Step title="下钻一条消息，看当时的处理链路">
    在「沟通数据详情」里点某行「用户问询」单元格（悬停提示「点击查看这条消息的执行步骤和参考知识」），会打开覆盖整个表格的「消息处理链路」面板，点左上角「返回记录」关闭。

    面板从上到下：

    * 这一轮的「原始问题」和「记录中的 AI 回复」；
    * 三项独立证据：「回复生成」「客户送达」「护栏拦截」，取不到记录时显示以「未知 · 未取得…」开头的说明（面板下方注明「响应记录不等于已送达客户；没有护栏记录也不等于未触发。」）；
    * 两个 Tab：「参考知识（N）」默认打开，列出这条消息当时召回的知识及「召回参考值」，在「操作」列点「编辑」可以修改这条知识（保存后系统会重新计算召回），个别历史知识在无法定位到知识库条目时只能查看、不能编辑；「执行步骤」按「当时的聊天上下文 → 群聊处理 → 回复判定 → 技能调用 → 知识生成 → 安全围栏」逐行展示，聊天上下文一行可以展开，看本轮之前的会话上下文（含本轮）。

    判断标准：参考知识 Tab 的标题带条数；执行步骤里各阶段给出明确结论（如「需回复」「已进入」「通过」）；没有知识时显示「暂无参考知识」，可点下方「查看执行步骤」切到流程。

    <Frame>
      <img src="https://mintcdn.com/marsmind/HNHRs6vacagNDtPr/images/cn/guide/dashboard/data-export/02-message-trace.jpg?fit=max&auto=format&n=HNHRs6vacagNDtPr&q=85&s=f5724163ed5965cacd8eb50026e403c3" alt="「消息处理链路」面板：顶部是原始问题与记录中的 AI 回复，中间是回复生成、客户送达、护栏拦截三项证据，下方是「参考知识（N）」与「执行步骤」两个 Tab" width="1600" height="1000" data-path="images/cn/guide/dashboard/data-export/02-message-trace.jpg" />
    </Frame>

    注意：行尾的「查看本条详情」是另一个入口，只弹出这一条的问询、AI 回复和附件（弹层里写明「这里不是整段会话。」）。要追处理过程，请点问询内容打开「消息处理链路」。
  </Step>

  <Step title="导出当前查询结果">
    筛选好并查询完成后，点「导出当前查询结果」下载 xlsx：「沟通数据详情」导出「沟通数据导出.xlsx」，「坐席混合数据」导出「在线会话数据.xlsx」，成功后提示「导出成功」。

    规则：

    * 导出的是这次查询命中的全部记录，不只是当前页；
    * 只使用表格当前显示的这次查询结果：筛选改动过、还没查询、页面加载中或查询失败时，按钮不可点，先「搜索」或「重试查询」；
    * 缺值的字段在表格和文件里显示「-」。

    判断标准：浏览器完成下载并提示「导出成功」，文件名与所在 Tab 对应。
  </Step>
</Steps>

## 检查点

* 左侧「统计窗口」（以及部门管理员的「账号」）是你要查的范围；切换后表格会重新查询。
* 筛选条标签是「已应用筛选」，没有黄色「筛选条件已修改」提示。
* 范围行给出明确的起止日期与条数；翻页不改变它。
* 「导出当前查询结果」可以点击，并能下载到对应 Tab 的 xlsx。
* 点开某条问询，「消息处理链路」里能看到这一轮的参考知识或执行步骤。

<Warning>
  明细数据包含客户沟通内容。导出文件、截图或转发给他人之前，确认对方有权查看这些消息。
</Warning>

<Info>
  两个 Tab 口径不同：「沟通数据详情」只含 AI 与客户的对话；「坐席混合数据」还包含人工坐席的消息。同一段时间两边条数对不上是正常的，不要混在一起统计或对比。
</Info>

<Tip>
  在明细数据里改动筛选不会影响业务表现。
</Tip>

## 常见问题

### 改了筛选条件，表格为什么没变？

表格显示的是最近一次成功查询的结果，改动筛选不会自动刷新。点「搜索」（或在筛选框里按回车）才会重新查询；改动后会出现「待查询的筛选条件」标签和黄色提示「筛选条件已修改。请先查询，随后才能导出与表格一致的结果。」。

### 「导出当前查询结果」为什么点不了？

三种常见原因：页面还在加载、筛选改动过还没点「搜索」、上次查询失败（有红色提示条）。对应处理：等加载结束、点「搜索」、点「重试查询」。导出按钮只在表格展示的查询结果可导出时才会亮。

### 导出的文件里有几条记录？是当前页吗？

是这次查询命中的全部记录，不是当前页。先在范围行确认「共 N 条」再导出；「每页条数」只影响屏幕上表格的显示。

### 同一段时间，两个 Tab 的记录为什么对不上？

口径不同：「沟通数据详情」只含 AI 对话，「坐席混合数据」包含人工坐席的消息，两边可用的筛选条件也不一样（用户/群/意图分类 与 会话ID/消息类型）。它们服务于不同的核对目的，不要互相求差。

### 为什么有的记录打不开「消息处理链路」？

「用户问询」为空的记录（单元格显示「-」）不能点开。面板打开后，如果这条记录缺少消息 ID，会提示「当前沟通记录缺少消息 ID，无法按附件接口查询 agent 链路日志。」；如果这轮没有关联到可展示的知识，参考知识区显示「暂无参考知识」。这两种情况下可以改看「执行步骤」里能还原出的阶段，或在 [知识管理](/cn/guide/knowledge/management) 里补充相关知识。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.