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

新制度已经上传,机器人却仍引用旧版,不一定是新文件没被索引。两份正文可能都与问题高度相关。Dify 元数据过滤可以先限定地区、制度版本和状态,再在合适的资料中找答案;“最近上传”不能代替“对这个问题适用”。
生效日期为什么要单独保存?
Dify 内置元数据包括上传时间和最后更新时间,但它们记录的是文件管理动作。今天补传去年制度,或者提前上传下月才执行的新规,都会让上传顺序与业务生效顺序错开。
按当前元数据文档,自定义字段支持 String、Number、Time,名称使用小写字母、数字和下划线。下面是一组应用自行定义的教学字段,不是 Dify 预置字段:
| 文档 | policy_id | edition | region | status | valid_from | valid_until |
|---|---|---|---|---|---|---|
| 旧版 | demo-travel | v1 | cn | approved | 2026-01-01 | 2026-11-01 |
| 新版 | demo-travel | v2 | cn | approved | 2026-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 元数据或验证节点筛选。界面与功能范围应以自己的部署版本为准;上线前用工作流副本跑完当前与历史两类问题。


