mintlify__docs/zh/api/analytics/assistant-conversations.mdx

---
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 的类型分类（如果可用）