ナレッジバンドル

ナレッジバンドルを通じたナレッジソース管理およびRAG(Retrieval-Augmented Generation)設定

主要機能

• ナレッジバンドル作成および管理
• ファイルアップロード可能
• SharePointファイルソース追加
• 外部ソース認証管理
• ベクター埋め込み基盤インデックス
• RAGサービス連携

基本情報

ナレッジバンドル

ナレッジバンドルは、エージェントが参照するナレッジソースを1つの単位でまとめた構成要素です。ファイル、文書、コードリポジトリなど様々なデータを接続し、これをベクター埋め込み基盤でインデックスしてRAG方式で活用できるようサポートします。

ナレッジソース

ファイルまたは外部データソース(CSV、PDF、GitHubなど)を意味します。

RAGサービス

RAG(Retrieval-Augmented Generation)サービスを提供します。

ナレッジバンドル管理

バンドル一覧照会

組織単位で作成されたすべてのナレッジバンドルをリストで確認できます。

表示情報:

• Name: バンドル名
• Description: 説明
• Sources: 接続されたナレッジソース数
• Status: 全体バンドルのインデックス状態

検索機能:

• 名前基準でフィルタリング可能

バンドル作成

1. ［ + バンドルを作成 ］ボタンをクリック
2. 以下の情報を入力:
   • 名前 (必須): バンドル名
   • 説明: バンドル説明
   • チャンクサイズ: 文書を検索可能な単位に分割するときに使用するチャンクサイズ
   • オーバーラップ: 隣接するチャンク間で重複して含める範囲
3. “作成”ボタンをクリック

バンドル詳細管理

バンドル詳細ページでは以下の情報を確認し管理できます:

バンドル情報:

• バンドル名および説明
• バンドルの状態 (INDEXED、Failedなど)

ナレッジソース一覧:

• 接続されたソースの詳細情報
• 各ソースのインデックス状態

主要アクション:

• ”+ Add Source”: 新しいソース追加
• “More Actions”: 追加管理機能
• 個別ソース管理 (編集、削除など)

ナレッジソース追加

サポートするソースタイプ

現在はファイルアップロードとSharePointソースをサポートします。

ファイルアップロード

現在サポートするファイルアップロード機能:

サポートフォーマット:

• .pdf
• .txt, .md, .markdown
• .html
• .doc, .docx
• .csv, .xls, .xlsx

制限事項:

• ファイルあたり最大容量: 50MB
• ファイルアップロード後”Start”ボタンをクリックしてインデックス開始
• ソース名入力可能 (デフォルト値: ファイル名)
• 必要に応じてチャンクサイズとオーバーラップを調整し、インデックス方式を設定できます。

SharePointソース追加

SharePointに保存されたファイルをナレッジソースとして取り込み、ナレッジバンドルに追加できます。

追加手順

1. ナレッジバンドル詳細画面で + Add Source をクリックします。
2. SharePoint ソースを選択します。
3. 使用するSharePointアカウントを選択するか、新しいアカウントを接続します。
4. SharePointサイト、ドライブ、フォルダを参照し、取り込むファイルを選択します。
5. インポート をクリックして、選択したファイルをナレッジソースとして追加します。
6. 取り込んだソースのインデックスを開始します。

サポートフォーマット

• .pdf
• .doc, .docx
• .txt, .md
• .html
• .csv, .xlsx
• .json

制限事項

• ファイルあたり最大容量: 50MB
• OneNoteノートブックはナレッジソースとして取り込めません。
• サポートされていないファイル形式は選択できません。
• すでに同じバンドルに追加されたファイルは重複して取り込めません。

SharePointソース更新

SharePointの元ファイルの変更有無は自動的に確認されます。デフォルトでは約1時間ごとに元ファイルを確認し、変更が検出されるとナレッジソース一覧に ソース変更あり 状態と 更新 ボタンが表示されます。

1. ソース変更あり 状態が表示されたSharePointソースの 更新 ボタンをクリックします。
2. SharePointの最新ファイルを再度取り込み、既存のソースファイルを置き換えます。
3. 更新が完了したら、最新コンテンツを検索に反映するために該当ソースを再度インデックスします。

保存されたSharePoint認証が期限切れになった、またはトークン更新に失敗した場合は、SharePointアカウント再接続 の案内が表示されます。この場合、既存で接続したアカウントで再度認証してから更新を再試行してください。別のSharePointアカウントで再認証すると、既存ファイルとアカウントが一致せず作業に失敗する場合があります。

外部ソース認証管理

ナレッジ管理画面の 認証管理 で、ナレッジソースに使用する外部サービスアカウントを管理できます。

認証管理でできること

• 接続済みSharePointアカウント一覧の確認
• アカウント状態の確認: 接続済み、再認証が必要、期限切れ、接続解除
• 期限切れまたは再認証が必要なアカウントの再認証
• 使用しなくなったアカウントの接続解除

接続済みナレッジソースがあるアカウントは、ソースを削除した後に接続を解除できます。

チャンクサイズとオーバーラップ設定

ナレッジバンドル作成またはソース追加時に、チャンクサイズとオーバーラップを設定できます。

• チャンクサイズ: 文書を検索可能な単位に分割するサイズです。値を小さくするとより細かく検索でき、値を大きくするとより長い文脈を一度に検索できます。
• オーバーラップ: 隣接するチャンク間で重複して含める範囲です。値を大きくすると、段落の境界で文脈が途切れる問題を減らせます。

長い文脈を維持する必要がある文書ではオーバーラップを大きくすると有用です。短く構造化された文書ではチャンクサイズを小さく設定すると、目的の情報をより絞り込んで見つけやすくなります。

状態値定義

ナレッジバンドル状態

ナレッジソース状態

削除および再処理ポリシー

削除制限事項

• ナレッジバンドルおよびソースの状態がIndexingで進行中の場合、削除できません
• この場合Deleteボタンが無効化されます

ナレッジソース削除

• 接続されたバンドル/エージェントがあっても削除可能
• バンドルは維持され検索範囲が縮小
• エージェント実行時RAG結果で該当ソース関連内容が除外
• 該当ソースのインデックス(RAGベクター)も一緒に削除

削除確認メッセージ:

“Deleting it will reduce the bundle’s coverage and may affect linked agents. Do you want to continue?”

ナレッジバンドル削除

• 接続されたエージェントが存在する場合バンドル削除不可能
• バンドル内のソースをすべて削除した後にバンドルを削除できます

削除確認メッセージ:

“Deleting this bundle may affect linked agents. Do you want to proceed?”

再インデックス

• ソース単位で再インデックス可能
• ソース全体再インデックス可能

注意事項

• ナレッジバンドルはエージェントのナレッジ基盤となるため慎重に管理する必要があります
• 削除時接続されたエージェントに影響を与える可能性があるため事前確認が必要です
• インデックス中の状態では削除が不可能なため完了後に進行してください
• ファイルアップロード時の容量制限(50MB)とチャンクサイズ、オーバーラップ設定を確認してください