AI 聊天
Docsbook AI 聊天是您文档网站上的一个聊天小部件，它根据文档的内容进行回答，而不是根据模型的记忆。读者提出问题，助手搜索您的页面，打开相关页面，并返回一个引用了所使用页面的答案。
Docsbook AI Chat 如何回答问题？#
Docsbook AI Chat 通过基于工具调用的检索增强生成 (RAG) 流程进行回答。模型决定何时调用每个工具，部件显示每个步骤的实时跟踪，因此读者可以看到答案来自哪个页面。
- 搜索 — 助手在您的文档中搜索相关部分。
- 阅读 — 它打开特定页面并引用所需的文本。
- 回答 — 它撰写响应并通过
streamdown将其流式传输给读者。
每次调用都会被记录，因此您可以稍后检查询问了什么，检索了什么，以及读者是否觉得答案有用。由于助手从您的索引页面中回答，原本会打开支持票的读者可以在页面上获得答案 — 而助手无法回答的问题则显示为记录的空白，而不是电子邮件。
Docsbook AI Chat 运行的成本是多少？#
Docsbook AI Chat 流式传输的每个答案都基于其所回答项目的余额。聊天中的其他内容不计入：托管小部件、提供页面和读者的搜索不计量。
聊天中有三件事消耗余额，它们是调用模型的三项：
- 对读者的回答。
- 构建或重建语义索引。
- 从聊天中启动的代理运行。
当前价格以及计划包含的内容在 Docsbook 定价页面 上 — 它是根据每个请求的实时计费常量生成的，因此是唯一值得引用的数字。当项目的余额用尽时，AI 聊天会暂停，而不是继续向您收费，小部件会显示这一点。
语义搜索#
语义搜索在第1步中用基于意义的检索替代了关键词匹配：您的文档的每个部分都被嵌入一次，然后Docsbook AI Chat即使在读者的措辞与页面的措辞不重叠时也能找到正确的段落。一个询问“为什么我的网站在推送后是空白的” 的读者会到达构建失败页面，而该页面从未使用“空白”这个词。
在 Float Widget → AI Chat 标签 → 语义搜索 中启用它。卡片是您操作它的地方：
- 切换 — 启用或禁用聊天的基于意义的检索。
- 实时同步 — 一旦索引存在，它会在每次提交文档时重新同步，因此您不必记得重建它。
- 最后更新 — 索引是否反映您当前的内容。
- 构建 / 重新构建 — 在运行之前显示成本估算，您可以取消的实时进度，以及运行后的令牌和成本。
构建索引会对您的整个语料库调用嵌入模型，这就是为什么在运行之前而不是之后显示估算的原因。您可以限制每个来源的支出 — 请参见语义索引限制。
自定义#
您可以控制聊天机器人的行为，而无需编写后端代码：
- 建议问题 — 用 3–5 个启动提示填充空状态。这些是小部件中最具影响力的文本：它们告诉读者助手的用途。
- 系统提示 — 用您自己的声音和规则替换默认指令集。
- 预处理/后处理 LLM 钩子 — 在模型看到提示之前转换提示，并在读者看到响应之前进行后处理。请参见 聊天钩子。
哪个模型运行聊天？#
Docsbook 默认通过 OpenRouter 运行聊天，在 openai/gpt-4o-mini 上，您可以在工作区设置中选择不同的模型。提供者可以是以下任意一种：
providers:
- openrouter
- openai
- gemini
- anthropic在 设置 ▸ 聊天 下有两个模型设置，因为有两个不同的模型在工作：
- AI 访客聊天模型 — 在文档聊天中回答您的读者。
- 管理员 & AI 代理模型 — 在您的仪表板中运行助手：读取您的分析、调用工具和编辑您的文档的那个。
每个设置列出了自己的模型，旁边标有每百万个令牌的价格，因此便宜的读者聊天和更强大的管理员助手——或反之——各是一个选择。更便宜的模型使相同的平衡发挥更大的作用。翻译在 设置 ▸ 翻译 下有自己的模型设置。
您还可以从工作区设置中带入自己的提供者 API 密钥。使用时将按提供者自己的价格计入您的密钥，并不会从您的 Docsbook 余额中扣除。
多人聊天#
在聊天工具栏中按邀请将队友带入同一实时会议。文档问题很少是单独完成的：有人提问，有人知道一半的答案，结果最终被粘贴到Slack中，没人再找到它。
- 查看谁在这里。该按钮显示您团队中当前在此聊天中的人员。
- 通过电子邮件邀请。无论收件人是否已经拥有Docsbook帐户，邀请都有效——链接将引导他们进行登录并直接进入项目。
- 一个共享的答案。你们都提问，你们都观看同一个答案流入，因此它会同时到达每个人，而不是通过二手转发。
会议仅限实时。所有人离开后，共享聊天的内容不会被存储。
当没有聊天连接时，读者看到的内容#
如果读者在没有连接AI聊天的文档网站上打开聊天小部件，他们会看到一个普通的说明，而不是错误，要求他们联系网站所有者进行设置。小部件从不静默失败，也从不向读者显示堆栈跟踪。