知识库（RAG）
让你的 AI 代理基于你真实的业务信息作答——上传文档或连接 Notion，每一条回复都扎根于你自己的内容。
知识库的作用
知识库是让你的 AI 代理基于你自己的真实信息作答、而非凭空猜测的方式。你把文档交给它；它进行阅读，并在作答时提取出最相关的段落，据此进行回复——这一模式被称为 RAG（检索增强生成）。
Waslo 会告诉 AI，知识库是它的权威来源，并指示它优先采用这些内容，而非其他可能的臆断。当答案来自你的文档时，AI 会在对话中标注来源，这样你（以及你的客户）都能看到它出自何处。
在侧边栏的 AI 部分下 → Knowledge Base 中可以找到它。
工作原理
在后台，每一份文档都会经过同一条流水线：
- 提取——Waslo 从你的文件或 Notion 页面中抽取纯文本。
- 分块——文本被切分为相互重叠的段落，使相关句子保持在一起。
- 嵌入——每个分块被转换为一个向量（对其含义的数值化表示）。
- 检索——当客户提问时，Waslo 找出与其问题在含义上最接近的分块。
- 作答——这些分块被交给 AI，由它撰写一条扎根于这些内容的回复，并标注来源。
这一切在每一次回复、每一个渠道上都自动发生。你无需管理任何环节——只需保持文档的时效性即可。
支持的来源
| 来源 | 说明 |
|---|---|
| 必须包含真实、可选中的文本（见下方注意事项） | |
| Word（DOCX） | 标准文档 |
| TXT | 纯文本 |
| Markdown（MD） | 非常适合结构化的常见问题 |
| CSV | 结构化数据的行（例如常见问答对、规格表） |
| Notion | 通过内部集成令牌连接页面 |
每个上传文件有 10 MB 的大小限制。
添加文档
- 在侧边栏打开 Knowledge Base。
- 点击上传一个文件（PDF、DOCX、TXT、MD 或 CSV）。
- 等待状态从处理中变为就绪——在 Waslo 提取、分块和嵌入文本期间，这可能需要一点时间。
- 一旦就绪，文档即上线：AI 会在下一次回复时开始使用它。
你可以随时移除文档；其内容会立即停止被使用。
连接 Notion
Notion 让你把权威信息源集中在一个地方，并让 Waslo 与之保持同步。
- 在 Notion 中，创建一个内部集成并复制其令牌。
- 将具体的页面（或数据库）共享给该集成——这是人们常常遗漏的一步。如果页面没有共享给集成，Waslo 就无法读取它。
- 在 Waslo 中，用该令牌连接 Notion 并指向该页面。
- Waslo 会遍历页面的区块，提取文本，并像其他任何文档一样为其建立索引。
每日一次的重新同步会保持 Notion 内容的时效性，因此你在 Notion 中所做的编辑会流入知识库，无需重新上传。
Notion 注意事项： 一个内容仅为嵌入文件（例如嵌入的 PDF 或 Google Doc）的页面，本身没有可读文本——嵌入内容指向别处。请把实际文本放到 Notion 页面上，或改为直接上传该文件。
文档上限
| 方案 | 最大文档数 |
|---|---|
| PAYG | 50 |
| Growth | 200 |
如果达到上限，请移除不再需要的文档，或升级到 Growth 以获得更大的余量。
将文档限定到特定号码
如果你运营多个 WhatsApp 号码（例如每个分店或每个品牌一个），你可以将某份文档限定为只对特定号码生效。默认情况下，未设定范围的文档适用于你的整个组织。当价目表、政策或菜单在不同地点之间存在差异，且你不希望某个分店的文档泄漏到另一个分店的回复中时，限定范围就很有用。
它基于文本——请阅读此节
知识库的工作对象是文本。如果一份文档没有可提取的文本，就无法为其建立索引。两种常见情况：
- 扫描图像的 PDF——一份实际上只是页面照片的 PDF（扫描件或截图导出）没有可选中的文本，因此无法提取任何内容。
- 仅为嵌入内容的 Notion 页面——如上所述，可读内容存在于嵌入文件中，而非页面本身。
发生这种情况时，文档会被标记为失败并附带一条可操作的提示信息，你也会收到通知。修复方法很简单：重新上传一个文本版本——将文档导出为带真实文本的格式、先用 OCR 处理扫描件，或以 Markdown/TXT 的形式粘贴内容。
价格属于商品目录，而非知识库
对店主而言的一条重要规则：商品价格属于商品目录（Growth），它是价格和库存状态的权威来源。不要在商品目录和知识库中重复放置价格。
如果同一个价格存在于两处，而其中一处已过期，AI 就可能报出错误的数字。请把价格保存在商品目录中，把其他所有内容——政策、营业时间、常见问题、操作指南、服务说明——保存在知识库中。
最佳实践
- 围绕问题来撰写。 将内容组织成清晰的问答式条目（"保修期多长？" → 答案）。当一个分块读起来像一个直接的答案时，检索效果最好。
- 保持时效性。 过时的营业时间或政策会产生自信却错误的回复。业务变化时请审查文档。
- 一个事实，一个位置。 避免在不同文档之间自相矛盾——相互冲突的段落会干扰检索。
- 简明而具体。 简短、聚焦的章节比冗长、啰嗦的更容易被检索到。
- 商品使用商品目录。 价格、库存和照片放在商品目录中，而不是这里。
疑难排查
| 症状 | 可能原因 | 解决办法 |
|---|---|---|
| 文档卡住/被标记为失败 | 没有可提取的文本（扫描 PDF、仅含嵌入的 Notion 页面） | 重新上传真实文本版本，或先做 OCR |
| AI 忽略某份文档 | 仍在处理中，或已被移除 | 确认状态为就绪 |
| AI 报出错误的价格 | 价格在知识库和商品目录之间重复 | 从知识库中删除价格；保留在商品目录中 |
| Notion 页面无法建立索引 | 页面未共享给集成 | 将页面共享给你的 Notion 集成 |
| 找不到答案 | 内容淹没在长篇文字中 | 改写为聚焦的问答式章节 |
常见问题
AI 在每次回复时都会读完整份文档吗？ 不会。它只针对客户的具体问题检索最相关的段落，然后据此作答。这让回复保持快速而聚焦。
我可以上传哪些文件格式？ PDF、Word（DOCX）、TXT、Markdown（MD）和 CSV——每个最大 10 MB。
为什么我的 PDF 无法建立索引？ 几乎总是因为它是没有可选中文本的扫描图像。请将其导出或重新制作为文本 PDF（或对其做 OCR），然后重新上传。
我的 Notion 内容有多新？ 每日一次的重新同步会拉取更新。若有紧急编辑，你可以重新连接页面以更快地重建索引。
我应该把价目表放进知识库吗？ 不应该——价格放在商品目录（Growth）中，它是价格和库存状态的权威来源。其他所有内容都保存在知识库中。
客户能看到来源吗？ 当一条回复扎根于你的文档时，AI 会在对话中标注来源。