Ergebnisse aus Datenspeichern für strukturierte Daten sortieren

Hinweis: Diese Funktion ist ein Vorabangebot, das den Pre-GA-Angebotsbedingungen in den dienstspezifischen Nutzungsbedingungen für die GCP unterliegt. Pre-GA-Produkte und -Funktionen werden eventuell nur eingeschränkt unterstützt. Änderungen an Pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen. Wenn Sie diese Funktion verwenden, stimmen Sie außerdem den Nutzungsbedingungen für die Vorabversion der generativen KI („Bedingungen für Vorabversionen“) zu. Für diese Funktion können personenbezogene Daten gemäß dem Zusatz zur Verarbeitung von Cloud-Daten verarbeitet werden, vorbehaltlich der geltenden Einschränkungen und Verpflichtungen in der Vereinbarung (wie in den Vorschaubedingungen definiert).

Die Sortierung ist eine Art Ranking-Mechanismus, der die Reihenfolge, in der Ergebnisse zurückgegeben werden, nach einem ersten Ranking, das während des Abrufvorgangs festgelegt wird, dynamisch ändert. Beim Abrufen ruft Vertex AI Search die relevanten Dokumente aus dem Datenspeicher ab. Das können Tausende von Dokumenten sein (abhängig von der Größe des Datenspeichers). Danach werden die besten Ergebnisse entsprechend der für die Neuordnung angegebenen Bedingung bereitgestellt. Weitere Informationen finden Sie unter Abruf und Ranking.

Auf dieser Seite wird erläutert, wie Sie die Ergebnisse einer Abfrage für strukturierte Datenspeicher und unstrukturierte Datenspeicher mit Metadaten sortieren.

Unterstützte Datentypen zum Sortieren der Ergebnisse

Nach diesen Feldtypen können Sie Ihre Suchergebnisse sortieren lassen:

• string
• number
• datetime
• geolocation

Voraussetzungen

Sie benötigen eine Anwendung mit einem Datenspeicher, der strukturierte Daten oder unstrukturierte Daten mit Metadaten enthält.

Suchergebnisse sortieren

So sortieren Sie die Suchergebnisse für einen strukturierten Datenspeicher oder für einen unstrukturierten Datenspeicher mit Metadaten:

REST

Wenn Sie die API verwenden möchten, um Ihre Suchergebnisse für eine Anwendung mit strukturierten Daten oder unstrukturierten Daten mit Metadaten zu sortieren, verwenden Sie die Methode engines.servingConfigs.search:

Hinweis: Sie können eine Anwendung mit der Methode engines.servingConfigs.search und einen Datenspeicher mit der Methode dataStores.servingConfigs.search durchsuchen. Für das folgende Verfahren empfiehlt Google die Suche mit der Methode engines.servingConfigs.search.

1. App-ID suchen. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

   1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Gehen Sie zu Apps

   2. Suchen Sie auf der Seite Anwendungen nach dem Namen Ihrer Anwendung und entnehmen Sie die Anwendung-ID der Spalte ID.

2. Stellen Sie eine Abfrage und fügen Sie das Feld orderBy ein.

   Wichtiger Begriff:In Vertex AI Search kann der Begriff App im Zusammenhang mit APIs synonym mit dem Begriff Engine verwendet werden.

   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"
   }'
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
   • APP_ID: Die ID der Vertex AI Search-Anwendung.
   • QUERY: der Abfragetext für die Suche.
   • ORDER_BY: die Reihenfolge, in der die Ergebnisse angeordnet sind. Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie beispielsweise date angeben, werden die Ergebnisse vom ältesten zum neuesten zurückgegeben. Wenn Sie eine absteigende Sortierung wünschen, hängen Sie desc an den date-Wert an, z. B. date desc. Weitere Beispiele finden Sie unter Beispiele für orderBy.

   Beispielbefehl und -ergebnis

   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": {}
   }
       

   In diesem Beispiel werden die Dokumente, die das Wort „Hotel“ enthalten, nach Bewertung sortiert, vom Serenity Springs Hotel mit einer Bewertung von 4,6 bis zum Ocean Breeze Hotel mit einer Bewertung von 4,1.

Beispiele für orderBy

So sortieren Sie nach einem Stringfeld mit dem Namen title:

• "orderBy": "title", um die Dokumente in aufsteigender alphabetischer Reihenfolge nach Titel zurückzugeben

• "orderBy": "title desc", um die Dokumente nach Titel in umgekehrter alphabetischer Reihenfolge (von Z bis A) zurückzugeben

So sortieren Sie nach einem Zahlenfeld mit dem Namen rating:

• "orderBy": "rating", um die Dokumente von der niedrigsten zur höchsten Bewertung zu sortieren

• "orderBy": "rating desc", um die Dokumente von der höchsten zur niedrigsten Bewertung zu sortieren

So sortieren Sie nach einem Datums- und Uhrzeitfeld namens available_date:

• "orderBy": "available_date", um die Dokumente vom frühesten bis zum spätesten verfügbaren Datum zu sortieren

• "orderBy": "available_date desc", um die Dokumente vom spätesten zum frühesten verfügbaren Datum zu sortieren

So sortieren Sie nach geografischem Standort anhand eines Felds mit dem Namen location:

• Mit "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" werden die Dokumente entsprechend ihrer Entfernung von Mountain View sortiert, von den nächstgelegenen bis hin zu den am weitesten entfernten.

• Mit "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" werden die Dokumente nach der Entfernung zum Standort 37,38° N und 122,08° W sortiert, vom am weitesten entfernten bis hin zum nächstgelegenen.