配置 AI 助手

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

在仪表盘的 Assistant 页面配置 AI 助手。在用量页面管理计费和用量。

​

启用或禁用 AI 助手

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

​

设置转接邮箱

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

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

​

搜索域名

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

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

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

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

​

添加示例问题

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

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

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

​

机器人防护

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

要启用机器人防护：

1. 在仪表盘中进入 AI 助手设置页面。
2. 在 Bot Protection 部分，开启 Invisible Captcha。

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

如果你使用自定义的 Content Security Policy 头，你必须在允许列表中包含 hcaptcha.com 和 *.hcaptcha.com。

​

管理计费

AI 助手使用套餐，每月按消息配额计算。一条消息指用户与 AI 助手的任何交互，只要收到了正确的响应即算一条。如果你有未使用的消息，最多一半的消息配额可以结转到下一个计费周期。例如，如果你有 1,000 条消息配额并使用了 300 条，则 500 条消息会结转到下一个计费周期，使你在下一个计费周期共有 1,500 条消息。

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

​

在 Hobby 计划上启用 AI 助手

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

在 Hobby 计划下购买积分包：

1. 前往仪表盘的用量页面。
2. 在 Credit packages 部分，从下拉菜单中选择一个套餐。
3. 确认更改后，你将被重定向到结账页面。

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

​

更改 AI 助手套餐

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

在仪表盘的用量页面查看和更改你当前的套餐。你也可以在计费页面上选择 Billing portal 旁边的 View usage 进入用量页面。

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

升级套餐：

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

降级套餐：

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

​

允许超额

默认情况下超额是禁用的。如需允许超额，请在仪表盘用量页面的 Billing controls 部分启用超额。

​

设置用量提醒

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