Dify 元数据删改前必看：字段定义与文档取值影响范围不同

用一个字段区分两层对象 设想知识库中有表示“文档类型”的 doc_type 字段，手册填写 manual，常见问题填写 faq。字段定义描述所有文档可以使用什么属性，具体取值描述某篇文档属于哪一类。管理操作出错，往往是把这两层混为一谈：本想清理一篇文档的标记，却删除了整个库的字段。 先确定类型和命名 官方资料支持字符串、数字与时间三种值类型。字段名使用小写字母、数字和下划线；重命名操作不支持同时改变类型。因此建议在创建前写出样例值，确认它是用于标签、数值比较还是时间筛选。已经被多篇文档引用后再改变设计，会增加回填与核对工作。 不要把创建字段当成完成标记 自定义字段进入知识库定义列表后，仍需应用到具体文档并填写值。内置元数据则有单独的启用逻辑，启用后由系统提取，修改权限也与自定义字段不同。验收时应打开文档确认实际字段和值，而不只是看到库中存在一个同名字段。 用三份文档预测批量修改结果 在测试库中准备 A、B、C 三份自拟文档：A 的 doc_type 为 manual，B 为 faq，C 尚未设置该字段。仅选中 A 与 C，把 doc_type 改为 guide。按当前文档说明，默认未勾选“应用于所有文档”时，改动只作用于已有该字段的 A；勾选后，C 也会新增字段和值。B 没有被选中，两种情况下都不应改变。 先写出这个预期，再保存并重新打开三份文档核对。只看批量编辑窗里显示 guide，不能证明 C 已经补上，也不能证明 B 没受影响。类似地，清空字段值、删除文档上的字段、删除知识库字段，应分别试验，不要把界面都显示为空理解为相同结果。 字段设计改变时，恢复所需的信息也不同。误删一篇文档的值，只需恢复该篇对应值；删掉全局定义后，仅重新建一个同名字段不会自动找回每份文档原来的取值。重要变更前保留文档 ID 与原值对应关系，并检查依赖该字段的检索配置。 三种删除范围 在知识库元数据管理界面删除字段，会移除库内这个定义及文档中相应的值；在批量文档编辑中删除字段，只影响选中文档；在单篇文档中删除，则只影响当前文档。后两种操作仍保留知识库中的字段定义。 编辑建议是在正式删除前记录字段用途与受影响文档，尤其确认检索筛选是否依赖它。如果只是某些文档分类错误，应先修正文档取值，而不是删除整个字段重建。 批量操作再检查一遍范围 文档中“应用于所有文档”选项指向本次选中的文档：启用后，原先没有该字段的选中文档也会被添加；默认行为则只作用于原本已有该字段的文档。容易忽略的不是按钮在哪里，而是同一批文档是否都应得到同一个值。 建议先选择少量有代表性的文档做变更，包含已有字段和没有字段两种情况。保存后重新打开各自详情，核对新增、清空与保留是否符合预期，再扩大批量范围。 把标记与访问控制分开验证 本篇聚焦资料分类与管理范围。给文档加上某个元数据值，不应直接视为完整的权限机制；如果应用依靠筛选限制检索，还需要在实际请求路径核对筛选条件是否始终执行。完成标记后，用真实筛选查询确认结果，比只检查字段列表更有意义。

本篇涉及的工具1

Dify

定义知识库属性并标记文档取值

适合场景

需要为 Dify 文档标记类型、来源、时间等属性的知识库维护人员。

需要留意

全局删改与文档删改范围不同，批量操作需回查。

了解项目 访问官网