获取 AI 助手会话记录
使用此端点从你的文档中导出 AI 助手的会话历史。每个会话都包括用户查询、助手回复、引用的来源、解决状态以及查询类别。
使用响应中返回的 cursor 参数对结果进行分页。当 hasMore 为 true 时继续获取。
使用 dateFrom 和 dateTo 参数按日期范围过滤会话。
每一行代表会话中的一个用户轮次。包含多轮往返的会话会生成多行,这些行共享同一个 conversationId。
每行包含:
- query: 用户的问题。
- response: AI 助手的回答。对于澄清问题轮次,这是 AI 助手向用户提出的追问。
- responseType:
answer或clarifying_question。clarifying_question表示 AI 助手向用户提出了追问,而没有直接作答。当该字段不存在时,默认值为answer。 - sources: 回答中引用的页面,包括标题和 URL。
- resolutionStatus: AI 助手是否成功回答了该轮次。值为
answered或unanswered。按行计算,因此同一个会话可能同时包含这两种状态。使用此字段可跟踪并分析 AI 助手无法解答的用户问题所暴露出的文档缺口。 - timestamp: 用户发送开启该轮次消息的时间。同一会话中的各行具有不同的时间戳。
- queryCategory: query 的类型分类(如果可用)。
- pageUrl: 会话开始时所在文档页面的完整 URL;如果没有可用的页面路径,则为
null。使用此字段可将会话归因到具体页面。
此端点允许每个组织每小时最多 100 次请求。所有分析端点共享此限制。
Was this page helpful?Suggest editsRaise issue