RAG 知识库管理

01 功能说明

从「智能协同 → RAG 知识库」进入。适合上传制度、操作规范、产品说明等多章节资料。只有一问一答、且答案明确的内容，可优先维护到FAQ 库。

本篇以“上传销售目标操作规范，并验证能否找到复核步骤”为例。示例描述操作方法；文档内容、适用部门和实际审批要求需以本公司规范为准。

02 使用前确认

1. 准备可使用的最新文档，建议文件名带主题和版本日期，便于区分旧版。
2. 检查正文包含真实可读文字、清晰标题和完整段落。仅有扫描图片的资料，应先确认解析结果是否能提取文字。
3. 确认资料适用的业务模块、团队、用户及 Agent 范围。
4. 确认具有知识库读取和写入权限；可选的数据范围还受管理权限限制。
5. 准备一个文档明确回答的问题，以及一个文档没有回答的问题，用于检验召回是否相关。

文件选择器支持 PDF、Word、TXT、Markdown，对应 .pdf、.doc、.docx、.txt、.md、.markdown。页面允许选择某格式，不代表每个文件都能解析成功，上传后的实际处理结果仍需检查。

03 页面区域与关键对象

“数据范围”控制资料面向的人群，“可见范围”还限定 Agent 或角色的使用范围。选择“全部 Agent 可见”不等于全公司所有用户都能访问。授权团队由团队管理维护，不等同于飞书组织部门。

04 推荐操作顺序

第一步：上传并设置范围

1. 点击“上传文档”，选择要处理的文件。可同时选多个文件。
2. 选择“文档模块”。本例选择与销售目标规范对应的模块。
3. 选择“数据范围”，需要团队时从团队选择器选择实际业务团队；需要角色或用户时填写正确标识。
4. 选择“可见范围”。指定 Agent 时填写实际 Agent ID，多个值用逗号分隔；不要用展示名称代替标识。
5. 核对本批文件是否适用同一范围。范围不同的资料建议分批上传。
6. 点击“上传并处理”，等待“文档已进入处理队列”的反馈。
7. 回文档列表定位文件，查看状态变化。

第二步：等处理完成并检查内容

打开文档，在“概览”看状态，在“Chunk”阅读目标条款对应的正文。核对标题、段落和关键条件是否完整；表格资料应特别检查列名与数值是否仍能对应。

第三步：必要时整理 Chunk

Chunk 就是用于检索的一段文档片段。如果目标条款被拆断或混进无关文字，可按页面提供的能力调整：

1. 在左侧选择需要查看的片段，右侧阅读正文。
2. 修正内容后点击“保存并重新向量化”，等待返回，再检查片段。
3. 要合并时勾选至少两个片段，再点击“合并”，核对新片段是否语义完整。
4. 要拆分时点击“拆分”，当前提供的是“按当前内容中点拆分”；不是自选段落边界，拆后需检查两段是否完整。
5. 删除片段会减少可供检索的内容，确认该片段不再需要后再执行。
6. 任何修改后都重新测试召回，不能只以编辑操作成功作为验收。

第四步：用真实问题测试召回

1. 打开“检索调试”或文档详情的“召回测试”。
2. 输入文档确实包含答案的问题，例如“销售目标修改后应该怎样复核？”
3. 选择对应模块。首次可使用默认 Hybrid 模式和 Top K 5。
4. 点击“测试召回”，逐条检查文档名称、页码（若有）、章节和片段正文。
5. 确认目标片段包含完整处理条件与步骤，而不只是出现了“目标”这个词。
6. 换成一个同义问法再测试；对文档没回答的问题，不将仅相关的片段当成完整答案。
7. 查看“Hermes 上下文预览”，核对将组合使用的内容是否包含旧版、重复或冲突规则。

05 权限与状态边界

文档必须具备合适的处理状态、启用状态和访问范围，才有机会被目标场景检索。实际调用仍受用户和 Agent 的访问范围限制。

文档行的更多操作提供“启用/停用、重试、删除”。重试是重新进入处理流程，用于解决处理问题；停用则控制是否继续使用。需要保留旧版作核对时，可先停用，避免新旧资料同时被检索造成口径冲突。

当前上传流程不能据此理解为“同名文件自动覆盖旧版”。新版上传后，应核对新旧记录、处理状态和召回来源，再按管理要求处理旧资料。

06 操作后验证

完成本例，需要满足以下检查点：

• 列表里找到正确文件，模块、范围及启用状态符合要求。
• 状态达到“可检索”，处理日志中没有尚未处理的失败信息。
• 在 Chunk 中能读到“目标修改后如何复核”的完整条款，条件和步骤没有缺失。
• 使用标准问题与同义问法测试，能召回正确版本和相关片段。
• 由实际使用者在目标场景验证；管理员能检索到，不能证明其他用户也能检索到。
• 新任务使用该知识时核对实际引用与回答；仅文档页面测试成功，不能证明所有任务都会读取这份资料。

07 常见异常处理

08 常见问题