DifyMetadataRAGDocument Versioning

用 Dify 元数据过滤选对制度版本

Dify 元数据过滤能缩小检索范围,但上传时间不等于制度生效时间。为当前与历史问题设计明确的版本字段,检查缺字段、地区和大小写。

查看接入文档
用 Dify 元数据过滤选对制度版本

新制度已经上传,机器人却仍引用旧版,不一定是新文件没被索引。两份正文可能都与问题高度相关。Dify 元数据过滤可以先限定地区、制度版本和状态,再在合适的资料中找答案;“最近上传”不能代替“对这个问题适用”。

生效日期为什么要单独保存?

Dify 内置元数据包括上传时间和最后更新时间,但它们记录的是文件管理动作。今天补传去年制度,或者提前上传下月才执行的新规,都会让上传顺序与业务生效顺序错开。

按当前元数据文档,自定义字段支持 String、Number、Time,名称使用小写字母、数字和下划线。下面是一组应用自行定义的教学字段,不是 Dify 预置字段:

文档policy_ideditionregionstatusvalid_fromvalid_until
旧版demo-travelv1cnapproved2026-01-012026-11-01
新版demo-travelv2cnapproved2026-11-01空

这里约定开始日期包含当天,结束日期不包含当天;空结束日期代表当前没有已知终止日。这个约定来自示例应用,需要由资料维护者确认。Dify 不会从 v2 这个名字自动知道它何时生效。

业务生效区间与上传日期分开,新旧版本在明确日期交接

“今天适用”和“当时适用”要怎么区分?

先确定读者问的是当前规则,还是某个历史日期。当前问题可以使用应用维护的、已确认的版本值;历史问题则先由业务规则选出该日期适用的版本,再检索正文。缺日期或地区会改变答案时,应先澄清,不从相似文件里挑一个看起来新些的版本。

下面的离线程序演示半开日期区间和唯一版本校验。它不是 Dify 过滤请求格式,不会配置节点,也不代替真正的资料审批:

from datetime import date

rows = [
    {"id": "travel-v1", "region": "cn", "status": "approved",
     "start": "2026-01-01", "end": "2026-11-01"},
    {"id": "travel-v2", "region": "cn", "status": "approved",
     "start": "2026-11-01", "end": None},
]
as_of = date.fromisoformat("2026-11-21")
selected = [
    row for row in rows
    if row["region"] == "cn" and row["status"] == "approved"
    and date.fromisoformat(row["start"]) <= as_of
    and (row["end"] is None or as_of < date.fromisoformat(row["end"]))
]
if len(selected) != 1:
    raise ValueError("No unique applicable edition; review metadata.")
print(selected[0]["id"])

这段选择器在两个版本交界日也必须只选一个。零条说明没有覆盖或上下文不匹配,多条可能是生效区间重叠;两者都不应交给相似度排序暗中裁决。

Dify 节点里能直接配置哪些条件?

官方应用集成说明区分自动和手动过滤。手动方式可以选择字段、运算符以及常量或工作流变量,组合 AND/OR。比如已确认版本后,用 policy_id is demo-travel、edition is v2、region is cn、status is approved 的 AND 条件缩小范围。

先明确问题日期与地区,再选择版本、过滤文档,最后执行正文检索

当前说明还写明:Time 类型只能用常量过滤。不要把上面的 Python 日期比较直接说成 Dify 节点支持的动态时间表达式。确实需要任意日期时,可由应用先完成版本选择,再传入支持的字符串变量,或采用已经验证过的外部检索实现。

多库一起检索时,手动过滤的字段下拉只显示共同字段。字段值区分大小写,cn 与 CN 不能当作同一个值。自动过滤还需要选择模型,不应把它对问题的推断直接当成经过确认的业务版本。

加过字段,为什么还是有资料漏标?

创建知识库字段并不等于每份文档都有值。官方元数据编辑器的批量更新中,“Apply to All Documents”默认不勾选时,只更新本来已经有该字段的文档;要给所选文档补字段,需要检查实际应用范围。

当前、历史、缺字段和地区不符分别走版本选择、补标或澄清

用四类问题验收:今天的制度、边界日前的历史制度、未标地区的文档、另一个地区的问题。直接看过滤后的片段,确认不适用版本没有进入上下文;再检查最终引用的文档 ID 和版本。为当前问题设的固定 v2 条件,不应拿来回答所有历史问题。

元数据在本文用于版本和适用范围,不由此宣称完成了用户权限隔离。资料一旦停用或撤回,还要按旧知识退出检索的检查流程处理;片段与来源的传递可参照PDF 引用链。首次连模型仍按接入基础配置,模型连接本身不会生成这些业务字段。

本文于 2026 年 11 月 21 日查阅上述当前文档,仅离线验证日期边界、缺失匹配和重复适用区间的检查逻辑,没有操作真实 Dify 元数据或验证节点筛选。界面与功能范围应以自己的部署版本为准;上线前用工作流副本跑完当前与历史两类问题。

相关文章

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

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

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

用 Nbility 跑通你的 Agent 工作流

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

获取 API Key