DifyKnowledge BaseRAGDocument Lifecycle

从 Dify 撤下一份旧资料,要确认它真的退出检索

Dify 禁用、归档和删除文档的作用不同。用旧版退出、新版进入和全新会话复查,判断陈旧答案来自检索、历史对话还是应用缓存。

查看接入文档
从 Dify 撤下一份旧资料,要确认它真的退出检索

把新版文件上传成功,只说明多了一份资料,旧版未必退出检索。Dify 的禁用、归档和删除对应不同的保留方式。撤回旧知识后,要直接检查候选片段,并用全新对话验证应用,才能分清旧答案还从哪里来。

禁用、归档和删除该怎么选?

按当前内容维护文档,禁用会把文档临时排除在检索之外;归档适合暂时不检索、仍需保留的资料,归档文档只读,可以取消归档;删除则永久移除,不能撤销。

目标可先考虑的操作随后验证什么
暂时撤回有疑问的资料禁用同一知识库的新检索不再返回它
保存历史、停止日常检索归档当前检索不含它,历史资料仍按管理规则保留
明确不再保留该文档按保留制度删除对象与范围正确,另查备份及其他副本

先在临时知识库或应用副本演练,再处理正式资料。删除一份知识文档不能证明上传原件、备份、外部源、历史消息和应用缓存都被清理;这些存放位置需要各自的保留规则。本文也不提供全库清空命令。

禁用是临时排除,归档保留只读副本,删除不可撤销

上传新版之前,应该记下哪几个标识?

至少记下知识库 ID、旧文档 ID、版本与关键片段,以及哪些应用仍绑定这份库。文件名容易重复,不能只靠“制度最新版.pdf”确认对象。新旧版本需要同时保留供历史查询时,先采用版本与适用日期筛选,别把每份旧资料都当垃圾删除。

准备两条教学输入:demo-hours-v1 写“服务窗口为 09:00–17:00”,demo-hours-v2 写“服务窗口为 10:00–18:00”。它们不是本站实际服务时间。两个版本都加稳定标识,测试问题用“演示窗口几点开始”。

这类更新有两种处理顺序。普通换版可以先让新资料完成处理并在副本中验证,再切换适用范围并撤下旧版;若旧资料已经确认错误且不能继续使用,先停止它参与检索,即使短期只能回复“资料待确认”。不要为了保持有答案,继续让已撤回的规则进入模型。

什么结果才说明旧资料没有被新请求搜到?

先在知识库检索测试中查原问题及改写问题,检查实际文档/片段 ID,不只看答案里的时间。然后核对应用节点选择了哪些库,是否还有另一份同内容文档或外部知识源。

核对对象、准备新版、停止旧版检索、检查候选,再验证应用

Dify 的检索测试说明提醒,测试页设置只对当前测试会话有效。节点文档也区分库层与节点层处理。因此,不能拿测试页临时收紧的条件,代替已经发布应用的实际条件。

可以把检查写成“禁止再出现的来源集合”。下面的离线检查只适用于已经归一化为这组结构的检索结果,不是 Dify 原始响应契约:

retired_ids = {"demo-hours-v1"}
retrieved = [
    {"document_id": "demo-hours-v2", "chunk_id": "opening-hours"},
]
leaked = [row["document_id"] for row in retrieved
          if row["document_id"] in retired_ids]
if leaked:
    raise ValueError("Retired evidence is still retrievable")
print("No retired IDs in this result")

它只证明这一次结果没有这些 ID,不证明所有问法、所有应用或所有存储都已清理。还要包含旧文独有的一句内容作为反向测试,避免两版文字接近时只盯着正确答案。

候选已经干净,为什么聊天还说旧规则?

旧会话可能带着之前的回答或工具结果。检索规则的变化不会自动重写模型已经收到的历史。用一个全新会话重问,并对照实际输入:如果新会话正确、旧会话错误,先查历史内容;如果两者候选都含旧版,继续查绑定、复制文档与筛选条件。

旧答案可能来自仍在检索的副本、对话历史或应用缓存,三处分别核查

应用自己实现了答案缓存时,缓存也应纳入内容更新流程,例如把知识版本加入缓存身份,或按影响范围失效。这是应用设计建议,不是 Dify 已经替你做过的保证。不要把Embedding 缓存与维度迁移的故障处理直接套过来;答案缓存、查询向量和旧索引是不同对象。

保留三份验收记录:新检索实际返回哪些来源、全新会话使用了哪些证据、原有会话如何提示规则已经更新。来源本身是否支持答复,可继续看引用链检查;没有可用证据时的测试见无答案验收题。

本文于 2026 年 11 月 21 日核对 Dify 当前文档,仅用合成列表验证旧文档 ID 检查,没有执行真实禁用、归档、删除或缓存失效。Nbility 的接入基础解决模型连接;知识资料的撤回与应用历史需要在知识库和应用侧各自验收。

相关文章

给 RAG 留几道资料里没有答案的题
RAGEvaluationDify

给 RAG 留几道资料里没有答案的题

RAG 评估不能只考知识库里写过的题。加入无答案、缺条件、旧版本和相近型号问题,分别检查证据覆盖、澄清行为与最终回答。

用 Nbility 跑通你的 Agent 工作流

获取 API Key,统一接入 OpenAI 兼容模型和开发工具。

获取 API Key