# 配置 AI 助手 (/zh/assistant/configure)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 1018 · updated: 2026-07-30 -->
Related: [自定义 AI 助手行为](/zh/assistant/customize.md), [Mintlify 小组件](/zh/assistant/widget.md), [添加 assistant skills](/zh/assistant/skills.md), [使用 AI 助手](/zh/assistant/use.md), [安全联系人](/zh/dashboard/security-contact.md)

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

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

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

<Frame>
  <img src="/_assets/632f92922de18447ebcc227f0630628d296bdb94757171857e7fa29ad3f75431" alt="仪表盘中的 AI 助手状态开关。" className="block dark:hidden" />

  <img src="/_assets/86e1904abc43cc57f77dcede836052183b398ced4c7450aba28076e9c9951dce" alt="仪表盘中的 AI 助手状态开关。" className="hidden dark:block" />
</Frame>

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

在"响应处理"部分，启用 AI 助手，让它在无法自行回答问题时引导用户联系你的支持团队和销售团队。

填写以下任一或两个地址：

* **支持**：AI 助手无法根据文档解答的问题。
* **销售**：与定价、套餐或购买相关的问题。

当你启用转接且 AI 助手检测到匹配的问题时，聊天面板中会出现一个联系表单。该表单会向用户询问名字、姓氏、公司、公司邮箱和一条消息。Mintlify 会通过电子邮件将提交内容发送给对应的团队，该团队可以直接回复用户的邮箱。

嵌入到其他站点的 [assistant widget](/zh/assistant/widget) 中也提供同一联系表单，无需额外的 widget 配置。

如果你希望将支持类问题引导至现有的支持渠道，请在“响应处理”部分关闭 **显示联系表单**。当联系表单关闭时，AI 助手会以纯文本形式将用户引导至你的支持邮箱地址，而不再显示聊天面板中的表单。当已配置销售邮箱时，销售类问题仍会使用聊天面板中的表单。此设置默认开启。

<Frame>
  <img src="/_assets/c5166c0fcb9cad96b40e79699d6a88335ecb6d002febed2c5a1be57728b686a2" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="block dark:hidden" />

  <img src="/_assets/f1b571fb2a5ad57d9f46ca986a78ba17e158ce630effb5e618869e29b817c74c" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="hidden dark:block" />
</Frame>

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

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

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

<Frame>
  <img src="/_assets/19f2da38f6a17e1873a20f9569215a61437eb6657c2b89684a12286cc9a4292d" alt="仪表盘中已启用的 AI 助手搜索域名面板。AI 助手已配置为搜索 mintlify.com/pricing 域名。" className="block dark:hidden" />

  <img src="/_assets/3e59341e82512a6800c086a24a22f6b21b6d1d88f41441418e0875f1103209ee" alt="仪表盘中已启用的 AI 助手搜索域名面板。AI 助手已配置为搜索 mintlify.com/pricing 域名。" className="hidden dark:block" />
</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="/_assets/8a9b44f3abfbdf7617c88300a233423f11eecda6482be02e8a1b0c6899493bc5" alt="仪表盘中的搜索建议面板，已启用上下文相关的示例问题。" className="block dark:hidden" />

  <img src="/_assets/5578dfaaeaeb591f7e3f2494ea3af262a310d42aca3a2aa0099d865c4b03b2cf" alt="仪表盘中的搜索建议面板，已启用上下文相关的示例问题。" className="hidden dark:block" />
</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 助手使用积分。每条助手消息都会消耗积分，一条消息指用户与助手的任何交互，只要收到了响应即算一条。更多信息请参阅[积分定价](/zh/credits)。

<div id="change-your-credit-tier">
  ### 更改你的积分等级 [#更改你的积分等级]
</div>

1. 前往仪表盘的[用量](https://app.mintlify.com/settings/organization/usage)页面。
2. 在 **Credit packages** 部分，从下拉菜单中选择一个等级。
3. 确认更改以继续结账。

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

积分在你的组织内共享，但超额需要按每个部署单独配置。默认情况下，Mintlify 禁用超额。当某个部署禁用超额时，一旦组织的共享积分余额用尽，该部署上的 AI 助手将不可用，直到余额重置后才会恢复。

如需允许超额，请在仪表盘[用量](https://app.mintlify.com/settings/organization/usage)页面的 **Spending controls** 部分启用超额。如果启用超额，超出共享余额的每个积分都会产生超额费用。

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

在仪表盘的 **Spending controls** 部分，设置用量提醒，当你的组织达到其共享积分余额的一定百分比时，会收到电子邮件通知。

<div id="higher-credit-volumes">
  ### 更高的积分用量 [#更高的积分用量]
</div>

如果每月 10,000 个积分不够用，请[联系销售](mailto:sales@mintlify.com)以讨论定制积分套餐。