Milvus 検索統合セットアップ

Milvusは、大規模なデータセットを扱うために使用できるベクターデータベースです。 リアルタイム検索機能と多数の同時ユーザーを必要とするアプリケーションには、分散型アーキテクチャ、高いパフォーマンス、柔軟なデータモデルを備えた Milvus をご利用いただけます。

検索統合は1つの環境につき1つしかできません。 既存の検索統合を Elasticsearch やカスタムサービスなどの別の統合タイプに変更すると、既存の検索統合の設定は上書きされます。

Milvus をアシスタントに接続するための前提条件

Milvus をアシスタントに接続

Milvus をアシスタントに統合するには、3つのプラットフォームが必要だ。

  1. AIアシスタント。
  2. watsonx.data Milvus インスタンスをプロビジョニングしている。
  3. watsonx.ai コレクションというデータソースを構築しています。

watsonx.data に接続してセットアップ Milvus

検索統合として Milvus を選択したら、 watsonx.data で Milvus インスタンスのデータを使用して、 Milvus をアシスタントにセットアップします。

接続 Milvus データ

watsonx.data で Milvus インスタンスを作成する方法の詳細については、 Milvus インテグレーションの前提条件を参照してください。

Connect Milvus を使用して、 watsonx.data 内の Milvus サービスに接続できます。 Connect your search provider セクションで、アシスタントが Milvus インスタンスに接続できるように、 watsonx.data から以下のフィールドを入力します。

  • GRPCホストおよび GRPCポート

    GRPCホストと GRPCポートの詳細を取得するには、「 接続の詳細 」を参照してください。

    接続の詳細

  • 認証タイプを選択する

    • Basic authentication を選択した場合は、 ユーザー名パスワードを入力する必要があります。
    • watsonx.data API key を選択した場合は、対応する APIキーを提供する必要があります。
    • None を選択した場合、その他の認証情報を入力することはできません。

    クレデンシャルの詳細については、 クレデンシャルの取得を参照してください。

Milvus 認証情報を更新する

2.3 IBM watsonx.data のリリースは、既存の Milvus 認証タイプに影響を与える。 重大なサービス中断を避けるため、2025年12月10日までに接続を見直し、更新する必要がある。

ステップ1: Milvus 新しいユーザー名を見つける

新しい Milvus ユーザー名はこのフォーマットを使用します:

ibmlhapikey_<your watsonx.data username>

watsonx.data ユーザー名 Milvus ユーザー名
abc@ibm.com ibmlhapikey_abc@ibm.com
serviceid-abcdef-123456 ibmlhapikey_serviceid-abcdef-123456

watsonx.data ユーザー名がわからない場合:

  1. watsonx.data コンソールの Infrastructure managerにアクセスする。
  2. Milvus サービスを選択し、 詳細ページを開きます。
  3. アクセス・コントロール ・タブをクリックする。
    あなたの watsonx.data ユーザー名は、表の最初の列に表示されます。

ステップ 2: アシスタントで Milvus 接続を更新する

Milvus をソースとして使用する各アシスタントの Milvus 認証情報を更新してください。

  1. ホーム > 統合へ進みます。
  2. 拡張機能セクションに移動し、検索タイルで「 開く 」をクリックします。 プロンプトが表示されたら、更新する環境を選択します。 Milvus 検索が統合されている各環境について、これらの手順を繰り返す。 ドラフトと ライブの両方を使用している場合は、それぞれを別々に更新する。
  3. セレクト Milvus.
  4. 既存の接続情報を記録する。 Milvus の認証情報を更新した後に再度入力できるように、現在の Milvus 設定をすべて完全に記録しておく必要があります。
  5. インスタンス] タブに移動し、[詳細の更新] をクリックします。
  6. 接続の詳細を指定します:
    • GRPCホストと GRPCポート
    • ユーザー名 ステップ1: 新しいユーザー名( Milvus )を見つける から の新しいユーザー名を使用してください。 Milvus
    • パスワード: 先ほど使用したのと同じパスワードまたはAPIキーを使用する。
      watsonx.data APIキーで認証された場合、同じキーがパスワードとして機能します。
  7. 次へ をクリックします。
  8. 「保存」をクリックしてから「閉じる」をクリックします。
  9. 検索タイルに戻り、「 開く 」をクリックする。
  10. ステップ2で選択したのと同じ環境を選択する。
  11. クリック Milvus.
  12. 会話型検索のセクションに行く。
  13. ステップ4で記録した設定を再度入力します。
  14. 「保存」をクリックしてから「閉じる」をクリックします。
  15. アシスタントのチャットウィンドウを使用して、 Milvus 検索結果が正しく表示されることを確認します。

