1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Production Ready RAG】TXT・Markdown・CSVから始める KB → Profile → Chat チュートリアル

1
Posted at

PDFを使った前回の KB → Profile → Chat チュートリアルに続き、今回は TXT・Markdown・CSV の3ファイルで同じ流れを試します。

題材は、架空の「ソラノ実験室」の備品貸出です。貸出ルールは TXT、返却・延長の手順は Markdown、在庫の一覧は CSV に分けました。ひとつの形式だけで完結しない質問を使い、回答と原文のつながりまで確かめます。

この記事の資料・組織名・備品コード・数値は、公開用に新しく作った合成データです。実在の組織の規程や在庫ではありません。画面と検証結果は2026年11月18日時点のものです。

今回のゴール

01_貸出ルール.txt ──────────┐
02_返却と延長の手順.md ────┼→ KB → 検索・回答プロファイル → Chat
03_備品在庫.csv ────────────┘                            ↓
                                                   回答の根拠を開く

最初に、画面で使う3つの役割を整理します。

名前 今回の役割
ナレッジベース(KB) 3つの資料をまとめ、検索対象の範囲を決める
処理レシピ 文書ごとの準備・抽出・Chunk作成・Embedding/索引の設定を持つ
検索・回答プロファイル(Profile) どのKBを参照し、どの回答方針を使うかを決める。Chatではこれを選ぶ

KBを作っただけでは回答できません。文書のアップロード、取込と索引の完了、ProfileへのKB設定、ChatでのProfile選択まで進めます。

1. UTF-8で3つの合成ファイルを用意する

記事の末尾に3ファイルの全文を載せました。それぞれ指定の名前で、UTF-8のテキストファイルとして保存できます。

ファイル 内容 答え合わせに使う値
01_貸出ルール.txt 利用条件、貸出期間、返却時刻 PICO-P2は受取日を含め最大3営業日、私用不可、最終営業日17:00返却
02_返却と延長の手順.md 返却手順、延長の申請期限、故障時の対応 返却予定日の前営業日16:00までに申請。申請と承認は別
03_備品在庫.csv 備品ごとの保有数・貸出中・予約確保・貸出可能数 PICO-P2は6−3−1=2台。基準日時は2026-11-18 10:00

CSVでは、列名だけを切り離すと数値の意味が分からなくなります。そのため備品コード、数値、基準日時を同じ行にまとめました。また、CSVの数量は基準日時のスナップショットと明記しています。

2. 今回の資料だけを入れるKBを作る

ナレッジ構築 → ナレッジベース → 新規作成を開き、名前と説明を入力します。

  • 名前:合成備品貸出 TXT-MD-CSV 20261118
  • 説明:公開チュートリアル用。TXTの貸出ルール、Markdownの延長手順、CSVの在庫表だけを参照する合成KB。

今回の合成資料用KBの新規作成

既存の業務資料と混ざらないように、このKBには今回の3ファイルだけを入れます。

3. KBを選んで3ファイルをアップロードする

ナレッジ構築 → 文書アップロードを開きます。

  1. 「所属させるナレッジベース」で、作ったKBを選びます。
  2. TXT、MD、CSVの3ファイルを選びます。
  3. 選んだファイルの名前と件数を確認します。
  4. **アップロードを開始(3件)**を押します。

今回の結果は、選択3件・保存済み3件・失敗0件でした。3つとも原本判定は「テキスト構造化」です。

ここで終わりではありません。アップロードは原本の保存であり、検索用の索引は次の手順で作ります。

4. 各文書の処理を開始し、「索引済み」を確認する

アップロード結果の「文書詳細を開く」、または「文書インデックス」から、各文書の詳細を開きます。今回は各文書にある「レシピ1」の 処理を開始を押しました。

ファイル準備 → 抽出 → Chunk 作成 → Embedding / 索引

今回の環境では、各工程の「次へ進む」が有効だったため、最初の開始から索引まで進みました。環境によっては途中の工程を手動で開始する設定になっているため、処理レシピの表示を確認してください。

形式ごとの設定は次のとおりでした。これは今回の環境で確認した値です。拡張子が同じなら、どの環境でも必ず同じ設定になるという意味ではありません。

形式 ファイル準備 文書解析 文書分割
TXT 変換なし Unstructured 親子階層(small-to-big)
MD 変換なし Unstructured 構造認識
CSV CSV → JSONL 構造化レコード JSONL 固定分割符

CSVの文書詳細では、CSV → JSONLの準備と、構造化レコードとしての抽出を確認できました。

CSVの処理レシピと索引完了

