数据分析
获取 AI 助手会话记录
返回分页后的 AI 助手会话历史
使用管理员 API 密钥进行身份验证。
GET
获取 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。使用此字段可将会话归因到具体页面。
速率限制
授权
查询参数
ISO 8601 或 YYYY-MM-DD 格式的日期
示例:
"2024-01-01"
ISO 8601 或 YYYY-MM-DD 格式的日期。dateTo 为不包含在内的上限。结果将包含早于该日期的记录,但不包含该日期当天的记录。
示例:
"2024-01-01"
每页返回的最大结果数
必填范围:
1 <= x <= 1000分页游标(ULID 格式)