跳转到主要内容
AI 助手只根据你已发布的文档和 API 规范以及你添加的搜索域名作答。当你发布更改时，AI 助手会立即索引新增、更新或删除的内容。它不会索引草稿分支或预览部署。 要改进回答，请找出 AI 助手无法回答的问题，然后修正它作答所依据的内容。使用自定义指令和 skills 来调整它的回答方式。

​
找出 AI 助手无法回答的问题

AI 助手分析中的 Unanswered conversations 列表会显示 AI 助手无法根据你的文档回答的所有对话。打开一份对话记录，查看用户问了什么，然后添加或更新能回答该问题的内容。

​
添加用户看不到的上下文

默认情况下，AI 助手不会索引隐藏页面。要在 AI 助手的索引中包含隐藏页面，请在 docs.json 中设置 seo.indexing: "all"。将隐藏页面用于用户无需浏览、但 AI 助手可以参考的上下文。请参阅隐藏页面，了解每种页面设置如何影响 AI 助手。 要在已发布的页面上只向 AI 助手和其他 AI 工具展示上下文，请用 Visibility 组件并设置 for="agents" 将其包裹。

​
从回答中排除内容

要让某个可见页面不出现在 AI 助手的回答中，请在该页面的 frontmatter 中设置 searchable: false。该页面仍保留在导航中，但站点搜索和 AI 助手会跳过它。其他选项请参阅隐藏页面。

​
按用户组限制回答

如果你的站点需要身份验证，AI 助手会遵循用户组设置。它只根据每位已登录用户可以访问的页面为其作答。

​
搜索域名

搜索域名需要 Enterprise 套餐。
在”响应处理”部分，配置 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 助手的回答效果最好。清晰的组织结构和完整的上下文对人和 AI 工具都有帮助。
  • 为每个页面编写描述性的标题和具体的 frontmatter 描述。
  • 在首次引入术语和缩写时给出定义。
  • 提供示例和使用场景，并链接相关主题。
  • 将较长的文本块拆分为较短的段落。