KBの詳細に戻り、文書3件・索引済み3件・エラー0件になっていることを確かめます。

3つの資料が同じKBに所属し、すべて索引済みになった状態

5. このKBを参照するProfileを作る

ナレッジ構築 → 検索・回答プロファイル → 新規作成を開きます。

  • 名前:合成備品貸出の回答 20261118
  • 説明:公開合成資料3件だけを参照し、貸出条件・延長手順・在庫スナップショットを根拠付きで回答する。
  • 参照するナレッジベース:合成備品貸出 TXT-MD-CSV 20261118 の1件だけ

Profileの名前・説明・参照KBを設定

今回は、回答モデルと「1つの文書から採る根拠の上限」はグローバル既定を継承しました。業務ガイドとWikiの使用はOFFのままです。既存の全体設定は変更していません。

「説明」は一覧で用途を区別するための欄です。説明文を書くだけで、回答プロンプトそのものを設定したことにはなりません。

入力を確認したら 作成を押します。

6. ChatでProfileを選ぶ

AI活用 → チャット → 新しい会話を開き、右上の検索・回答プロファイルで 合成備品貸出の回答 20261118 を選びます。

Chatで今回作ったProfileを選択

KBの名前とProfileの名前は別です。ここでは、KBを参照するProfileを選びます。

今回はこのProfileの同じ会話で、次の4問を順に確認しました。画面に表示された回答モデルは xai.grok-4.7 です。モデル・取込設定・検索設定が異なる場合、文章や引用の粒度は変わり得ます。

7. TXTのルールを質問し、根拠を開く

PICO-P2は何営業日借りられますか。私用に使えますか。返却時刻も教えてください。

回答では、次の3点を確認できました。

  • 受取日を含めて最大3営業日。土日・祝日は数えない
  • 私用には使えない
  • 最終営業日の17:00までに返却する

貸出期間・私用不可・返却時刻の回答

回答の「根拠:01_貸出ルール.txt」を開くと、引用元の本文が表示されます。

TXTの引用元の本文とハイライト

今回のTXTでは、引用の元となる段落のまとまりがハイライトされています。回答の一文と、ハイライトされた原文の条件が一致するかを読み比べます。画面に p.1 と表示されても、TXTに紙のページが存在するわけではありません。

8. Markdownの延長手順を質問する

PICO-P2の延長申請はいつまでに、どこで行いますか。申請すれば必ず延長できますか。

回答は、返却予定日の前営業日16:00までに「備品貸出フォーム」の延長欄から申請すると説明しました。入力するのは備品コード、現在の返却予定日、希望する新しい返却日、利用目的です。

さらに、次の予約がある場合は延長できず、申請だけでは承認にならないことも回答しました。該当するMarkdownの引用を伴っており、期限と承認条件の両方を確認できました。

Markdownの延長手順に基づく回答

9. TXTとCSVをまたぐ質問をする

在庫表の基準日時を明示して、PICO-P2の貸出可能数、貸出期間、付属品をまとめてください。

回答では、CSVから基準日時 2026-11-18 10:00、貸出可能数 2(保有数6、貸出中3、予約確保1)、付属品の電源アダプター・HDMIケーブルを取得しました。貸出期間はTXTを引用して、受取日を含め最大3営業日と回答しました。

「現在値ではなく、その時点のスナップショット」と説明している点も確認します。CSVの根拠を開くと、原本の行2に対応するPICO-P2の記録が、列名付きで強調されました。下には別の備品の記録が追加の参考文脈として表示され、この引用に含まれる記録と区別できました。

なお、この回答では強調用の ** が画面上に文字として残りました。以下は実際の表示のままです。数値と出典の対応は確認できていますが、装飾表示には改善の余地があります。

TXTとCSVにまたがる回答

CSVの引用元を開いてレコードを確認

ここでは、数量だけでなく基準日時と出典のレコードも確認します。このCSVを登録しても実在庫システムと同期されるわけではありません。更新する場合は、資料の更新と再取込・索引の反映を別途管理する必要があります。

10. 資料に書いていないことも聞く

PICO-P2を紛失した場合の弁償額はいくらですか。延長料金も金額で教えてください。

この2つの金額は、3資料のどこにも書いていません。Markdownには「この手順には書いていないこと」として、延長料金と紛失時の弁償額を明記してあります。

実際の回答も、弁償額と延長料金は資料で定められておらず、金額を推測して示すことはできない、と説明しました。そのうえで担当者への確認を案内しています。

