知识库维护：管理您自己的知识库

在 Knowledge 应用里维护租户自己的知识库：建库、从文档中心选文档或直接上传、整理分类、修正切分、测试检索、处理反馈队列、看统计看板。

Knowledge 应用里装着两类不同的东西，这篇只讲第一类。「我的知识」页签下（Knowledge → 知识库，/knowledge/bases）是您公司自己维护的知识库：你们的 SOP、制度和手册，AI Rollie 和 AI 回答会从这里取材。旁边的「平台知识」页签（Knowledge → 平台知识，/knowledge/platform）是平台发布的官方知识——只能看、能搜，不能改，它另有说明。下面讲的建库、文档、切分、检索测试、反馈和统计，全部是关于怎么把您自己的知识库维护得准确、好搜。

第一步：新建知识库#

1. 打开 Knowledge → 知识库（/knowledge/bases），点「+ 新建知识库」。
2. 填名称（必填），再写一句描述说明这个库装什么——比如「仓库 SOP」或「客服话术」。按主题分库，比一个大库装下所有东西更好维护。
3. 「高级设置」默认收起、不用动：切分窗口（默认 800 token，可设 200–4000）和重叠（默认 150 token，必须小于切分窗口）决定文档被切成多大的可检索片段。没有明确理由就保持默认。
4. 保存。新库会出现在列表里，带文档数和知识点数；「编辑」可改名称、描述或切分参数；「归档」让一个库不再参与检索——「恢复」可把它带回来，「显示已归档」让已归档的库出现在列表里。

第二步：往库里加文档#

1. 打开 Knowledge → 文档管理（/knowledge/documents），在顶部选好知识库，点「添加文档」。
2. 页签一「从文档中心选择」：勾选已经在文档中心里、还没进这个库的文档，可按需选一个分类，再点确定。已经在库里的文档不会再出现。
3. 页签二「直接上传」：点击或把文件拖进来（可多选）。每个文件会先上传到文档中心，再一并加入当前库，并归到您选的分类下。
4. 回到列表后，盯一下每篇文档的索引状态：等待索引、索引中、已索引（带知识点数）或索引失败。失败的文档旁有「重试索引」——先别改别的，点重试即可。

把文档加进库，才是让它能被搜到的动作：系统会按这个库的切分窗口和重叠把文档切成知识点，回答正是用这些知识点拼出来的。同一个文件可以加入多个库——加进第二个库不会把它从第一个库里拿走。这里是 Knowledge 应用的维护侧（/knowledge/documents）；阅读和提问的那一侧在 Knowledge App 那篇里讲。

用分类整理，并保持文档整洁#

• Knowledge → 文档管理 左侧的分类树最多支持 3 级：新增分类、在分类上点 + 加子分类、重命名、删除。删分类不会删文档——其下文档会变成未分类。
• 每行文档会显示它的生命周期（草稿 / 待审核 / 已发布 / 已归档，如已设置）、版本、标签，以及复审日期临近或已过时的「待复审」徽标——先处理这些，因为拿过期文档拼出的回答会误导人。
• 用索引状态筛选或按标题搜索，能快速找到一篇文档。「移出知识库」会把一篇文档从当前库移出，并立即删掉它的全部知识点——原文件仍留在文档中心里。

第三步：回答读着不对时，修切分#

1. 打开 Knowledge → 切分预览（/knowledge/chunks），选库、选文档。它的知识点按质量分从低到高排，问题片段会浮到最上面；每行显示章节、内容、Token 数和质量分。
2. 某个知识点被从句子中间切断、或混了两个话题时，点「编辑」改它的文本——保存后它会自动重新生成可检索形态。
3. 太长的知识点可以按字符位置「拆分」；两个相邻片段本该是一体的，用「与下一条合并」。改完后都会重新索引。
4. 某段内容要留在文档里、但永远不要被回答引用时，用它的「启用」开关把它关掉——被禁用的知识点不参与检索，列表里也会标出来。

第四步：先测检索，再信任它#

Knowledge → 检索测试（/knowledge/search）是您的排练场：选一个库或全部库，像同事那样把真实问题打出来（比如「退货政策是什么？」），设好 Top K（返回多少个知识点，1–20），点检索。每个命中会显示相似度分数、出自哪篇文档和知识点原文；点「查看原文」直接跳到 Knowledge → 切分预览 里的那个知识点，当场就能修切坏的片段。没有命中，说明问法、Top K 或文档本身需要调整——先换个问法，再怪知识库。

第五步：处理反馈队列，并盯住数据#

• 有人给一条回答点了踩，它就会进 Knowledge → 反馈队列（/knowledge/feedback），按时间倒序排，带原问题、被引用的知识点和用户留下的留言。
• 在反馈卡上点「编辑 chunk」可跳到那个知识点、直接修源头文本；然后把这条标为「已修复」，或在回答本身没问题时标「不修复」。用待处理 / 已修复 / 不修复筛选队列，让待处理列表保持真实。
• Knowledge → 统计看板（/knowledge/stats）一眼看清整个应用的健康度：知识库数、文档数、知识点数、问答数、点赞率和检索命中率，还有引用次数 TOP 文档（带各自的赞和踩）——一篇被引用很多、踩也很多的文档，就是您的下一个维护任务。

本文用到的 Docklify 功能#

• 知识库：新建、编辑、归档与恢复，高级设置里调切分窗口与重叠——Knowledge → 知识库（/knowledge/bases）
• 文档管理：从文档中心添加或直接上传、最多 3 级分类树、索引状态与重试、待复审徽标、移出知识库——Knowledge → 文档管理（/knowledge/documents）
• 切分预览与修正：质量分、编辑、拆分、与下一条合并、启用/禁用——Knowledge → 切分预览（/knowledge/chunks）
• 带相似度分数和 Top K 的检索测试——Knowledge → 检索测试（/knowledge/search）
• 被踩回答的反馈队列：编辑被引用的知识点、标记已修复或不修复——Knowledge → 反馈队列（/knowledge/feedback）
• 统计看板：知识库数、文档数、知识点数、问答数、点赞率、命中率与引用 TOP 文档——Knowledge → 统计看板（/knowledge/stats）