配置 AI 助手

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

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

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

选择 邮箱 转接模式，然后填写以下任一或两个地址：

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

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

嵌入到其他站点的 assistant widget 中也提供同一联系表单。

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

将转接模式切换为 链接，将用户引导到你现有的支持平台（例如帮助中心、工单门户或社区论坛），而不是通过聊天面板中的表单收集邮箱。

输入你的支持目标的完整 URL。URL 必须使用 http 或 https，且不能包含凭据。

当 AI 助手检测到支持类问题时，会向用户显示一张带有你支持 URL 链接的卡片。Mintlify 会将 AI 助手会话线程 ID 作为 threadId 查询参数追加到该 URL，方便你的支持工具将会话转录附加到生成的工单。使用 获取 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 助手可以根据用户正在查看的页面生成特定于页面的问题，你也可以添加在所有页面上都可用的固定问题。

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

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

要启用机器人防护：

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

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

AI 助手使用积分。AI 助手每回答一个问题消耗 25 个积分。如果 AI 助手在你的文档中找不到答案并如实说明，该条消息不消耗积分。更多信息请参阅积分定价。

在 Enterprise 方案中，你可以使用自己的模型，通过你自己的 LLM 提供商和 API 密钥运行 assistant，此时用量按更低的积分费率计量。

1. 前往仪表盘的用量页面。
2. 在 Credit packages 部分，从下拉菜单中选择一个等级。
3. 确认更改以继续结账。

你的组织在各部署间共享积分。默认情况下，Mintlify 禁用超额。你可以为每个部署配置不同的超额上限。如果某个部署禁用了超额，当你用尽组织的共享积分余额后，该部署上的 AI 助手将不可用。AI 助手会一直不可用，直到积分余额重置。

如需允许超额，请在仪表盘用量页面的 Spending controls 部分启用超额。如果启用超额，超出共享余额的每个积分都会产生超额费用。

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

如果每月 10,000 个积分不够用，请联系销售以讨论定制积分套餐。