RAG — 技术文档检索
概述
PlantPulse RAG 是一套 RAG(Retrieval-Augmented Generation)检索服务器，可让 AI 即时检索并引用制造现场的技术文档、手册、SOP 与规程。
它通过 4 种检索模式提供准确且贴合上下文的文档检索，并支持多模态（图像、表格等）检索。
组成 — 前台是 RAG API，引擎是 LightRAG
文档检索分为两层。
- RAG API（
plantpulse-rag-api）— 用户与 AI 实际接触的一层，提供文档管理界面和 检索 API。 - LightRAG — 实际执行索引与检索的内部引擎。不对外暴露， 只能通过 RAG API 访问。
也就是说，无法直接打开 LightRAG 的地址或 WebUI（/webui）。所有文档操作都在 RAG API
界面中完成。（原自研服务器 plantpulse-rag 已归档，LightRAG WebUI 直接上传的路径自 2026-07-30 起
由下述 Documents 界面取代。）
检索模式
| 模式 | 说明 | 适用场景 |
|---|---|---|
| hybrid（默认） | Dense + Sparse 组合 | 常规文档检索（推荐） |
| naive | 语义（基于含义）检索 | 概念性提问、查找相似文档 |
| local | 文档内细节检索 | 确认特定文档的细节内容 |
| global | 文档间关系检索 | 跨多份文档的综合信息 |
使用入口
| 要做的事 | 在哪里 |
|---|---|
| 通过聊天提问 | AI Chat Web — 内置智能体会自动调用 rag_search 工具 |
| 仅直接执行检索 | RAG API 仪表板的 Query 界面 |
| 上传、删除、查看文档列表 | RAG API 仪表板的 Documents 界面 |
| 查看自动同步结果 | RAG API 仪表板的 Sync History 界面 |
| 查看索引失败原因 | RAG API 仪表板的 Logs 界面 |
文档进入的两条路径
文档通过两种方式被索引。取决于进入路径的不同，管理方式也不同。
| 路径 | 来源 | 说明 |
|---|---|---|
| 自动同步 | Platform 中设备的附件文档 | 在 Platform 中将文档附加到设备后，会定期自动索引。无需在 RAG 侧另行上传 |
| 手动上传 | Documents 界面 | 直接上传不属于某台设备的文档（通用规程、培训资料等）。原始文件单独保存，重新索引后依然保留 |
设备文档请在 Platform 中管理
若将设备附属文档手动上传到 RAG，会与 Platform 的文档台账产生不一致。 设备文档应在 Platform 中附加到设备上，RAG 侧交由自动同步处理，管理更简单。
多模态支持
支持包含文本 + 图像 + 表格等多模态内容的检索：
- 附上设备照片提问“这个部件是什么？”
- 仪表盘照片 → 检索相关设置手册
- 支持图像 URL 或 Base64 数据
文档从入库到可检索
문서 등록 (플랫폼 설비 첨부 / Documents 화면 업로드)
│
▼
파싱 — PDF·DOCX·이미지에서 텍스트와 표를 추출
│
▼
청킹 — 검색 단위로 잘게 나눔
│
▼
임베딩 — 각 조각을 벡터로 변환
│
├──▶ 벡터 저장소 (유사도 검색)
└──▶ 지식 그래프 (엔티티·관계 추출)
刚登记后还无法立即检索。必须完成解析与嵌入才会出现在结果中， 因此如果刚上传的文档搜不到，请先在 Sync History 界面确认处理状态。
可管理的文档类型
| 文档类型 | 示例 | AI 应用 |
|---|---|---|
| 维护手册 | 各设备定期巡检流程、润滑油更换周期 | 检测到异常时立即提供合适的处置方案 |
| SOP | 各工序作业流程、安全流程、质量检验标准 | 分步骤的准确作业指导 |
| 安全规程 | 化学品 MSDS、安全卫生规程、应急响应手册 | 危险情况下即时引用规程 |
| 技术规格书 | 设备规格、传感器规格、允许范围 | 引用异常判定基准值 |
| 事故/故障报告 | 过往故障案例、原因分析、防再发对策 | 基于相似案例推断原因 |
| 培训资料 | 新员工培训教材、工序说明书、质量培训 | 支持现场培训 |
设置
嵌入模型、分块大小、Top-K 等检索参数属于 LightRAG 引擎侧的设置，无法在界面中修改。当前生效的取值可在 RAG API 仪表板的 Config 界面查看（令牌与密码会以掩码显示）。
运行过程中需要调整的通常是同步相关项。
| 项目 | 说明 |
|---|---|
| 是否启用同步 | 开启或关闭 Platform 设备文档的自动索引 |
| 同步周期 | 检查 Platform 文档变更的时间间隔 |
| 单次索引文档数 | 每个周期处理的上限 — 用于初期大量导入时调节负载 |
| 最大文件大小 | 超过该大小的文档将被跳过 |
应用场景
| 场景 | 检索示例 |
|---|---|
| 确认维护流程 | “注入机轴承更换方法” → 维护手册 |
| 引用安全规程 | “氮气泄漏时的应对流程” → 应急响应手册 |
| 异常处置指导 | “温度传感器异常时的巡检项目” → 巡检 SOP |
| 检索过往案例 | “去年 3 号线注入机故障原因” → 故障报告 |
| 确认规格 | “注入机允许温度范围” → 技术规格书 |