ナレッジストレージを運用する

ベクトルDBは、文書をAIが検索できる形式（ベクトル）に変換して保存する場所です。ナレッジインデックス作成で作られた検索データがここに保存され、AI文書検索とRAG回答がこのデータを使用します。

ベクトルDBに保存されるデータは、元の文書からいつでも作り直せる派生データです。ベクトルDBを変更または初期化しても、ワークスペースの元のファイルは変わりません。

始める前に

• 必要な権限：Workspace管理者
• ナレッジサービス > ナレッジストレージで、現在のドライバーと接続状態を確認します。
• ストレージの切り替えや初期化は、検索結果が再び準備されるまで影響を与える場合があるため、作業時間を決めておきます。

ベクトルストレージの選択

ナレッジストレージのドライバーで選択します。

ベクトル数は文書数ではなく、文書の断片（チャンク）の数です。文書は形式に応じてセクション、ページ、行の単位で分割した後、韓国語基準で約700〜1,000文字のサイズにさらに分割して保存します。長い文書1つが数十個のベクトルになることがあります。

外部ベクトルDBのインストールと接続の方法は、それぞれのドキュメントを参照してください。

• Qdrantを接続する — Dockerコンテナ1つでインストールできる軽量な構成です。別のサーバーを初めて構成する場合は、Qdrantを推奨します。
• Milvusを接続する — メモリ8GB以上の別のサーバーを推奨します。コレクションを自分で作成する必要があります。

Local (SQLite)の運用

Localドライバーは、外部サービスを使わずに、1つのSQLiteファイル（local_vectors.db）でベクトル検索を運用します。

ベクトルDBの運用状況には、local_vectors.db 使用量もあわせて表示されます。

ストレージや埋め込みモデルを変更するとき

次の項目のうち1つでも変更して保存すると、SpaceBuilderが変更を検知し、元の資料全体の再インデックスを自動的に開始します。

• ドライバー、エンドポイント、コレクション、データパス
• 埋め込みモデル、ベクトル次元数

切り替えは、次の順序で進みます。

1. 新しい設定を保存します。
2. インデックススケジューラーが変更を検知し、元の資料全体の再インデックスをリクエストします。
3. すべての文書を新しい設定で埋め込み直し、新しいストレージに保存します。
4. すべての文書が新しいストレージに保存され、検索の検証まで終わると、以前のベクトルを元の保存場所から削除します。

切り替え中の検索

• 変更を検知するまでは、ベクトル検索を一時的に停止し、キーワード検索のみを使用します。
• 再インデックス中は、新しいストレージを検索します。まだ新しいストレージに移されていない文書は、ベクトル検索の結果に表示されない場合があります。
• 再インデックスが終わると、新しい設定で作成したベクトルのみを検索します。

文書が多いと再インデックスに時間がかかる場合があるため、ユーザーが少ない時間帯に切り替えてください。

切り替え時の注意点

• 以前の外部ストレージは、整理が終わるまで稼働させておいてください。 QdrantやMilvusから別のストレージに移行した場合は、以前のベクトルの削除が終わるまで、以前のサーバーに接続できる必要があります。接続できない場合、整理作業は以前の保存先に接続できませんの状態で再試行され続けます。
• ベクトル次元数を変更する場合は、コレクションも新しく指定してください。 作成済みのQdrant・Milvusコレクションは、次元を変更できません。次元が異なるコレクションには保存できません。
• 以前の設定に戻しても、再インデックスします。 A → B → Aのように戻した場合、最初のAのデータは再利用されず、新たにインデックスを作成します。

運用状態の確認

ベクトルDBの運用状況

ナレッジストレージ画面の上部で確認します。

コレクション設定には、次のいずれかが表示されます。

ナレッジインデックス作成画面

ナレッジインデックス作成のインデックス要約で、進行状況を確認します。

以前のベクトルの削除に失敗すると、整理の再試行一覧に保存先と理由が表示されます。再試行の間隔は徐々に長くなり、最大5分です。

ベクトルの同期と再構築

ナレッジストレージの管理者専用の領域で実行します。どちらの操作でも元のファイルは削除されず、Team以上のライセンスが必要です。

• どちらの操作もリクエストを受け付けるものであり、進行状況は収集・インデックス作成で確認します。
• 同じQdrant・Milvusコレクションを使用する別のインスタンスのデータには影響しません。

複数のインスタンスが1つのベクトルDBを共有するとき

インスタンスとは、個別にインストールして運用する1つのSpaceBuilderのことです。インスタンスごとに固有のインスタンス分離キーがあり、保存するベクトルにはこのキーがあわせて記録されます。そのため、同じコレクションを共有しても、検索、統計、ベクトルの整理は、それぞれのインスタンスのデータの中だけで行われます。

ただし、バックアップ、容量の管理、削除をインスタンスごとに行うには、インスタンスごとに別のコレクションを使用することを推奨します。デフォルトのコレクション名（knowledge_vectors）を使用すると、設定画面に警告とともに、このインスタンスの推奨名（setfn_knowledge_...）が表示されます。

バックアップと復元

ナレッジデータのバックアップは、SpaceBuilderサーバーを停止してからコマンドで実行します。サーバーが実行中の場合、バックアップと復元は拒否されます。復元できるのは、同じインスタンス、同じホームフォルダで作成したバックアップだけです。

# バックアップ（対象フォルダは、まだ存在しない新しいパスである必要があります）
~/setfn-spacebuilder admin knowledge-backup <バックアップフォルダ>

# 復元
~/setfn-spacebuilder admin knowledge-restore <バックアップフォルダ>

復元後はサーバーを起動し、ナレッジストレージで既存の埋め込みを同期を実行して、ベクトルDBにデータを入れ直してください。バックアップ以降に外部ベクトルDBへ保存されたベクトルは、復元の過程で整理対象になり、サーバーの起動後に元の保存場所から自動的に削除されます。

トラブルシューティング

関連ドキュメント

• ナレッジストレージ
• Qdrantを接続する
• Milvusを接続する
• 収集・インデックス作成
• バックグラウンドサービス