ドキュメント レベルの関連性で検索をフィルタする

注: この機能はプレビュー版で、GCP サービス固有の規約の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。詳細については、リリース ステージの説明をご覧ください。 さらに、この機能を使用すると、生成 AI プレビュー版の利用規約（以下「プレビュー規約」）に同意したことになります。この機能については、お客様は Cloud のデータ処理に関する追加条項に記載されているとおりに個人データを処理できます。その際、（プレビュー規約に定義されるとおり）本契約で規定されている制限と義務が適用されます。

Vertex AI Search アプリで検索するときに、関連性しきい値を適用して、このしきい値を満たすドキュメントのみが結果として返されるようにすることができます。このページでは、クエリで返されるドキュメントの数を減らすために、関連性しきい値を指定する方法について説明します。

ドキュメント レベルの関連性でフィルタする

検索クエリによって返される各ドキュメントには、関連性レベルが割り当てられます。これは、返されたドキュメントとクエリの関連性を示します。API 呼び出しでクエリを実行するときに、関連性のしきい値を設定できます。関連性のしきい値を高く設定すると、クエリで返されるドキュメントの数を減らすことができます。

たとえば、検索でユーザーにとって関連性の低いドキュメントが多すぎる場合は、関連性のしきい値を高に設定して、最も関連性の高い少数の結果のみに絞り込みます。高設定で過剰に制限される場合は、中設定をお試しください。

注: このドキュメント レベルの関連性フィルタリング機能は、検索結果で返されるドキュメントの関連性スコアとは異なり、精度も低くなります。

ドキュメント レベルの関連性フィルタでサポートされているデータ型とアプリ

ドキュメント レベルの関連性フィルタは、次の種類のデータを含むデータストアに適用できます。

• ウェブサイトの高度なインデックス登録を使用したウェブサイト データ
• カスタム非構造化データ
• カスタム構造化データ

ドキュメント レベルの関連性フィルタは、ウェブサイトの基本的なインデックス登録、メディアデータ、医療データを含むデータストアでは機能しません。

また、ドキュメント レベルの関連性フィルタは統合検索アプリでは使用できません。ブレンド検索アプリは、複数のデータストアに接続されているアプリです。

その他の種類のフィルタ

ドキュメント レベルの関連性フィルタは、クエリで返されるデータをフィルタする唯一の方法ではありません。フィルタ式を使用して、メタデータ（ウェブサイトの高度なインデックス登録とメタデータ データストアを使用した非構造化データ）とフィールド値（構造化データストア）に基づいて結果をフィルタすることもできます。

詳細については、以下をご覧ください。

• ウェブサイトの高度なインデックス登録を使用したフィルタ式

• 構造化データまたは非構造化データのカスタム検索をフィルタする

フィルタ式とドキュメント レベルの関連性フィルタの両方を使用すると、最初にフィルタ式が結果に適用され、次にドキュメント レベルの関連性フィルタが適用されます。

始める前に

アプリとデータストアを作成し、データストアにデータを取り込んだことを確認します。詳細については、検索アプリを作成するをご覧ください。ドキュメント レベルの関連性フィルタでサポートされているデータ型とアプリもご覧ください。

ドキュメント レベルの関連性に基づいて結果を検索、フィルタする

関連性でフィルタするには、次の手順を行います。

注: アプリ内を検索するには engines.servingConfigs.search メソッドを使用し、データストア内を検索するには dataStores.servingConfigs.search メソッドを使用します。次の手順では、engines.servingConfigs.search メソッドを使用して検索することをおすすめします。

1. アプリ ID を確認します。アプリ ID がすでにある場合は、次のステップに進みます。

   1. Google Cloud コンソールで、[AI アプリケーション] ページに移動します。

      [アプリ] に移動

   2. [アプリ] ページで、アプリの名前を見つけ、[ID] 列からアプリの ID を取得します。

2. ドキュメント レベルの関連性で検索をフィルタするには、engines.servingConfigs.search メソッドで relevanceThreshold フィールドを使用します。

   キーワード: Vertex AI Search では、API のコンテキストでアプリという用語とエンジンという用語を同じ意味で使用できます。

   curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
   -d '{
    "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "query": "QUERY",
   "relevanceThreshold": "RELEVANCE_THRESHOLD"
   }'
   

   次のように置き換えます。

   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
   • APP_ID: クエリする Vertex AI Search アプリの ID。
   • QUERY: 検索するクエリテキスト。
   • RELEVANCE_THRESHOLD: 次のいずれかになります。 HIGH、MEDIUM、LOW、LOWEST。

   コマンドの例と結果

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search:search" \
   -d '{
   "servingConfig": "projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search",
   "query": "What is the check grounding API",
   "relevanceThreshold": "HIGH"
   }'
   
   {
   "results": [
   {
     "id": "a082e70352c073a4443502477255bd2a",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/a082e70352c073a4443502477255bd2a",
       "id": "a082e70352c073a4443502477255bd2a",
       "derivedStructData": {
         "displayLink": "cloud.google.com",
         "link": "https://cloud.google.com/generative-ai-app-builder/docs/check-grounding",
         "htmlTitle": "Check grounding",
         "title": "Check grounding"
       }
     }
   }
   ],
   "totalSize": 1,
   "attributionToken": "f_B-CgwIidzwswYQyue15gESJDY2N2M1NmJkLTAwMDAtMjk3Ni1iMGI4LTg4M2QyNGZmNTZhOCIHR0VORVJJQypAjr6dFavEii3b7Ygt3o-aIoCymiLC8J4Vo4CXIra3jC3Usp0V24-aIt7tiC3n7YgtrsSKLeTtiC2DspoixsvzFw",
   "guidedSearchResult": {},
   "summary": {}
   }
   

   ここでは、関連性のしきい値が高に設定されているため、最も関連性の高い結果のみが返されます。この例では、関連性が高いと判断されたドキュメントは 1 つだけです。

3. さまざまなしきい値で複数のクエリをテストして、データとアプリケーションに最適なきい値設定を特定します。