> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置 AI 助手

> 在 Mintlify 仪表盘中配置 AI 助手：切换可用性、自定义响应、添加示例问题、设置机器人防护并管理计费。

在仪表盘的 [Assistant](https://dashboard.mintlify.com/products/assistant) 页面配置 AI 助手。在[用量](https://dashboard.mintlify.com/settings/organization/usage)页面管理计费和用量。

<div id="enable-or-disable-the-assistant">
  ## 启用或禁用 AI 助手
</div>

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

<Frame>
  <img src="https://mintcdn.com/mintlify/qxFvxlkWYrjV0OaV/images/assistant/status-light.png?fit=max&auto=format&n=qxFvxlkWYrjV0OaV&q=85&s=723881f19ac3ad665a774eeb6f3b8652" alt="仪表盘中的 AI 助手状态开关。" className="block dark:hidden" width="2038" height="338" data-path="images/assistant/status-light.png" />

  <img src="https://mintcdn.com/mintlify/qxFvxlkWYrjV0OaV/images/assistant/status-dark.png?fit=max&auto=format&n=qxFvxlkWYrjV0OaV&q=85&s=8c7ae23c57d3db8f67a649b0f09d45c4" alt="仪表盘中的 AI 助手状态开关。" className="hidden dark:block" width="2040" height="338" data-path="images/assistant/status-dark.png" />
</Frame>

<div id="set-deflection-email">
  ## 设置转接邮箱
</div>

在"响应处理"部分，启用 AI 助手将无法回答的问题重定向到你的支持团队。

指定一个电子邮件地址，当 AI 助手无法回答用户的问题时，将此地址提供给用户。你还可以启用一个"联系支持"按钮，使其出现在 AI 助手的聊天面板中。

<Frame>
  <img src="https://mintcdn.com/mintlify/RnZ31raTBKoRr5sX/images/assistant/deflection-light.png?fit=max&auto=format&n=RnZ31raTBKoRr5sX&q=85&s=d63b7b91381f5f2ca86790610fe4337b" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="block dark:hidden" width="1096" height="564" data-path="images/assistant/deflection-light.png" />

  <img src="https://mintcdn.com/mintlify/RnZ31raTBKoRr5sX/images/assistant/deflection-dark.png?fit=max&auto=format&n=RnZ31raTBKoRr5sX&q=85&s=f422e292dd30a1a3a488048ba176dddd" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="hidden dark:block" width="1098" height="566" data-path="images/assistant/deflection-dark.png" />
</Frame>

<div id="search-domains">
  ## 搜索域名
</div>

在"响应处理"部分，配置 AI 助手可以用于网络搜索的域名，以在回答问题时查找额外的上下文。

* 域名必须是公开可访问的。
* 不支持需要 JavaScript 加载的域名。

<Frame>
  <img src="https://mintcdn.com/mintlify/2qBICQFhOKqkes42/images/assistant/search-domains-light.png?fit=max&auto=format&n=2qBICQFhOKqkes42&q=85&s=a15d483e0eee1b9a55a8ff6583a7d331" alt="仪表盘中已启用的 AI 助手搜索域名面板。AI 助手已配置为搜索 mintlify.com/pricing 域名。" className="block dark:hidden" width="838" height="624" data-path="images/assistant/search-domains-light.png" />

  <img src="https://mintcdn.com/mintlify/2qBICQFhOKqkes42/images/assistant/search-domains-dark.png?fit=max&auto=format&n=2qBICQFhOKqkes42&q=85&s=ae032b581c467630c044b073b583dded" alt="仪表盘中已启用的 AI 助手搜索域名面板。AI 助手已配置为搜索 mintlify.com/pricing 域名。" className="hidden dark:block" width="838" height="626" data-path="images/assistant/search-domains-dark.png" />
</Frame>

要更精确地控制 AI 助手的搜索范围，请使用过滤语法。

* **域名级别过滤**
  * `example.com`：仅在 `example.com` 域名搜索
  * `docs.example.com`：仅在 `docs.example.com` 子域名搜索
  * `*.example.com`：在 `example.com` 的所有子域名搜索
* **路径级别过滤**
  * `docs.example.com/api`：搜索 `/api` 子路径下的所有页面
* **多种模式**
  * 添加多个条目以定位不同站点的不同部分

<div id="add-sample-questions">
  ## 添加示例问题
</div>

通过添加示例问题帮助用户开始与 AI 助手的对话。

AI 助手可以根据用户正在查看的页面生成特定于页面的问题，你也可以添加在所有页面上都可用的固定问题。

你最多可以添加三个示例问题。点击 **询问助手** 获取基于你文档的推荐问题。

<Frame>
  <img src="https://mintcdn.com/mintlify/EiZZRANO0gpyj8zb/images/assistant/search-suggestions-light.png?fit=max&auto=format&n=EiZZRANO0gpyj8zb&q=85&s=495b7577e5819458c1e88d0d2ef26bdc" alt="仪表盘中的搜索建议面板，已启用上下文相关的示例问题。" className="block dark:hidden" width="2040" height="502" data-path="images/assistant/search-suggestions-light.png" />

  <img src="https://mintcdn.com/mintlify/EiZZRANO0gpyj8zb/images/assistant/search-suggestions-dark.png?fit=max&auto=format&n=EiZZRANO0gpyj8zb&q=85&s=1a64cde0be2914849cbf6bcf3b9d0381" alt="仪表盘中的搜索建议面板，已启用上下文相关的示例问题。" className="hidden dark:block" width="2040" height="504" data-path="images/assistant/search-suggestions-dark.png" />
</Frame>

<div id="bot-protection">
  ## 机器人防护
</div>

在"机器人防护"部分，启用隐形验证码以保护你的 AI 助手免受自动化滥用。机器人防护注重隐私保护，对几乎所有访客不可见。

要启用机器人防护：

1. 在仪表盘中进入 [AI 助手设置](https://dashboard.mintlify.com/products/assistant/settings)页面。
2. 在 **Bot Protection** 部分，开启 **Invisible Captcha**。

更改最多需要 10 分钟才能生效。

<Note>
  如果你使用自定义的 [Content Security Policy 头](/zh/deploy/csp-configuration)，你必须在允许列表中包含 `hcaptcha.com` 和 `*.hcaptcha.com`。
</Note>

<div id="manage-billing">
  ## 管理计费
</div>

AI 助手使用套餐，每月按消息配额计算。一条消息指用户与 AI 助手的任何交互，只要收到了正确的响应即算一条。

默认情况下，超额使用是禁用的。禁用超额后，一旦达到消息配额上限，AI 助手将不可用，直到配额重置后才会恢复。你可以启用超额，以便在用完套餐配额后继续使用 AI 助手。如果启用超额，超出配额的每条消息会产生超额费用，但根据你的使用情况，偶尔的超额可能比升级到更高套餐更便宜。

### 在 Hobby 计划上启用 AI 助手

如果你使用的是 Hobby 计划，可以通过购买积分包将 AI 助手添加到你的站点，而无需升级到 Pro。购买完成后 AI 助手即被启用，并在你拥有有效积分包期间持续生效。

在 Hobby 计划下购买积分包：

1. 前往仪表盘的[用量](https://dashboard.mintlify.com/settings/organization/usage)页面。
2. 在 **Credit packages** 部分，从下拉菜单中选择一个套餐。
3. 确认更改后，你将被重定向到结账页面。

如需停用 AI 助手，请将积分包降级到最低档。你的计划会恢复为 Hobby，AI 助手将在当前计费周期结束时停用。

<div id="change-your-assistant-tier">
  ### 更改 AI 助手套餐
</div>

套餐决定你的月度消息配额和定价。

在仪表盘的[用量](https://dashboard.mintlify.com/settings/organization/usage)页面查看和更改你当前的套餐。你也可以在计费页面上选择 **Billing portal** 旁边的 **View usage** 进入用量页面。

在 **Message packages** 部分（基于积分的助手为 **Credit packages**），从下拉菜单中选择你首选的套餐。

**升级套餐：**

* 你的新消息配额立即生效。
* 你需要支付当前计费周期的按比例差额。

**降级套餐：**

* 你的消息配额立即更新。
* 价格变更在下一个计费周期开始时生效。
* 当前套餐的未使用消息**不会**结转。

<div id="allow-overages">
  ### 允许超额
</div>

默认情况下超额是禁用的。如需允许超额，请在仪表盘[用量](https://dashboard.mintlify.com/settings/organization/usage)页面的 **Billing controls** 部分启用超额。

<div id="set-usage-alerts">
  ### 设置用量提醒
</div>

在 **Billing controls** 部分，设置用量提醒，当达到消息配额的一定百分比时接收电子邮件通知。


## Related topics

- [创建知识库](/zh/guides/knowledge-base.md)
- [AI 原生文档](/zh/ai-native.md)
- [AI 助手](/zh/assistant/index.md)