AI 聊天

每个 Jamdesk 站点都内置聊天助手，可根据文档回答访客的问题。它会找到相关章节并将其发送给 Claude。回答会以流式方式返回，并附上源页面链接。所有套餐默认启用聊天功能，无需额外付费。

聊天助手的实际效果如下：

使用场景

工作原理

功能

屏幕截图显示的是英文界面。

配置

聊天功能无需配置。只有在需要更改推荐问题、重命名按钮、更改图标或关闭聊天功能时，才需要在 docs.json 中添加 chat 配置块。所有设置都有默认值。

{
  "chat": {
    "enabled": true,
    "starterQuestions": [
      "How do I get started?",
      "What API endpoints are available?"
    ]
  }
}

推荐问题

推荐问题是在访客输入内容前显示在聊天面板中的一键提示。如果 docs.json 中没有 starterQuestions，Jamdesk 会在每次构建时根据文档生成推荐问题。文档内容更新时，推荐问题也会随之更新。

在 starterQuestions 数组中列出自定义问题。你可以借此优先展示支持团队经常收到的问题：

{
  "chat": {
    "starterQuestions": [
      "How do notifications work?",
      "Tell me more about analytics"
    ]
  }
}

最多可设置 4 个推荐问题，每个问题为 5 至 200 个字符。将 starterQuestions 设为空数组（[]）即可不显示问题。

自定义名称和图标

聊天按钮、面板标题和搜索快捷入口默认显示“Ask AI”，并使用闪光图标。设置 label 和 icon 即可根据产品自定义：

{
  "chat": {
    "label": "Acme Assistant",
    "icon": "/images/assistant.svg"
  }
}

站点的所有语言都会使用相同的标签。像 robot 这样的 icon 值是 Font Awesome 图标名称。以 http://、https:// 或 / 开头，或以图片扩展名结尾的值会被视为图片。

关闭聊天

所有套餐默认启用聊天功能。将 enabled 设为 false 即可关闭。此设置会移除 Ask AI 按钮、聊天面板以及 Cmd+I / Ctrl+I 快捷键：

{
  "chat": {
    "enabled": false
  }
}

限制

聊天功能可用于自定义域名。/_chat 端点与站点同源，适用于任何提供文档内容的域名。

接下来呢？