mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
fed930aa2d
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
38 lines
1.4 KiB
Plaintext
38 lines
1.4 KiB
Plaintext
---
|
||
title: "获取 AI 助手会话记录"
|
||
openapi: /zh/analytics.openapi.json GET /v1/analytics/{projectId}/assistant
|
||
keywords: [ "analytics", "assistant", "conversations", "export", "AI" ]
|
||
---
|
||
|
||
<div id="usage">
|
||
## 使用方法
|
||
</div>
|
||
|
||
使用此端点从你的文档中导出 AI 助手的会话历史。每个会话都包括用户查询、助手回复、引用的来源、解决状态以及查询类别。
|
||
|
||
使用响应中返回的 `cursor` 参数对结果进行分页。当 `hasMore` 为 `true` 时继续获取。
|
||
|
||
<div id="filtering">
|
||
## 筛选
|
||
</div>
|
||
|
||
使用 `dateFrom` 和 `dateTo` 参数按日期范围过滤会话。
|
||
|
||
<div id="conversation-data">
|
||
## 会话数据
|
||
</div>
|
||
|
||
每个会话包含：
|
||
|
||
- **query**: 用户的问题
|
||
- **response**: AI 助手的回答
|
||
- **sources**: 回答中引用的页面，包括标题和 URL
|
||
- **resolutionStatus**: AI 助手是否成功回答了问题。值为 `answered` 或 `unanswered`。使用此字段可跟踪并分析 AI 助手无法解答的用户问题所暴露出的文档缺口。
|
||
- **queryCategory**: query 的类型分类（如果可用）
|
||
- **pageUrl**: 会话开始时所在文档页面的完整 URL；如果没有可用的页面路径，则为 `null`。使用此字段可将会话归因到具体页面。
|
||
|
||
<div id="rate-limits">
|
||
## 速率限制
|
||
</div>
|
||
|
||
此端点允许每个组织每小时最多 100 次请求。所有分析端点共享此限制。 |