跳转到主要内容
AI 助手会在 Pro 和 Custom 方案中自动启用。

​
关于 AI 助手

AI 助手通过自然语言 query 回答与你的文档相关的问题。它直接嵌入到你的文档站点中，为用户提供即时的上下文帮助。 AI 助手采用具备工具调用的 agentic RAG（检索增强生成），由 Claude Sonnet 4 提供支持。当用户提问时，AI 助手会：
  • 搜索并检索 你的文档中的相关内容，提供准确答案。
  • 引用出处 并提供可导航的链接，直接带用户前往被引用的页面。
  • 生成可复制的代码示例，帮助用户根据你的文档实现解决方案。
发送给 AI 助手的每条消息都会计入你的套餐消息额度。若超出额度，额外消息将产生超额费用。你可以设置支出上限，或在达到额度时禁用 AI 助手。 你可以在控制台查看 AI 助手的使用情况，从而了解用户行为和文档效果。导出并分析 query 数据，以帮助识别：
  • 可能需要更充分覆盖的常见问题。
  • 用户难以找到答案的内容空白。
  • 适合补充更多内容的热门主题。

​
配置 AI 助手

AI 助手在 Pro 和 Custom 方案中默认启用。你可以在控制台管理 AI 助手，包括启用或禁用、配置响应处理，以及设置支出上限。

​
AI 助手状态

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

​
AI 助手分流

启用 AI 助手在无法解答时将问题转交给你的支持团队。提供一个电子邮箱地址，AI 助手在无法回答用户提问时会将该地址提供给用户。

​
搜索站点

站点搜索目前为测试版。要为你的文档站点启用该功能，请联系销售团队。
配置 AI 助手在回答问题时可检索的站点，以获取更多上下文。
  • 站点必须对公众可访问。
  • 需要 JavaScript 才能加载内容的站点不受支持。
在配置外部站点时，你可以使用以下过滤语法：
  • 域级过滤
    • example.com：仅搜索 example.com domain
    • docs.example.com：仅搜索 docs.example.com 子域
    • *.example.com：搜索 example.com 的所有子域
  • 路径级过滤
    • docs.example.com/api：搜索 /api 子路径下的所有页面
  • 多重模式
    • 可添加多个条目以覆盖站点的不同部分

​
支出上限

设置支出上限，以控制在达到消息配额时的处理方式。默认情况下，即使你已用尽消息配额，AI 助手仍会继续回答用户问题，从而产生超额费用。 在 Assistant Configurations 页面的 Billing 标签页中，你可以为超出配额的 AI 助手消息设置支出上限。当达到支出上限时，AI 助手将被禁用，直到你的消息配额重置。 你还可以设置用量提醒，在达到支出上限的指定百分比时接收电子邮件通知。

​
使用 AI 助手

用户可以通过三种方式使用 AI 助手：
  • 键盘快捷键：Command + I（Windows 上为 Ctrl + I）
  • 搜索栏旁边的 Assistant 按钮 浅色模式下的搜索栏和助手按钮。
  • 在 URL 末尾添加 ?assistant=open，页面加载时会自动打开 AI 助手。例如，https://mintlify.com/docs?assistant=open。
上述任一方式都会在文档右侧打开聊天面板。用户可以提出任何问题，AI 助手会在你的文档中搜索答案；如果未找到相关信息，AI 助手会提示无法回答该问题。

​
让内容便于 AI 读取与理解

组织你的文档，以帮助 AI 助手提供准确、相关的答案。清晰的结构与完善的上下文同时有利于读者和 AI 的理解。

结构与组织

  • 使用语义化标记。
  • 为各部分撰写具有描述性的标题。
  • 建立清晰、合理的信息层级。
  • 在文档中保持一致的格式。
  • 在页面 frontmatter 中包含完整的 metadata。
  • 将长文本拆分为更短的段落。

上下文

  • 首次出现时定义特定术语和首字母缩略词。
  • 提供关于功能与流程的充分概念性内容。
  • 包含示例和用例。
  • 交叉引用相关主题。
  • 添加包含额外上下文的隐藏页面，这些内容用户不需要，但 AI 助手可以引用。

​
导出与分析查询

在控制台中审阅并导出查询，以了解用户如何与文档交互并识别改进机会。通过分析查询，你可以：
  • 识别高频查询却答案不足的内容缺口。
  • 从查询中的主题与模式中发现用户行为规律和常见信息需求。
  • 为高流量页面的准确性与质量提升设定优先级。
你可以在控制台中查看查询，但为了获得更深入的洞察，建议导出包含查询、回复和来源的 CSV 文件，并用你偏好的 AI 工具进行分析。
  1. 在控制台前往 AI 助手页面。
  2. 选择 Export to CSV。
  3. 使用你偏好的工具分析导出的数据。

示例分析提示

  • 概括查询中最常见的主题。
  • 列出未引用任何来源的查询。
  • 找出未成功交互中的模式。
⌘I