Skip to content
Mintlify
Mintlify
数据分析

获取 AI 助手会话记录

GET/v1/analytics/{projectId}/assistant

使用此端点从你的文档中导出 AI 助手的会话历史。每个会话都包括用户查询、助手回复、引用的来源、解决状态以及查询类别。

使用响应中返回的 cursor 参数对结果进行分页。当 hasMoretrue 时继续获取。

使用 dateFromdateTo 参数按日期范围过滤会话。

每一行代表会话中的一个用户轮次。包含多轮往返的会话会生成多行,这些行共享同一个 conversationId

每行包含:

  • query: 用户的问题。
  • response: AI 助手的回答。对于澄清问题轮次,这是 AI 助手向用户提出的追问。
  • responseType: answerclarifying_questionclarifying_question 表示 AI 助手向用户提出了追问,而没有直接作答。当该字段不存在时,默认值为 answer
  • sources: 回答中引用的页面,包括标题和 URL。
  • resolutionStatus: AI 助手是否成功回答了该轮次。值为 answeredunanswered。按行计算,因此同一个会话可能同时包含这两种状态。使用此字段可跟踪并分析 AI 助手无法解答的用户问题所暴露出的文档缺口。
  • timestamp: 用户发送开启该轮次消息的时间。同一会话中的各行具有不同的时间戳。
  • queryCategory: query 的类型分类(如果可用)。
  • pageUrl: 会话开始时所在文档页面的完整 URL;如果没有可用的页面路径,则为 null。使用此字段可将会话归因到具体页面。

此端点允许每个组织每小时最多 100 次请求。所有分析端点共享此限制。

Was this page helpful?Suggest editsRaise issue