ナレッジベースと文書検索
公開日
ナレッジベースは、Ai FlowiのAI Flowi Workflowで文書の内容を保存し、ワークフロー内で検索・取得するために使います。ベースを作成し、埋め込みモデルを選んでソースファイルを追加し、チャンクを確認した後、Knowledge Baseコンポーネントを使って、ワークフローに必要な内容を取得します。
製品： Ai FlowiのAI Flowi Workflow · 作業： ナレッジを作成して文書の内容を取得 · コンポーネント： Knowledge Base
使用する場面
ワークフローでソース文書の内容を検索する必要がある場合に、ナレッジベースを使います。
始める前に
- PDF、DOCX、TXT、Markdown、CSVなど、対応する形式のソースファイルを用意します。
- 利用可能な埋め込みモデルを選び、そのプロバイダーが必要とする認証情報を設定します。
- 他と区別できるベース名を付け、ベースを削除する前に元のファイルのコピーを保存しておきます。
手順
1. Add Knowledge（ナレッジを追加）
Knowledgeを開き、Add Knowledgeを選択してCreate Knowledge Baseを開きます。
Nameを入力し、Embedding Modelを選びます。
Configure Sourcesを開かずにCreateを選択すると、ファイルがアップロードされていない空のベースが作成されます。
2. Configure Sources（ソースを設定）
Configure Sourcesを選択し、続いてAdd Sourcesと、Upload FilesまたはUpload Folderを選択します。
非対応のファイル形式はスキップされ、アラートに一覧表示されます。
Chunking Settingsで、Chunk Size、Chunk Overlap、Separatorを設定します。
Chunk Sizeはチャンクの最大長を指定します。Chunk Overlapは隣り合うチャンク間で文字を重複させます。Separatorはテキストを分割する位置を指定します。
3. Review & Build（確認して構築）
Review & Buildに進み、必要に応じてファイルを切り替えながらChunk Previewを確認します。
SummaryでName、Files、Chunk Size、Chunk Overlap、Separator、Embedding Modelを確認し、Createを選択します。
ダイアログが閉じた後も取り込み処理は続きます。ナレッジ一覧でReadyになるまで待ってから、検索・取得をテストしてください。
4. View Chunks（チャンクを表示）
ベースの行、またはそのView Chunks操作を開き、保存されたテキストを確認します。
Search chunks…で内容を絞り込み、コピーアイコンでチャンクをコピーします。結果が多い場合は、Per page:またはページ操作で表示を切り替えます。
5. Knowledge Base
ワークフローにKnowledge Baseコンポーネントを追加し、Knowledgeでベースを選んで、Search Queryを入力します。
Top K Resultsで取得する結果の件数を指定し、Include Metadataでソースのメタデータを保持するか設定します。
コンポーネントを実行し、取得した内容を含むテーブルであるResultsを確認します。
ソース文書に答えが含まれる質問でテストし、取得した内容をView Chunksの表示と比較します。
6. Update Knowledge（ナレッジを更新）
ベースのメニューからUpdate Knowledgeを選択すると、既存のベースに対するAdd Sourcesが開きます。
既存のNameとEmbedding Modelは変更できません。新しいファイルをアップロードし、設定を確認してAdd Sourcesを選択します。
よくある間違い
- 空のベースに、すでに文書が取り込まれていると思い込むこと。
- アップロードのダイアログが閉じれば、取り込み処理も完了していると思い込むこと。
- 元のソースファイルを保存せずにベースを削除すること。削除の確認画面には、この操作を元に戻せないという警告が表示されます。
トラブルシューティング
| 状態／メッセージ | 次に確認すること |
|---|---|
| 空 | Update Knowledgeからソースファイルを追加してください。 |
| 取り込み中／キャンセル中 | 状態が確定するまで待ってください。Stop Ingestionはキャンセルを要求する操作で、キャンセル待ちの間は無効になります。 |
| 失敗 | アップロードを再試行する前に、取り込み失敗のアラートとその理由を確認してください。 |
| 一部のファイルがスキップされました | 除外されたファイルの一覧を確認し、対応するファイル形式を選んでください。 |
| メタデータが見つかりません | 内容を取得する前に、選択したベースのインデックスが作成されているか確認してください。 |
| 埋め込みモデルの認証情報エラー | 選択したプロバイダーの認証情報、または詳細設定のEmbedding Provider API Keyフィールドを確認してください。 |
関連情報
ドキュメント · AI Flowi Workflow · ワークフローのファイル管理 · API Hub · ワークスペース · ワークフローの公開ガイド · 公開機能 · 料金 · デモを予約