Milvus、ベクターデータベースにデータを取り込む。 watsonx.ai

watsonx.data から情報を収集したら、AIアシスタントで使用するために、 Milvus データベースにデータを取り込む必要があります。

アシスタントの Milvus ウィンドウで、 [次へ] をクリックして[ データソースの選択] に進み、以下の詳細を入力します:

  • データベースで、お好みのデータベースを選択します。
  • Choose collectionで、コレクションを選択します。 詳細については、 Milvus の統合の前提条件を参照。

コレクションの作成

  • Choose indexでインデックスを選択する。
  • Choose embedding_model_idで、モデルを選択します。

サポートされている埋め込みモデルの詳細については、 埋め込みモデルを参照してください。

選択したモデルは、インデックスを作成した際に使用したモデルと一致していなければなりません。

結果コンテンツの設定

データソースを選択して Milvus に接続した後、検索応答がアシスタントの Milvus ウィンドウにどのように表示されるかを設定できます。 Select data source] の[ Configure result content] セクションで、以下のフィールドを指定して、 Milvus からのタイトル、本文、および URL をアシスタントウィンドウの検索応答にマッピングします:

  • タイトル検索結果タイトル 検索結果タイトルとして、コレクション・フィールドの title、name、または同様のタイプを使用します。 FacebookとSlackの統合では、タイトルに何かを選択しないと検索結果の応答が表示されません。

  • ボディ検索結果の説明。 検索結果の本文として、コレクション・フィールドの abstract、summary、または highlight を使用します。 FacebookとSlackの統合では、本文に何かを選択しないと検索結果の応答が表示されません。

  • URL このフィールドには、検索結果の最後に含めたいフッターコンテンツを入力することができます。

会話形式の検索を可能にする Milvus

結果コンテンツを構成したら、 「次へ」 をクリックして会話型検索 (オプション)に進みます。

会話型検索は、 watsonx Assistant のプラス・プランとエンタープライズ・プランでのみ利用できる。

会話型検索を有効にするには、 会話型検索のトグルを on に切り替えます。 詳しくは、 会話型検索をご覧ください。

フィルター式の定義

Advanced Milvus settings セクションを展開し、 Filter を定義します。

Milvus、検索結果をフィルタリングするための文字列としてフィルタを定義することができます。 詳しくは、 Milvus -filter-searchを参照のこと。 フィルター式の例については、 フィルター式の例を参照してください。

フィルタリング式の例

以下の例は、フィルタ式の定義に役立ちます。

次を含む

title like "%action%"

このフィルタ式では、タイトルに action という語句を含む検索結果のみを表示します。

次を含まない

not (title like "%action%")

このフィルター式は、 action という単語を含まないタイトルの検索結果のみを許可する。

等しい

"Understand your most and least successful actions"

このフィルター式は、タイトルがフレーズ Understand your most and least successful actions と等しい検索結果のみを許可する。

等しくない

"Understand your most and least successful actions"

このフィルター式は、タイトルがフレーズ Understand your most and least successful actions と等しくない検索結果のみを許可する。

入れ子になったフィルタ式

(title like "%action%") and (url in ["www.url1.com", "www.url2.com"])

このフィルター式は、タイトルに "action "という単語が含まれ、urlが[" www.url1.com ", " www.url2.com "]のいずれかである検索結果のみを許可します。

アシスタントを設定して使用する Milvus

Milvus の検索統合を設定した後、応答が「何もしない」に一致する場合に Milvus を使用するようにアシスタントを設定する必要があります。 検索を使用するために No matchesを更新することについての詳細は、 Use search when no action matchesを参照のこと。

Milvusのテスト

アクションプレビュー、プレビューページ、またはプレビューリンクを使用して、 Milvusとの検索統合をテストすることができます。

会話型検索が有効になっている場合( off )、プレビューで正しい結果を確認できません。

この例では、ユーザーは、 What is an action?

会話型検索( on )では、ナレッジベースにある最良の結果からテキストベースの返信が表示されます。

ConversationalSearchToggleOn