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 (既定) | local + global — ナレッジグラフのエンティティと関係を併用 | 一般的な文書検索 (推奨) |
| naive | 文書断片のベクトル類似度のみ(グラフは使わない) | 概念的な質問、類似文書探索 |
| local | 質問に出てくるエンティティ(設備・部品など)中心 | 特定対象の詳細内容確認 |
| global | エンティティ間の関係中心 | 複数文書にまたがる総合情報 |
この4つ以外のモード名を指定すると、検索を行わず拒否します(REST 422) → RAGアルゴリズム
利用経路
| すること | どこで |
|---|---|
| チャットで尋ねる | コパイロットの質問 — エージェントが MCP ゲートウェイ を経由して RAG API の rag_search ツールを自動呼び出しします(下記«チャットの文書検索はゲートウェイ経由のみ»)。回答下の根拠カード(文書・図面・映像)を押すと文書原文・図面・映像が会話横の右パネルに開きます → 質問 — 右パネル |
| 検索だけ直接試す | RAG API ダッシュボードの Query 画面 |
| 文書のアップロード・削除・一覧表示 | RAG API ダッシュボードの Documents 画面 |
| 自動同期結果の確認 | RAG API ダッシュボードの Sync History 画面 |
| 索引失敗の原因確認 | RAG API ダッシュボードの Logs 画面 |
コパイロットには 内蔵の文書検索がありません。 チャットの文書検索は MCP ゲートウェイの背後にある RAG ツール rag_search 1 つです。
- ゲートウェイは
rag_search・rag_list_documentsを 最初からオンにしています。 管理者がオフにするとチャットが文書を見つけられません。 - 文書が見つからない場合、管理者は AI 管理コンソール › MCP ゲートウェイ › サーバー で RAG Gateway サーバーがオンか、ツール で
rag_searchがオンかを確認します → AI 管理コンソール — MCP ゲートウェイ - ユーザー側にはチャットツール権限(
tool:mcp)が必要です → 権限 - オフになっているかゲートウェイが応答しなければ、マニュアル・図面・手順の質問に回答を作らずブロックします — 「文書検索を今は使えません(MCP ゲートウェイ応答なし) …」 または「文書検索ツールがオフになっているか、このアカウントに許可されていません …」 → 質問 — 回答が途切れたり停止したとき
- RAG API ダッシュボードの クエリテスト と文書原文・映像再生はゲートウェイを経由しないため、これらの画面は動くのにチャットだけ文書を見つけられない場合はゲートウェイ側の問題です。
チャットで文書原文を開く
質問の回答下の文書根拠カードを押すと、その文書の原文が右パネルに開きます。文書画面に移動したり新しいタブが開いたりはしません。
| 文書 | パネルでの表示 |
|---|---|
| ブラウザのPDF表示のままパネル内に開きます。ヘッダーに新しいタブで開く・原本ダウンロード | |
| PDF以外の形式(Word・Excel・テキストファイルなど) | パネル内には描画されません — 「この形式はここで表示できません。原本をダウンロードして開いてください」 と 原本ダウンロード |
| PDFを画面内に描画できないブラウザ(スマートフォンなど) | 「このブラウザにはPDF表示機能がありません。原本をダウンロードして開いてください」 と 原本ダウンロード |
| 統制等級文書 | 「統制等級文書です。原本を開いたりダウンロードしたりできません」 — 開く・ダウンロードボタンがありません |
- 文書検索が回答の根拠となった箇所を見つけると、カードに引用箇所(ページ情報がわかるPDFなら「12ページ」も)が付き、パネルは上部にその箇所を表示しそのページで開きます。 ページがわからない文書(PDF以外の文書・文字が読み取れないスキャンPDF・ページ情報がまだ生成されていない文書)は1ページ目で開きます。 箇所やページが付かない出典もよくあります — 特に図・スキャンページが混在する文書は誤ったページを示さないようページを付けません。引用箇所は原文の文章か表の一行です。
- 🔴 文字層のない韓国語スキャンPDFは読み取れません。 文字層のあるPDFとしてアップロードしてください。
- 権限と閲覧等級は開くたびに再確認します。閲覧できない文書は「この文書を閲覧する権限がありません」と回答します → 権限
- 索引は残っているが保管された原本がない場合は「原文が見つかりません。保管された原本がないか、文書が削除されています」となります。
- 提案の根拠に付いた文書も同じパネルで開きます。
- 文書カードのタイトルは「設備名・文書名」で(直接アップロードした文書は「共通文書・文書名」)、パネルヘッダーには文書名が表示されます。 同じ文書の複数箇所は1枚のカードにまとめられます。
- AIが検索のみ行い回答に使わなかった文書は、根拠カードとして付きません。
対話に追加したファイルとは別です
質問の入力欄の ファイルを追加 で入れたファイルは、映像・音声も含めてこの文書検索には 入りません。 両者は別々にあります。
| 文書検索(RAG) | 対話に追加したファイル | |
|---|---|---|
| 入れる人 | 管理者(Documents 画面・管理コンソール)・プラットフォームの自動同期 | 尋ねる人 — 入力欄の ファイルを追加 |
| 使われる場所 | すべての人のすべての対話(権限・閲覧等級の範囲内) | その対話 1 つ — その対話の所有者だけが見られます |
| AI の読み方 | rag_search で関連する箇所を探します | 追加したファイルのページ・シート・スライドを、映像・音声は文字起こしの区間を直接読みます |
| 映像の再生 | ログインした人なら誰でも | その対話の所有者だけ |
| 削除される時 | 管理者が削除するか台帳から外れたとき | 対話を削除するとき一緒に |
- 複数の人が繰り返し探す文書(マニュアル・SOP・規定)は文書検索に登録します。今この質問にだけ使うファイルは対話に追加します。
- 対話に追加したファイルを文書検索に移す機能はありません。同じファイルを管理者が別途登録します。
- 追加方法と上限(50MB・映像・音声 1GB・60 分・対話ごとに 20 個・先頭 100 ページ)は AI チャット — ファイルを追加 にあります。
文書が取り込まれる二つの経路
文書は二つの方法で索引されます。どちらの経路で入ってきたかにより管理方法が異なります。
| 経路 | 出所 | 説明 |
|---|---|---|
| 自動同期 | プラットフォームの設備添付文書 | プラットフォームで設備に文書を添付すると定期的に自動索引されます。RAG側で別途アップロードする必要はありません |
| 手動アップロード | Documents 画面 | 設備に属さない文書(共通規定、教育資料など)を直接アップロードします。原本は別途保管され再索引にも残ります |
設備に付属する文書をRAGに手動でアップロードすると、プラットフォームの文書台帳とずれが生じます。 設備文書はプラットフォームで設備に添付し、RAGは自動同期に任せる方が管理がシンプルです。
文書内の表・図
PDF・DOCX・PPTX・XLSX は索引時に図・表・数式を別途抽出し、図には Aura が説明文を 付けて一緒に索引します。そのため「この図面のバルブ番号」のように図の中にあった内容も検索に 引っかかることがあります。
検索語は文章です。チャットに写真を添付して計器値・銘板の文字を読み取らせるのは ビジョンツールが行うことであり、必要であればAIがその結果を使って再度文書を 検索します → 質問 — 写真で質問
図面・映像も検索します — 有効化が必要です
管理者が有効にすると、RAGは文書のほかに図面と映像・音声も索引します。どちらも既定では無効です。
| 対象 | 受け付ける形式 | 回答に付くもの | 有効化スイッチ |
|---|---|---|---|
| 図面 | dxf・ベクトルPDF(アップロード時に«図面»と指定、またはプラットフォーム台帳の文書種類が図面) | 図面カード — ページプレビューでその箇所を強調、版バッジ、最新版との比較 | DRAWING_INGEST_ENABLED |
| 映像・音声 | 映像 mp4・mov・mkv・webm、音声 m4a・mp3・wav、付帯字幕 srt・vtt | シーンカード — その時刻から回答内で再生 | 設置スイッチ PI_MEDIA_ENABLED |
使い方と制限は 図面で質問・映像・音声で質問、有効化方法は 環境設定にあります。映像・音声を有効にすると、質問入力欄の音声で質問(マイク)も併せて有効になります。
文書が検索されるまで
문서 등록 (플랫폼 설비 첨부 / Documents 화면 업로드)
│
▼
파싱 — PDF·DOCX·이미지에서 텍스트와 표를 추출
│
▼
청킹 — 검색 단위로 잘게 나눔
│
▼
임베딩 — 각 조각을 벡터로 변환
│
├──▶ 벡터 저장소 (유사도 검색)
└──▶ 지식 그래프 (엔티티·관계 추출)
登録直後はまだ検索できません。パースと埋め込みが完了して初めて結果に現れるため、 アップロードしたばかりの文書が見つからない場合はSync History画面で処理状況を先に確認してください。
索引される形式は6種類です
PDF・DOCX・PPTX・XLSX・MD・TXT のみ索引します(図面・映像を有効にすると上表の形式が追加されます)。自動同期がこれ以外の文書に 遭遇すると、索引せずスキップ理由を集計し同期結果に残します。
| スキップ理由 | 意味 | 修正箇所 |
|---|---|---|
ext_not_allowed | 上記6種類以外の拡張子 | 形式を変更して再添付します |
ext_unknown | 拡張子が不明 — 台帳にファイル形式がなく文書名にも拡張子がない | プラットフォーム側の文書台帳 |
size_over_limit | 最大ファイルサイズ(既定50 MB)を超過 | ファイルを分割するか上限を引き上げます |
ingest_failed | 受け付けたが索引段階で失敗 | plantpulse-lightrag ログ → トラブルシューティング |
/health の ingest で確認しますストレージが全て生きていても、文書が一件も取り込まれない状態があります。RAG API の /health は
最後の同期結果を ingest で知らせてくれ、ok・disabled でなければ全体 status は degraded です。
ingest | 意味 |
|---|---|
ok | 最後の同期が成功しました |
error | 最後の同期が失敗しました |
unknown | まだ一度も実行されていないか履歴を読み取れません — «正常» ではありません |
disabled | 同期を無効にしています |
運用者が除外した文書は、全体再索引(Reindex All)を実行しても除外されたまま残ります。
管理可能な文書種類
| 文書種類 | 例 | AI活用 |
|---|---|---|
| 整備マニュアル | 設備別定期点検手順、潤滑油交換周期 | 異常検知時に適切な対処方法を即座に提供 |
| SOP | 工程別作業手順、安全手順、品質検査基準 | 作業段階ごとの正確なガイド |
| 安全規定 | 化学物質MSDS、安全保健規定、緊急対応マニュアル | 危険状況時の即座の規定参照 |
| 技術仕様書 | 設備スペック、センサー仕様、許容範囲 | 異常判定基準値の参照 |
| 事故/故障報告書 | 過去の故障事例、原因分析、再発防止対策 | 類似事例に基づく原因推定 |
| 教育資料 | 新入社員教育教材、工程説明書、品質教育 | 現場教育支援 |
設定
埋め込みモデル・チャンクサイズ・Top-Kといった検索パラメータはLightRAGエンジン側の設定であり、画面からは変更できません。現在適用されている値はRAG APIダッシュボードのConfig画面で確認できます(トークン・パスワードはマスキングされて表示されます)。
運用中に調整することが多いのは大抵同期側です。
| 項目 | 説明 |
|---|---|
| 同期使用有無 | プラットフォーム設備文書の自動索引をオン/オフします |
| 同期周期 | プラットフォーム文書の変更を確認する間隔 |
| 一度に索引する文書数 | 1周期で処理する上限 — 初期大量流入時の負荷調整用 |
| 最大ファイルサイズ | このサイズ(既定50 MB)を超える文書はスキップします |
活用シナリオ
| シナリオ | 検索例 |
|---|---|
| 整備手順確認 | "インジェクターベアリングの交換方法" → 整備マニュアル |
| 安全規定参照 | "窒素ガス漏洩時の対応手順" → 緊急対応マニュアル |
| 異常対処ガイド | "温度センサー異常時の点検項目" → 点検SOP |
| 過去事例検索 | "昨年3ラインのインジェクター故障原因" → 故障報告書 |
| 図面の寸法・版 | "Ø62 H7 はどこ？" → 図面・ページ・区域 (図面収集を有効にした場合) |
| 教育映像のシーン | "ベアリング圧入前に何を確認する？" → 整備教育映像のその時刻 (映像・音声を有効にした場合) |
| 規格確認 | "インジェクターの許容温度範囲" → 技術仕様書 |