设备手册怎么做成问答知识库:制造企业 RAG 落地要点
把一柜子设备手册扫描上传,接一个大模型,演示时问几句都答得像模像样。到了车间,维修工问"E23 怎么处理",它给出的却是另一个型号的处理步骤,语气还很笃定。
这种情况多半怪不到模型头上,问题出在资料进库之前:手册怎么拆、拆完怎么标、哪些资料能进、哪些问题不让答。这套做法一般叫 RAG(检索增强生成):先从资料库里检索出相关段落,再让模型照着这些段落回答,不凭它自己的记忆。智能体和知识库检索的区别、上线前要理清哪些数据,我们在工业智能体能干什么里写过,这里只讲"手册变成可问答"这一段的车间实操。
一、先把资料摊开:来源杂,毛病各不相同
工厂里的设备资料,很少是一份干净的电子版。常见的是下面几类,一起倒进去,检索出来的东西就是乱的。
| 资料类型 | 常见问题 | 处理办法 |
|---|---|---|
| 厂家 PDF(文字版) | 一本手册覆盖好几个型号;正文里大量"见第 7 章"交叉引用 | 按目录拆到小节,保留章节号;交叉引用处补上被引用小节的标题 |
| 厂家扫描件 | 识别错字(0 和 O、1 和 l 混);表格识别成一串文字;页眉页脚混进正文 | 文字识别后人工抽查故障代码表和参数表;表格单独转成结构化表;去掉页眉页脚 |
| 外文手册(英、日、德) | 原文术语和车间叫法对不上,搜不到 | 保留原文,另建术语对照表(见第四节) |
| 老师傅维修笔记 | 手写、简写,常常不写是哪台设备 | 请本人口述补全设备和现象;标注"内部经验,未经厂家确认" |
| 故障代码表 | 同一代码在不同型号上意思不同 | 按"厂家 + 型号 + 固件版本 + 代码"逐行入库(见第三节) |
| 备件清单 | 厂家件号和本厂 ERP 料号两套编码 | 做一张对照,回答里两个号都给 |
| 接线图、电气图 | 图片检索不到,模型也读不准 | 不指望模型看图;给每张图写一句文字说明和图号,回答时指到图号和页码,让人去看原图 |
| 维修工单 | 字段不全、写法五花八门 | 先清洗再进库(见第五节) |
扫描件还有个小坑:页码。手册印刷的页码和 PDF 文件的页码常常对不上(封面、目录、前言不计页)。回答里引用页码,统一用印刷页码,因为维修工手里拿的是纸本;系统里同时存文件页码,点开出处能直接跳过去。
二、按型号和版本切,每一段都带上标签
切的时候别按固定字数来。按字数切,一个故障的排查步骤可能被拦腰截成两段,检索只命中后半段,回答就从第 4 步开始讲。
一种可行的切分办法是:正文按小节切;操作步骤整组放在一段里,不拆开;故障代码表一行一段,每段带上表头,单独拿出来也看得懂。
每一段入库时打上这些标签:设备厂家、型号、适用的固件或软件版本、手册名称和版本号、章节号、印刷页码、语言、来源类型(厂家手册 / 内部经验 / 维修工单)、是否现行。
标签的用处在检索那一步。维修工提问时,先确定是哪台设备:从设备台账里选,或者扫一下设备铭牌旁边贴的设备码。系统先按型号和版本把范围筛出来,再在范围里找内容。问不出是哪台设备的,先反问一句,别去猜。
回答必须带出处:哪本手册、哪个版本、第几章、第几页。检索不到对应段落,就答"资料里没有找到",不让模型拿通用知识补。
三、"答串":同一个故障代码,换个型号意思就变了
这是设备问答里出错频率很高的一类。例如同一个厂家的两代驱动器,老型号的某个报警码表示过流,新一代或者固件升级之后,同一个码改成了编码器通信异常。两段内容都在库里,检索都能命中,模型很可能把两段"综合"成一个答案,听着通顺,哪台都不对。
防法有三条:
- 代码表按"厂家 + 型号 + 固件版本 + 代码"四项一起区分,不能只认代码;
- 检索结果里型号对不上的段落直接丢掉,不交给模型;
- 型号确定、版本不确定,又命中了多个版本的,把几个版本的含义并列给出来,请维修工看一眼设备上的版本号再选,不合并。
同一条线上不同厂家的设备,报警编号也可能撞车,比如主机 PLC 的报警号和某个驱动器的故障码恰好相同。设备一选定,这个问题自然就排除了。
四、外文手册:先建一张术语对照表
进口设备的手册,英文、日文、德文都有。问题出在叫法上:例如日文手册写"原点復帰",车间里有人叫"回零",有人叫"回原点";英文写 interlock,车间说"联锁"或"互锁"。维修工用车间叫法提问,检索就可能落空。
对照表做三列:原文术语、标准中文译法、车间常用叫法(可以有好几个)。提问时用对照表把车间叫法扩展成原文术语再去检索。回答给中文说明,后面附原文术语和原文页码;扭矩、端子号、参数编号这类内容照原文抄,不翻译,翻译拿不准的句子保留原文。
这张表要设备工程师和懂外语的人一起定,前期先按要上线的设备类别整理,再逐步补齐,后面随着"没答上来"的问题慢慢补。
五、维修工单比手册好用,但要先洗一遍
手册写的是厂家认为可能的原因,工单写的是这台设备在你厂里真实出过的毛病、谁修的、换了什么件。车间里很多问题,工单能答得更准。
但工单直接倒进去,效果往往不如不放。清洗时重点看几件事:
- 只写"已修好""正常"的,没有现象和措施,不进问答库,留着做统计;
- 设备名对齐台账:"2 号灌装""灌装机 2#""二线灌装机"统一成台账编码;
- 原因和措施拆开,很多工单把两者写在一句话里;
- 同一故障几天内反复报修的,前几次的措施标"未解决",只把真正修好的那次当参考;
- 临时处理要单独拎出来:短接、屏蔽报警、跳过某个检测,这类措施当时为了先开机,不能被当成推荐做法答出去。这一条很容易漏。
工单内容在回答里要标明"本厂历史维修记录",和厂家手册分开显示,让人知道哪句是厂家说的,哪句是同事做过的。
六、哪些问题不让它答
总的边界在第 34 篇写过。落到知识库上,要做成具体规则:
- 涉及安全联锁旁路、屏蔽或短接保护、带电作业、修改工艺和安全参数、解锁密码的问题,命中就转固定答复:"这类操作须由授权人员按规程执行,请联系设备主管";
- 手册里本身就写着改参数步骤的段落,入库时打"受限"标签,可以作为出处列出章节页码,正文步骤不由模型复述;
- 这份拦截清单由设备主管和安全员一起定,上线前逐条测一遍。
七、怎么评测,谁来维护
题库从历史报修里抽。翻近一两年的报修单和维修工群里的提问,先挑一批真实问题,按设备类别和问题类型铺开:代码含义、排查步骤、备件料号、参数范围,再专门放几道同码不同型号的题、外文手册的题、应当拒答的题。设备工程师逐条打分,分"对、部分对、错、该拒没拒"四档,出处页码要一条条点开核对。
上线后把"没答上来"记下来。每次答不上、或者维修工点了"没用"的,进一张清单。设备主管每周过一遍,判断原因:资料没进库、切分切坏了、对照表缺词,还是标签打错了。补完之后,这道题加进题库重测。
知识更新要落到人。设备科指定一位负责人。厂家发新版手册、设备升级固件、新设备进厂,资料同步进库;旧版本别删,标停用,因为厂里可能还有设备跑着旧固件。版本状态跟着设备台账走,设备报废了,对应资料再下线。
上海问源信息科技有限公司为制造企业实施 MES 与设备数据采集。设备问答项目应先核对设备台账、手册版本和维修记录,再确定资料处理与验证范围。相关能力见工业数据平台。
常见问题
- 设备手册直接上传给大模型,能不能用?
- 演示可以,车间用容易出错。没有按型号和版本切分、没有页码标签,同一个故障代码会答串型号,回答也给不出能核对的出处。
- 扫描版手册识别不准怎么办?
- 文字识别之后,故障代码表、参数表、备件表这几类必须人工抽查,表格单独转成结构化数据。接线图和电气图不让模型读,只做文字索引,回答时指到图号和页码。
- 维修工单要不要放进知识库?
- 要,但先清洗。设备名对齐台账、原因措施拆开、反复报修的只留修好的那次,短接、屏蔽报警这类临时处理要剔除或单独标注。
- 评测题库要多少题?
- 先从历史报修问题里挑一批,覆盖主要设备类别和问题类型,并包含同码不同型号的题和应当拒答的题。上线后再把答不上来的问题持续补进去。
