RAG — 기술 문서 검색
개요
PlantPulse RAG는 제조 현장의 기술 문서, 매뉴얼, SOP, 규정을 AI가 즉시 검색하고 참조할 수 있게 하는 RAG(Retrieval-Augmented Generation) 검색 서버입니다.
4가지 검색 모드를 통해 정확하고 맥락에 맞는 문서 검색을 제공하며, 멀티모달(이미지, 테이블 등) 검색도 지원합니다.
문서 검색은 두 층으로 나뉩니다.
- 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 화면 |
문서가 들어오는 두 경로
문서는 두 가지 방법으로 색인됩니다. 어느 쪽으로 들어왔는지에 따라 관리 방법이 다릅니다.
| 경로 | 출처 | 설명 |
|---|---|---|
| 자동 동기화 | 플랫폼의 설비 첨부 문서 | 플랫폼에서 설비에 문서를 붙이면 주기적으로 자동 색인됩니다. RAG 쪽에서 따로 올릴 필요가 없습니다 |
| 수동 업로드 | Documents 화면 | 설비에 속하지 않는 문서(공통 규정, 교육 자료 등)를 직접 올립니다. 원본은 별도 보관되어 재색인에도 살아남습니다 |
설비에 딸린 문서를 RAG 에 수동으로 올리면 플랫폼의 문서 원장과 어긋납니다. 설비 문서는 플랫폼에서 설비에 붙이고, RAG 는 자동 동기화에 맡기는 편이 관리가 단순합니다.
멀티모달 지원
텍스트 + 이미지 + 테이블 등 멀티모달 콘텐츠 포함 검색을 지원합니다:
- 설비 사진 첨부하여 "이 부품이 뭔가요?" 질의
- 계기판 사진 → 관련 설정 매뉴얼 검색
- 이미지 URL 또는 Base64 데이터 지원
문서가 검색되기까지
문서 등록 (플랫폼 설비 첨부 / Documents 화면 업로드)
│
▼
파싱 — PDF·DOCX·이미지에서 텍스트와 표를 추출
│
▼
청킹 — 검색 단위로 잘게 나눔
│
▼
임베딩 — 각 조각을 벡터로 변환
│
├──▶ 벡터 저장소 (유사도 검색)
└──▶ 지식 그래프 (엔티티·관계 추출)
등록 직후에는 아직 검색되지 않습니다. 파싱과 임베딩이 끝나야 결과에 나타나므로, 방금 올린 문서가 안 잡히면 Sync History 화면에서 처리 상태를 먼저 확인하세요.
관리 가능한 문서 유형
| 문서 유형 | 예시 | AI 활용 |
|---|---|---|
| 정비 매뉴얼 | 설비별 정기점검 절차, 윤활유 교체 주기 | 이상 감지 시 적절한 조치 방안 즉시 제공 |
| SOP | 공정별 작업 절차, 안전 절차, 품질 검사 기준 | 작업 단계별 정확한 가이드 |
| 안전 규정 | 화학물질 MSDS, 안전보건 규정, 비상 대응 매뉴얼 | 위험 상황 시 즉각적인 규정 참조 |
| 기술 사양서 | 설비 스펙, 센서 사양, 허용 범위 | 이상 판정 기준값 참조 |
| 사고/고장 보고서 | 과거 고장 사례, 원인 분석, 재발 방지 대책 | 유사 사례 기반 원인 추정 |
| 교육 자료 | 신입 교육 교재, 공정 설명서, 품질 교육 | 현장 교육 지원 |
설정
임베딩 모델·청크 크기·Top-K 같은 검색 파라미터는 LightRAG 엔진 쪽 설정이며 화면에서 바꿀 수 없습니다. 현재 적용된 값은 RAG API 대시보드의 Config 화면에서 확인할 수 있습니다 (토큰·비밀번호는 마스킹되어 표시됩니다).
운영 중 조정할 일이 있는 것은 대개 동기화 쪽입니다.
| 항목 | 설명 |
|---|---|
| 동기화 사용 여부 | 플랫폼 설비 문서 자동 색인을 켜고 끕니다 |
| 동기화 주기 | 플랫폼 문서 변경을 확인하는 간격 |
| 한 번에 색인할 문서 수 | 한 주기에 처리할 상한 — 초기 대량 유입 시 부하 조절용 |
| 최대 파일 크기 | 이 크기를 넘는 문서는 건너뜁니다 |
활용 시나리오
| 시나리오 | 검색 예시 |
|---|---|
| 정비 절차 확인 | "주입기 베어링 교체 방법" → 정비 매뉴얼 |
| 안전 규정 참조 | "질소 가스 누출 시 대응 절차" → 비상 대응 매뉴얼 |
| 이상 조치 가이드 | "온도 센서 이상 시 점검 항목" → 점검 SOP |
| 과거 사례 검색 | "작년 3라인 주입기 고장 원인" → 고장 보고서 |
| 규격 확인 | "주입기 허용 온도 범위" → 기술 사양서 |