mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
ded3e13cd0
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
128 lines
6.0 KiB
Plaintext
128 lines
6.0 KiB
Plaintext
---
|
||
title: "配置 AI 助手"
|
||
description: "在 Mintlify 仪表盘中配置 AI 助手：切换可用性、自定义响应、添加示例问题、设置机器人防护并管理计费。"
|
||
keywords: ["assistant", "设置", "转接", "机器人防护", "计费"]
|
||
---
|
||
|
||
在仪表盘的 [Assistant](https://dashboard.mintlify.com/products/assistant) 页面配置 AI 助手并管理计费。
|
||
|
||
<div id="enable-or-disable-the-assistant">
|
||
## 启用或禁用 AI 助手
|
||
</div>
|
||
|
||
切换 AI 助手状态以在你的文档站点上启用或禁用 AI 助手。
|
||
|
||
<Frame>
|
||
<img src="/images/assistant/status-light.png" alt="仪表盘中的 AI 助手状态开关。" className="block dark:hidden" />
|
||
<img src="/images/assistant/status-dark.png" alt="仪表盘中的 AI 助手状态开关。" className="hidden dark:block" />
|
||
</Frame>
|
||
|
||
<div id="set-deflection-email">
|
||
## 设置转接邮箱
|
||
</div>
|
||
|
||
在"响应处理"部分，启用 AI 助手将无法回答的问题重定向到你的支持团队。
|
||
|
||
指定一个电子邮件地址，当 AI 助手无法回答用户的问题时，将此地址提供给用户。你还可以启用一个"联系支持"按钮，使其出现在 AI 助手的聊天面板中。
|
||
|
||
<Frame>
|
||
<img src="/images/assistant/deflection-light.png" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="block dark:hidden" />
|
||
<img src="/images/assistant/deflection-dark.png" alt="仪表盘中的 AI 助手转接面板。AI 助手转接已开启，support@mintlify.com 设置为转接邮箱。" className="hidden dark:block" />
|
||
</Frame>
|
||
|
||
<div id="search-domains">
|
||
## 搜索域名
|
||
</div>
|
||
|
||
在"响应处理"部分，配置 AI 助手可以用于网络搜索的域名，以在回答问题时查找额外的上下文。
|
||
|
||
- 域名必须是公开可访问的。
|
||
- 不支持需要 JavaScript 加载的域名。
|
||
|
||
<Frame>
|
||
<img src="/images/assistant/search-domains-light.png" alt="仪表盘中已启用的 AI 助手搜索域名面板。AI 助手已配置为搜索 mintlify.com/pricing 域名。" className="block dark:hidden" />
|
||
<img src="/images/assistant/search-domains-dark.png" 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 助手可以根据用户正在查看的页面生成特定于页面的问题，你也可以添加在所有页面上都可用的固定问题。
|
||
|
||
你最多可以添加三个示例问题。点击 **Ask AI** 获取基于你文档的推荐问题。
|
||
|
||
<Frame>
|
||
<img src="/images/assistant/search-suggestions-light.png" alt="仪表盘中的搜索建议面板，已启用上下文相关的示例问题。" className="block dark:hidden" />
|
||
<img src="/images/assistant/search-suggestions-dark.png" 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 助手使用分级消息配额。一条消息指用户与 AI 助手的任何交互，只要收到了正确的响应即算一条。如果你有未使用的消息，最多一半的消息配额可以结转到下一个计费周期。例如，如果你有 1,000 条消息配额并使用了 300 条，则 500 条消息会结转到下一个计费周期，使你在下一个计费周期共有 1,500 条消息。
|
||
|
||
默认情况下，AI 助手允许超额使用。你可以禁用超额以避免超出套餐的额外费用。如果禁用超额后达到消息配额上限，AI 助手将不可用，直到消息配额重置。如果允许超额，超出配额的每条消息会产生超额费用，但根据你的使用情况，偶尔的超额可能比升级到更高套餐更便宜。
|
||
|
||
<div id="change-your-assistant-tier">
|
||
### 更改 AI 助手套餐
|
||
</div>
|
||
|
||
AI 助手套餐决定你的月度消息配额和定价。
|
||
|
||
在仪表盘 AI 助手页面的[计费选项卡](https://dashboard.mintlify.com/products/assistant?tab=billing)中查看和更改你当前的套餐。
|
||
|
||
在 **Spending Controls** 部分，从下拉菜单中选择你首选的套餐。
|
||
|
||
**升级套餐：**
|
||
- 你的新消息配额立即生效。
|
||
- 你需要支付当前计费周期的按比例差额。
|
||
|
||
**降级套餐：**
|
||
- 你的消息配额立即更新。
|
||
- 价格变更在下一个计费周期开始时生效。
|
||
- 当前套餐的未使用消息**不会**结转。
|
||
|
||
<div id="allow-overages">
|
||
### 允许超额
|
||
</div>
|
||
|
||
如果你不想允许超额，请在仪表盘 AI 助手页面的[计费选项卡](https://dashboard.mintlify.com/products/assistant?tab=billing)中的 **Billing Controls** 部分禁用超额。
|
||
|
||
<div id="set-usage-alerts">
|
||
### 设置用量提醒
|
||
</div>
|
||
|
||
在 Billing Controls 部分，设置用量提醒，当达到消息配额的一定百分比时接收电子邮件通知。
|