配置 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 助手将不可用，直到消息配额重置。如果允许超额，超出配额的每条消息会产生超额费用，但根据你的使用情况，偶尔的超额可能比升级到更高套餐更便宜。

​

查看用量明细

仪表盘的用量页面会按 AI 功能分解你的积分消耗，便于你了解积分花在了哪里，并排查使用高峰。

• Daily consumption 图表：按产品（Assistant、Agent、Workflows、MCP 和 Others）分类的每日积分使用量堆叠柱状图。各产品的总计显示在图表下方的图例中，并附上各自占总积分使用量的百分比。
• 日期范围：可在 Last 7 days、Last 30 days、Last 90 days 和 Last 12 months 之间切换，以调整图表的时间窗口。
• 产品筛选：选择 All products 比较所有产品，或选择单个产品（Assistant、Agent、Workflows、MCP 或 Others）以仅聚焦该产品。
• Activity log：所有 AI 功能消耗积分的事件按时间排列的列表。每行显示时间戳、产品和来源（例如 Web chat、Slack agent 或 Workflow）以及消耗的积分数。选择 Load more 加载更早的事件。

​

更改 AI 助手套餐

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

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

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

升级套餐：

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

降级套餐：

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

​

允许超额

如果你不想允许超额，请在仪表盘用量页面的 Billing controls 部分禁用超额。

​

设置用量提醒

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