FA 一键诊断 知识库元数据标签体系设计 v1.1
前置阅读：
- 工单数据调研报告：一键诊断场景分析
- 知识库文档元数据标注建议 — 运维资料 92 份文档的实际标注结果
- QA 知识库元数据标签体系设计 — 参照模板
版本记录：
- v1.0 (2026-06-17)：初稿，基于 QA 标签体系 v1.3 模式裁剪，适配 FA 一键诊断场景
0. 背景与目标
0.1 与 QA 知识库的关键差异
| 维度 | QA 知识库 | FA 一键诊断知识库 |
|---|---|---|
| 核心用途 | 各 Agent 的通用知识问答 | 工单诊断时的设备手册/排障指南检索 |
| 检索触发 | 用户自然语言提问 | 工单进来 → 打标 → 按标签过滤检索 |
| 文档类型 | 广泛（制度/培训/FAQ/手册） | 聚焦（设备手册/故障码表/安装说明/通讯协议） |
| 核心过滤维度 | business_domain + business_topic | category + tag（二维标签，工单打标结果直接对齐） |
| 受众 | 全体员工 + 访客 | 运维工程师 + 物业经理 |
| 动态知识库 | 无 | 闭环工单沉淀（历史案例自动入库打标） |
0.2 设计原则
- 检索优先：元数据字段必须直接支撑知识库检索的 Metadata Filter，不设纯展示字段
- 与打标对齐：category + tag 字段值与工单自动打标输出一致，确保过滤精准
- 精简：QA 体系 14 个自定义字段 → FA 诊断只需 8 个
1. 元数据标签体系
1.1 三层架构
┌──────────────────────────────────────────────────────────┐
│ L1 诊断语义层 category / tag / doc_nature / │
│ equipment_brand / equipment_model / │
│ keywords │ ← 检索核心
├──────────────────────────────────────────────────────────┤
│ L2 权限控制层 access_roles │ ← 内部运维人员
├──────────────────────────────────────────────────────────┤
│ L3 运营健康层 source_file_url / expiry_date / │
│ retention_policy │ ← 长期维护
└──────────────────────────────────────────────────────────┘1.2 L1 诊断语义层
| 字段 | 类型 | 必填 | 值域 | 说明 |
|---|---|---|---|---|
document_title | string | ✅ | 自由文本 | 人类可读标题，用于诊断报告中引用展示 |
category | string | ✅ | 从 category_config 表取值（默认 7 个：建筑结构 / 电气 / 弱电智能化 / 给排水 / 暖通空调 / 消防安防 / 专用设备） | 一级过滤维度，与工单打标 category 字段对齐，值由管理后台配置 |
tag | string | ✅ | 从 tag 配置表取值 | 二级过滤维度，与工单打标 tag 字段对齐。如 闸机、UPS、精密空调 |
doc_nature | string | ✅ | 用户手册 / 产品说明书 / 安装说明书 / 操作说明书 / 通讯协议 / 故障码表 / 排障指南 / SOP / 功能使用说明 / 保修卡 / 合格证 | 文档性质，过滤掉保修卡/合格证类无效文档 |
equipment_brand | string | — | 自由文本 | 品牌名。如 海康、施耐德、青鸟、广宁 |
equipment_model | string | — | 自由文本 | 型号。如 DS-2CD232FUAI-WSF、JBF5014。工单描述中提取到型号时启用精确过滤 |
keywords | string[] | ✅ | 自由文本 | 关键词标签，用于补充检索召回 |
1.3 L2 权限控制层
| 字段 | 类型 | 必填 | 建议值 | 说明 |
|---|---|---|---|---|
access_roles | string[] | ✅ | 超级管理员 / 物业经理 / 运维工程师 | FA 诊断文档仅面向运维人员，不对普通员工/访客开放 |
1.4 L3 运营健康层
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
source_file_url | string | — | 原始文件路径（留作溯源） |
expiry_date | date | — | 设备手册通常不过期；平台操作手册可能需要版本同步 |
retention_policy | enum | ✅ | active / archived / to_delete |
2. 存储方案
2.1 Dify 自定义字段类型映射
| 元数据字段 | Schema 类型 | Dify 存储类型 | 存储示例 |
|---|---|---|---|
document_title | string | string | "GNG广宁闸机V6使用手册" |
category | string | string | "弱电智能化" |
tag | string | string | "闸机" |
doc_nature | string | string | "用户手册" |
equipment_brand | string | string | "广宁" |
equipment_model | string | string | "V6" |
keywords | string[] | string (JSON) | "[\"闸机\",\"通道控制器\",\"伺服电机\"]" |
access_roles | string[] | string (JSON) | "[\"超级管理员\",\"运维工程师\"]" |
source_file_url | string | string | "oss://kb-fa/门禁道闸/GNG广宁闸机V6.pdf" |
expiry_date | date | time | null |
retention_policy | string | string | "active" |
2.2 完整元数据示例（闸机手册）
yaml
# ===== L0 Dify 原生 =====
document_name: "GNG广宁闸机V6使用手册.md"
uploader: "sunqiang"
source: "file_upload"
# ===== L1 诊断语义 =====
document_title: "广宁闸机V6使用手册"
system: "弱电智能化"
tag: "闸机"
doc_nature: "用户手册"
equipment_brand: "广宁"
equipment_model: "V6"
keywords: ["闸机", "翼闸", "摆闸", "通道控制器", "伺服电机", "故障码"]
# ===== L2 权限控制 =====
access_roles: ["超级管理员", "物业经理", "运维工程师"]
# ===== L3 运营健康 =====
source_file_url: "oss://kb-fa/门禁道闸/GNG广宁闸机V6.pdf"
expiry_date: null
retention_policy: "active"2.3 完整元数据示例（平台操作手册）
yaml
document_title: "配变电监控平台功能使用说明"
system: "电气"
tag: "配电监控平台"
doc_nature: "功能使用说明"
equipment_brand: null
equipment_model: null
keywords: ["配电", "监控", "平台操作", "告警配置"]
access_roles: ["超级管理员", "物业经理", "运维工程师"]
retention_policy: "active"3. 与 QA 元数据标签体系的差异对照
| 维度 | QA 体系 | FA 诊断体系 | 变更原因 |
|---|---|---|---|
| 一级分类字段 | business_domain (14 个值) | category (可配置，默认 7 个) | FA 诊断按设备类别分类，更聚焦，支持项目级自定义 |
| 二级分类字段 | business_topic (自由文本) | — | category + tag + keywords 已足够 |
| 设备分类 | applicable_equipment_types (自由数组) | tag (单值，从配置表取) | 诊断场景通常一个文档只对应一个核心诊断标签 |
| 设备品牌 | equipment_brands (数组) | equipment_brand + equipment_model (单值) | 诊断需要精确型号过滤 |
| 空间类型 | applicable_space_types | — | 设备诊断不关心空间类型 |
| 适用 Agent | applicable_agents (多选) | — | FA 诊断知识库固定只给 FA 用 |
| 权限字段 | access_roles (5 角色) | access_roles (3 角色) | 仅运维体系人员 |
4. 自动标注 Skill Prompt
4.1 用途
文档上传至 FA 诊断知识库时，由 LLM 基于文档标题 + 前 2000 字符自动抽取元数据标签。人工审核后入库。
4.2 System Prompt
text
你是一个设备运维文档自动标注专家。你的任务是根据文档的标题和内容前2000字符，自动提取以下元数据标签。
## 标签说明
- category: 从 `category_config` 表取值，必须命中（默认 7 个）
建筑结构 / 电气 / 弱电智能化 / 给排水 / 暖通空调 / 消防安防 / 专用设备
> 以上为默认候选值，实际值以管理后台配置为准。标注时请根据文档内容匹配最接近的 category。
- tag: 设备/组件名称（必填）
从以下候选列表中选最匹配的一项：
配电采集模块, UPS, 继电器, 时序电源, 无线测温装置, 配电监控平台, 能耗管理平台, 电能管理平台,
水泵, 水表, 漏水检测传感器, 液位计, 超声波流量计, 给水监控平台,
气象传感器, CO2传感器, 温湿度传感器, 光照传感器, 颗粒物传感器, CO传感器,
数字会议主机, 触摸控制屏,
球机/云台摄像机, 半球摄像机, 摄像机, NVR/存储, 监控管理平台, 动环监控平台,
门禁控制器, 电子围栏, 闸机, 闸机控制器, 道闸, 车牌识别摄像机,
I/O采集模块,
加湿/除湿设备, 精密空调, 冷水机组, 空调控制器, 末端空调监控平台,
火灾报警控制器, 气体灭火控制器, 巡更设备, 巡更管理平台,
调音台, 调音台接口箱, 无线话筒系统, 话筒, 鹅颈话筒, 音箱, 功放, 监听音箱, 中控主机
若无匹配，可填写新的 tag 名称
- doc_nature: 文档性质（必填，8选1或填其他）
用户手册 / 产品说明书 / 安装说明书 / 操作说明书 / 通讯协议 / 故障码表 / 排障指南 / 功能使用说明 / SOP / 保修卡 / 合格证
- equipment_brand: 设备品牌（选填，能识别到就填）
- equipment_model: 设备型号（选填，能识别到就填）
- keywords: 3-8个中文关键词，覆盖文档涉及的设备、功能、故障类型
## 输出格式
严格按以下 JSON 格式输出，不要输出任何其他内容：
{
"category": "弱电智能化",
"tag": "闸机",
"doc_nature": "用户手册",
"equipment_brand": "广宁",
"equipment_model": "V6",
"keywords": ["闸机", "翼闸", "通道控制器", "故障码"],
"confidence": 0.9
}
confidence 取值为 0~1 小数（≥0.8 高置信，0.5~0.8 中，<0.5 低）。medium 及以下建议人工复核。4.3 User Prompt 模板
text
请为以下文档自动标注元数据标签。
## 文档标题
{document_title}
## 文档内容（前2000字符）
{document_content_preview}4.4 调用示例
输入：
文档标题: GNG广宁闸机V6使用手册.pdf
文档内容: GNG广宁闸机V6 使用手册 V6.0 ...(内容截取)... 故障码 E001 电机过载 E002 红外感应器故障 ...预期输出：
json
{
"category": "弱电智能化",
"tag": "闸机",
"doc_nature": "用户手册",
"equipment_brand": "广宁",
"equipment_model": "V6",
"keywords": ["闸机", "翼闸", "故障码", "电机过载", "红外感应"],
"confidence": 0.9
}文档版本：v1.1创建日期：2026-06-17最后更新：2026-06-23 *作者：强哥 *