今回は「根拠が1件も取得できない」ケースではありません。未記載であることを示すMarkdownを取得・引用し、分かる貸出条件と分からない金額を分けて回答したケースです。

未記載の金額を質問したときの回答

再現するときの確認ポイント

症状 最初に確認すること
アップロードしたのに検索されない 保存だけで止まっていないか。各文書が「索引済み」になっているか
別の資料が回答に混ざる 文書の所属KB、Profileの参照KB、Chatで選んだProfileの3箇所
CSVの数値の意味が不明になる 列名と値が抽出されているか。備品コードと基準日時を同じレコードで確認できるか
期待する条件が回答にない 原文の条件、抽出結果、Chunk、取得された根拠の順に確認する
「分からない」と返る 資料に答えがあるかを先に確認する。資料にない答えを生成させて解決しない

今回の4問では、ルールの参照、手順の参照、形式をまたぐ参照、未記載事項の扱いを確認しました。各1回の動作確認なので、回答品質全体を保証する評価ではありません。実運用では、表記ゆれ、資料間の矛盾、旧版の除外、アクセス権、在庫の更新頻度などを別途検証してください。

付録:今回使った3つの合成ファイル

以下の内容を、それぞれのファイル名でUTF-8保存してください。記事内に全文を載せているので、外部のサンプルダウンロード先は不要です。

01_貸出ルール.txt(クリックして展開)
01_貸出ルール.txt
ソラノ実験室 備品貸出ルール
公開可能な架空のチュートリアル資料です。会社・製品・数値はすべて合成データです。
文書ID: DEMO-LOAN-20261118
適用日: 2026年11月18日

1. 利用できる人と用途
利用できるのはソラノ実験室のメンバーです。備品は業務上の打合せ・研修・検証に限って貸し出します。個人の旅行や私用には貸し出しません。

2. 貸出期間
プロジェクター PICO-P2 の貸出期間は、受取日を含めて最大3営業日です。
会議用マイク TALK-M4 の貸出期間は、受取日を含めて最大5営業日です。
営業日は月曜日から金曜日です。土日と祝日は数えません。

3. 予約と受取
予約時には備品コード、利用目的、受取希望日、返却予定日を登録してください。
予約済み数量は在庫数に含めて利用可能と考えないでください。
受取時に付属品を確認してください。PICO-P2には電源アダプターとHDMIケーブルが付属します。

4. 返却
返却期限は最終営業日の17:00です。
延長や故障時の連絡方法は「02_返却と延長の手順.md」を確認してください。
現在の貸出可能数は「03_備品在庫.csv」のスナップショットで確認してください。
02_返却と延長の手順.md(クリックして展開)
02_返却と延長の手順.md
# ソラノ実験室:返却と延長の手順

このファイルは公開可能な架空の合成資料です。実在の組織の運用規程ではありません。
更新日:2026年11月18日。文書ID:DEMO-RETURN-20261118。

## 返却する

1. 電源を切り、持ち出した付属品をそろえます。
2. 最終営業日の17:00までに備品カウンターへ返却します。
3. カウンターで外観と付属品の確認を受け、返却完了を記録します。

## 延長を申し込む

返却予定日の前営業日16:00までに「備品貸出フォーム」の延長欄から申請します。
延長申請には備品コード、現在の返却予定日、希望する新しい返却日、利用目的を入力します。
次の予約がある場合、延長はできません。申請しただけでは承認にならず、担当者の承認結果を確認します。

## 故障や不足があった場合

故障が疑われるときは使用を中止し、電源を切ります。
備品コードと症状を「備品貸出フォーム」の不具合欄へ記入し、担当者に連絡します。
利用者が分解・修理をしてはいけません。

## この資料に含まれない情報

延長料金、紛失時の弁償金額、休日の特別貸出は、この資料では定めていません。
これらの条件を推測して回答せず、担当者へ確認してください。
03_備品在庫.csv(クリックして展開)
03_備品在庫.csv
備品コード,備品名,保有数,貸出中,予約確保,貸出可能数,付属品,基準日時,注記
PICO-P2,小型プロジェクター,6,3,1,2,電源アダプター・HDMIケーブル,2026-11-18 10:00,公開可能な合成データ。現在値ではなく基準日時のスナップショット
TALK-M4,会議用マイク,8,2,2,4,USBケーブル・収納袋,2026-11-18 10:00,公開可能な合成データ。現在値ではなく基準日時のスナップショット
CAM-C7,会議用カメラ,5,1,1,3,USBケーブル・三脚,2026-11-18 10:00,公開可能な合成データ。貸出期間は別途担当者に確認
1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?