ドキュメント レベルの関連性で検索をフィルタする（以前の機能）

重要: Gemini Enterprise は、StreamAssist を使用してアシスタントから検索結果を取得します。検索と回答の代わりに StreamAssist を使用することをおすすめします。詳細については、StreamAssist を使用して検索結果を取得するをご覧ください。

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

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

ドキュメント レベルの関連性でフィルタする方法について

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

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

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

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

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

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

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

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

その他の種類のフィルタ

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

詳細については、メタデータで検索をフィルタするをご覧ください。

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

始める前に

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

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

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

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

1. アプリ ID を調べます。アプリ ID をすでに保有している場合は、次のステップに進みます。

   1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

      [アプリ] に移動

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

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

   重要な用語: Gemini Enterprise では、API のコンテキストで「アプリ」という用語と「エンジン」という用語を同じ意味で使用できます。Gemini Enterprise エンジンは、app_type フィールドが APP_TYPE_INTRANET に設定されている汎用検索エンジンです。

   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: 実際のプロジェクトの ID。
   • APP_ID: クエリするアプリの 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/example/docs/check-grounding",
         "htmlTitle": "Check grounding | Example | Google Cloud",
         "title": "Check grounding | Example | Google Cloud"
       }
     }
   }
   ],
   "totalSize": 1,
   "attributionToken": "f_B-CgwIidzwswYQyue15gESJDY2N2M1NmJkLTAwMDAtMjk3Ni1iMGI4LTg4M2QyNGZmNTZhOCIHR0VORVJJQypAjr6dFavEii3b7Ygt3o-aIoCymiLC8J4Vo4CXIra3jC3Usp0V24-aIt7tiC3n7YgtrsSKLeTtiC2DspoixsvzFw",
   "guidedSearchResult": {},
   "summary": {}
   }
   

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

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