> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 助手

> 帮助用户更好地使用你的产品，并更快找到答案

<Info>
  AI 助手会在 [Pro 和 Custom 方案](https://mintlify.com/pricing?ref=assistant)中自动启用。
</Info>

<div id="about-the-assistant">
  ## 关于 AI 助手
</div>

AI 助手通过自然语言 query 回答与你的文档相关的问题。它直接嵌入到你的文档站点中，为用户提供即时的上下文帮助。

AI 助手采用具备工具调用的 agentic RAG（检索增强生成），由 Claude Sonnet 4 提供支持。当用户提问时，AI 助手会：

* **搜索并检索** 你的文档中的相关内容，提供准确答案。
* **引用出处** 并提供可导航的链接，直接带用户前往被引用的页面。
* **生成可复制的代码示例**，帮助用户根据你的文档实现解决方案。

发送给 AI 助手的每条消息都会计入你的套餐消息额度。若超出额度，额外消息将产生超额费用。你可以设置支出上限，或在达到额度时禁用 AI 助手。

你可以在控制台查看 AI 助手的使用情况，从而了解用户行为和文档效果。导出并分析 query 数据，以帮助识别：

* 可能需要更充分覆盖的常见问题。
* 用户难以找到答案的内容空白。
* 适合补充更多内容的热门主题。

<div id="configuring-the-assistant">
  ## 配置 AI 助手
</div>

AI 助手在 Pro 和 Custom 方案中默认启用。你可以在[控制台](https://dashboard.mintlify.com/products/assistant/settings)管理 AI 助手，包括启用或禁用、配置响应处理，以及设置支出上限。

<div id="assistant-status">
  ### AI 助手状态
</div>

切换 AI 助手状态，以在你的文档站点上启用或禁用 AI 助手。

<div id="assistant-deflection">
  ### AI 助手分流
</div>

启用 AI 助手在无法解答时将问题转交给你的支持团队。提供一个电子邮箱地址，AI 助手在无法回答用户提问时会将该地址提供给用户。

<div id="search-sites">
  ### 搜索站点
</div>

<Note>
  站点搜索目前为测试版。要为你的文档站点启用该功能，请[联系销售团队](mailto:gtm@mintlify.com)。
</Note>

配置 AI 助手在回答问题时可检索的站点，以获取更多上下文。

* 站点必须对公众可访问。
* 需要 JavaScript 才能加载内容的站点不受支持。

在配置外部站点时，你可以使用以下过滤语法：

* **域级过滤**
  * `example.com`：仅搜索 `example.com` domain
  * `docs.example.com`：仅搜索 `docs.example.com` 子域
  * `*.example.com`：搜索 `example.com` 的所有子域
* **路径级过滤**
  * `docs.example.com/api`：搜索 `/api` 子路径下的所有页面
* **多重模式**
  * 可添加多个条目以覆盖站点的不同部分

<div id="spend-limit">
  ### 支出上限
</div>

设置支出上限，以控制在达到消息配额时的处理方式。默认情况下，即使你已用尽消息配额，AI 助手仍会继续回答用户问题，从而产生超额费用。

在 [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings) 页面的 **Billing** 标签页中，你可以为超出配额的 AI 助手消息设置支出上限。当达到支出上限时，AI 助手将被禁用，直到你的消息配额重置。

你还可以设置用量提醒，在达到支出上限的指定百分比时接收电子邮件通知。

<div id="using-the-assistant">
  ## 使用 AI 助手
</div>

用户可以通过三种方式使用 AI 助手：

* **键盘快捷键**：<kbd>Command</kbd> + <kbd>I</kbd>（Windows 上为 <kbd>Ctrl</kbd> + <kbd>I</kbd>）
* 搜索栏旁边的 **Assistant 按钮**
  <img
    src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/assistant/assistant-button-light.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=2af18c57a073a649e400843fde9b6e28"
    className="block dark:hidden rounded-2xl border border-gray-100 shadow-lg"
    style={{
  width: '268px',
  height: 'auto',
  }}
    alt="浅色模式下的搜索栏和助手按钮。"
    width="1806"
    height="322"
    data-path="images/assistant/assistant-button-light.png"
  />
  <img
    src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/assistant/assistant-button-dark.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=694ca50585c28c8551990636d7ace5ee"
    className="hidden dark:block rounded-2xl border border-white/10 shadow-lg"
    style={{
  width: '268px',
  height: 'auto',
  }}
    alt="深色模式下的搜索栏和助手按钮。"
    width="1806"
    height="324"
    data-path="images/assistant/assistant-button-dark.png"
  />
* 在 **URL** 末尾添加 `?assistant=open`，页面加载时会自动打开 AI 助手。例如，[https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open)。

上述任一方式都会在文档右侧打开聊天面板。用户可以提出任何问题，AI 助手会在你的文档中搜索答案；如果未找到相关信息，AI 助手会提示无法回答该问题。

<div id="making-content-ai-ingestible">
  ## 让内容便于 AI 读取与理解
</div>

组织你的文档，以帮助 AI 助手提供准确、相关的答案。清晰的结构与完善的上下文同时有利于读者和 AI 的理解。

<Card title="结构与组织">
  * 使用语义化标记。
  * 为各部分撰写具有描述性的标题。
  * 建立清晰、合理的信息层级。
  * 在文档中保持一致的格式。
  * 在页面 frontmatter 中包含完整的 metadata。
  * 将长文本拆分为更短的段落。
</Card>

<Card title="上下文">
  * 首次出现时定义特定术语和首字母缩略词。
  * 提供关于功能与流程的充分概念性内容。
  * 包含示例和用例。
  * 交叉引用相关主题。
  * 添加包含额外上下文的[隐藏页面](/zh/guides/hidden-pages)，这些内容用户不需要，但 AI 助手可以引用。
</Card>

<div id="exporting-and-analyzing-queries">
  ## 导出与分析查询
</div>

在控制台中审阅并导出查询，以了解用户如何与文档交互并识别改进机会。通过分析查询，你可以：

* 识别高频查询却答案不足的内容缺口。
* 从查询中的主题与模式中发现用户行为规律和常见信息需求。
* 为高流量页面的准确性与质量提升设定优先级。

你可以在[控制台](https://dashboard.mintlify.com/products/assistant)中查看查询，但为了获得更深入的洞察，建议导出包含查询、回复和来源的 `CSV` 文件，并用你偏好的 AI 工具进行分析。

1. 在控制台前往 [AI 助手页面](https://dashboard.mintlify.com/products/assistant)。
2. 选择 **Export to CSV**。
3. 使用你偏好的工具分析导出的数据。

<Card title="示例分析提示">
  * 概括查询中最常见的主题。
  * 列出未引用任何来源的查询。
  * 找出未成功交互中的模式。
</Card>