構造化データストアからの結果を並べ替える

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

このページでは、構造化データストアとメタデータを含む非構造化データストアに対して実行された検索クエリの結果を並べ替える方法について説明します。

結果の並べ替えでサポートされているデータ型

検索結果の並べ替えに使用できるフィールドの型は次のとおりです。

• string
• number
• datetime
• geolocation

始める前に

構造化データまたはメタデータを含む非構造化データが存在するデータストアを使用するアプリがあることを確認します。

検索結果を並べ替える

構造化データストアまたはメタデータを含む非構造化データストアの検索結果を並べ替える手順は次のとおりです。

REST

API を使用して、構造化データまたはメタデータを含む非構造化データを使用するアプリの検索結果を並べ替えるには、engines.servingConfigs.search メソッドを使用します。

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

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

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

      [アプリ] に移動

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

2. 検索クエリを作成し、orderBy フィールドを含めます。

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

   curl -X POST -H "Authorization: Bearer $(gcloud auth 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",
   "orderBy": "ORDER_BY"
   }'
   

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

   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
   • APP_ID: Vertex AI Search アプリの ID。
   • QUERY: 検索するクエリテキスト。
   • ORDER_BY: 結果の並べ替え順。デフォルトの並べ替え順は昇順です。たとえば、date を指定すると、最も古いものから最も新しいものの順に結果が返されます。降順で並べ替えるには、date 値に desc を追加します（例: date desc）。その他の例については、orderBy の例をご覧ください。

   コマンドの例と結果

   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-app/servingConfigs/default_search:search" \
   -d '{
       "query": "hotel",
       "orderBy": "rating desc"
      }'
       
   
   {
   "results": [
   {
     "id": "10d480b19c256bb1",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10d480b19c256bb1",
       "id": "10d480b19c256bb1",
       "structData": {
         "available_date": "2023-11-05",
         "amenities": [
           "Lake Views",
           "Private Beach",
           "Spa",
           "Water Activities"
         ],
         "room_types": [
           "Lakefront Suite",
           "Deluxe Room",
           "Cottage"
         ],
         "location": {
           "address": "988 Serenity Circle, Tranquil Town, NV 89501, USA"
         },
         "rating": 4.6,
         "id": 11,
         "price_per_night": 220.5,
         "title": "Serenity Springs Hotel"
       }
     }
   },
   {
     "id": "9ffae8af37cc8b63",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/9ffae8af37cc8b63",
       "id": "9ffae8af37cc8b63",
       "structData": {
         "title": "Riverfront Plaza Hotel",
         "rating": 4.2,
         "location": {
           "address": "101 Main St, Anytown, CA 94501, USA"
         },
         "price_per_night": 145.8,
         "amenities": [
           "Fitness Center",
           "Conference Rooms",
           "Restaurant",
           "Valet Parking"
         ],
         "id": 3,
         "room_types": [
           "Executive Suite",
           "King Room",
           "Double Queen"
         ],
         "available_date": "2023-11-15"
       }
     }
   },
   {
     "id": "3be9e854d8f3a47f",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/3be9e854d8f3a47f",
       "id": "3be9e854d8f3a47f",
       "structData": {
         "amenities": [
           "Oceanfront Views",
           "Pool",
           "Spa",
           "Beachside Dining"
         ],
         "available_date": "2023-09-18",
         "location": {
           "address": "449 Oceanfront Drive, Seaside Resort, CA 92007, USA"
         },
         "id": 13,
         "title": "Ocean Breeze Hotel",
         "room_types": [
           "Ocean View Suite",
           "Deluxe Room",
           "Family Suite"
         ],
         "rating": 4.1,
         "price_per_night": 180
       }
     }
   }
   ],
   "totalSize": 3,
   "attributionToken": "wAHwvwoMCNDYz7UGEMCklrsCEiQ2NmIzYmU5My0wMDAwLTIxMDUtYmUyNy01ODI0MjljMzdlZTQiB0dFTkVSSUMqgAHd1akt3e2ILebtiC2CspoigLKaIpjeqC-q-LMtjr6dFeqCsS2W3qgvwvCeFaz4sy2jgJcinta3LeiCsS3b7Ygt5O2ILa3Eii3Usp0Vpp-VLZzWty359rMt-_azLaCJsy3dj5oixcvzF6vEii2iibMttreMLd_VqS3bj5oipJ-VLQ",
   "guidedSearchResult": {},
   "summary": {}
   }
       

   この例では、「hotel」という単語を含むドキュメントが、評価 4.6 の Serenity Springs Hotel から評価 4.1 の Ocean Breeze Hotel まで、評価順に並べられています。

orderBy の例

title という文字列フィールドで並べ替えるには:

• "orderBy": "title" は、タイトルのアルファベットの昇順でドキュメントを返します。

• "orderBy": "title desc" は、タイトルのアルファベットの降順（Z から A）に並べ替えられたドキュメントを返します。

rating という数値フィールドで並べ替えるには:

• "orderBy": "rating" は、評価の最も低いものから最も高いものの順にドキュメントを並べ替えます。

• "orderBy": "rating desc"は、評価の最も高いものから最も低いものの順にドキュメントを並べ替えます。

available_date という名前の日時フィールドで並べ替えるには:

• "orderBy": "available_date" は、入手可能な日付が最も早いドキュメントから最も遅いドキュメントの順に並べ替えます。

• "orderBy": "available_date desc" は、入手可能な日付が最も遅いドキュメントから最も早いドキュメントの順に並べ替えます。

location というフィールドの位置情報に基づいて並べ替えるには:

• "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" は、Mountain View に最も近くにあるドキュメントから Mountain View から最も遠くにあるドキュメントの順に並べ替えます。

• "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" は、37.38°N、122.08°W から最も遠くにあるドキュメントから最も近くにあるドキュメントの順に並べ替えます。