Milvus 検索統合セットアップ
Milvusは、大規模なデータセットを扱うために使用できるベクターデータベースです。 リアルタイム検索機能と多数の同時ユーザーを必要とするアプリケーションには、分散型アーキテクチャ、高いパフォーマンス、柔軟なデータモデルを備えた Milvus をご利用いただけます。
検索統合は1つの環境につき1つしかできません。 既存の検索統合を Elasticsearch やカスタムサービスなどの別の統合タイプに変更すると、既存の検索統合の設定は上書きされます。
Milvus をアシスタントに接続するための前提条件
watsonx.data と watsonx.ai にアクティブなアカウントが必要です。
watsonx.data でアカウントを作成するには、 watsonx.data ホームページをご覧ください。
watsonx.ai でアカウントを作成するには、 watsonx.ai ホームページをご覧ください。
watsonx.data で Milvus インスタンスをプロビジョニングする必要があります。
watsonx.data の Milvus インスタンスの作成については、 watsonx.data の Milvus サービスの追加 を参照。
Milvus 認証情報の更新の詳細については、 Milvus 認証情報の更新を参照してください。
APIキーの作成については、 APIキーを参照してください。
IBM watsonx.ai で watsonx.data Milvus を設定する必要がある。
IBM watsonx.ai で watsonx.data を設定するには、 IBM watsonx.ai で watsonx.data を設定する を参照。
ベクター・インデックスの作成の詳細については、 ベクター・インデックスの作成を参照してください。
コレクションの作成の詳細については、 コレクションの作成を参照してください。
Milvus をアシスタントに接続
Milvus をアシスタントに統合するには、3つのプラットフォームが必要だ。
- AIアシスタント。
- watsonx.data Milvus インスタンスをプロビジョニングしている。
- watsonx.ai コレクションというデータソースを構築しています。
アシスタントの検索統合として Milvus を選択する
AIアシスタントのインスタンスを作成した後、以下の手順のいずれかを使用して、検索統合として Milvus :
統合ページから Milvus 検索統合を選択する
- ホーム > 統合へ進みます。
- 下にスクロールして、 拡張機能セクションまで移動します。 検索タイルで [追加] をクリックすると、 [新しい検索統合の設定]ウィンドウが開きます。
- 選択 Milvus 検索プロバイダーを接続するウィンドウを開きます。
環境のページから Milvus 検索統合を選択する
- ホーム > 環境設定に移動します。
- 「解像度方法」 セクションで、「拡張機能」セクションに進みます。
- 検索タイル内の 「追加」 をクリックすると、「新しい検索統合の設定」ウィンドウが開きます。
- 選択 Milvus 検索プロバイダーを接続するウィンドウを開きます。
会話型検索で Milvus の検索統合を選択
- ホームページで、下にスクロールしてアシスタントアーキテクチャセクションまで移動します。
- 会話型検索ノードで [追加] をクリックして、 新しい検索統合の設定ウィンドウを開きます。
Milvus がすでに追加されている場合は、 [開く]ボタンが表示されます。 それ以外の場合、 追加と表示されます。 ドラフトまたはライブアシスタント環境でカスタム サービスを設定するには、 [開く] をクリックします。
watsonx.data に接続してセットアップ Milvus
検索統合として Milvus を選択したら、 watsonx.data で 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 ユーザー名がわからない場合:
- watsonx.data コンソールの Infrastructure managerにアクセスする。
- Milvus サービスを選択し、 詳細ページを開きます。
- アクセス・コントロール ・タブをクリックする。
あなたの watsonx.data ユーザー名は、表の最初の列に表示されます。
ステップ 2: アシスタントで Milvus 接続を更新する
Milvus をソースとして使用する各アシスタントの Milvus 認証情報を更新してください。
- ホーム > 統合へ進みます。
- 拡張機能セクションに移動し、検索タイルで「 開く 」をクリックします。 プロンプトが表示されたら、更新する環境を選択します。 Milvus 検索が統合されている各環境について、これらの手順を繰り返す。 ドラフトと ライブの両方を使用している場合は、それぞれを別々に更新する。
- セレクト Milvus.
- 既存の接続情報を記録する。 Milvus の認証情報を更新した後に再度入力できるように、現在の Milvus 設定をすべて完全に記録しておく必要があります。
- インスタンス] タブに移動し、[詳細の更新] をクリックします。
- 接続の詳細を指定します:
- GRPCホストと GRPCポート。
- ユーザー名 ステップ1: 新しいユーザー名( Milvus )を見つける から の新しいユーザー名を使用してください。 Milvus
- パスワード: 先ほど使用したのと同じパスワードまたはAPIキーを使用する。
watsonx.data APIキーで認証された場合、同じキーがパスワードとして機能します。
- 次へ をクリックします。
- 「保存」をクリックしてから「閉じる」をクリックします。
- 検索タイルに戻り、「 開く 」をクリックする。
- ステップ2で選択したのと同じ環境を選択する。
- クリック Milvus.
- 会話型検索のセクションに行く。
- ステップ4で記録した設定を再度入力します。
- 「保存」をクリックしてから「閉じる」をクリックします。
- アシスタントのチャットウィンドウを使用して、 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を参照のこと。 フィルター式の例については、 フィルター式の例を参照してください。
会話型検索のチューニング
会話型検索では、「わからない」と答える傾向や、 生成される回答の長さを調整することができる。
「メッセージ 」、「結果なし 」、「接続の問題 」の各タブを使用して、検索結果の良し悪しに応じてユーザーと共有するメッセージをカスタマイズします。
| タブ | シナリオ | メッセージの例 |
|---|---|---|
| メッセージ | 検索結果が返された | I found this information that might be helpful: |
| 結果が見つかりません | 検索結果が見つからない | I searched my knowledge base for information that might address your query, but did not find anything useful to share. |
| 接続の問題 | 何らかの理由により検索を実行できない | I might have information that could help address your query, but am unable to search my knowledge base at the moment. |
Milvus のインスタンスの詳細を変更しない場合は、この手順をスキップできます。 Milvus インスタンスの認証情報を変更する場合は、 [インスタンス] タブをクリックし、認証タイプを変更するか、認証情報を編集してから、 [保存] をクリックします。 Milvus のインスタンス URL を変更したい場合は、 URL の横にある 「更新」ボタンをクリックし、ステップ1に進んで初期設定を開始します。
Saveをクリックし、 Closeをクリックして Milvusのセットアップを終了します。
フィルタリング式の例
以下の例は、フィルタ式の定義に役立ちます。
次を含む
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 )では、ナレッジベースにある最良の結果からテキストベースの返信が表示されます。
