Ordinare i risultati dai datastore di dati strutturati

Nota: questa funzionalità è un'offerta in anteprima, soggetta ai "Termini dell'offerta pre-GA" dei Termini di servizio specifici per Google Cloud. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. Inoltre, utilizzando questa funzionalità, accetti i Termini e condizioni di Anteprima dell'IA generativa ("Termini di anteprima"). Per questa funzionalità, puoi trattare i dati personali come descritto nell'Addendum per il trattamento dei dati Cloud, in conformità alle limitazioni e alle obbligazioni applicabili del Contratto (come definite nei Termini di anteprima).

Questa pagina spiega come ordinare i risultati di una query di ricerca eseguita su datastore strutturati e su datastore non strutturati con metadati.

Tipi di dati supportati per l'ordinamento dei risultati

Questi sono i tipi di campi in base ai quali puoi ordinare i risultati di ricerca:

• string
• number
• datetime
• geolocation

Prima di iniziare

Assicurati di avere un'app con un datastore che contenga dati strutturati o non strutturati con metadati.

Ordinare i risultati di ricerca

Per ordinare i risultati di ricerca per un datastore strutturato o per un datastore non strutturato con metadati, segui questi passaggi:

REST

Per utilizzare l'API per ordinare i risultati di ricerca per un'app con dati strutturati o dati non strutturati con metadati, utilizza il metodo engines.servingConfigs.search:

Nota:puoi eseguire ricerche in un'app utilizzando il metodo engines.servingConfigs.search e in un datastore utilizzando il metodo dataStores.servingConfigs.search. Per la seguente procedura, Google consiglia di eseguire la ricerca utilizzando il metodo engines.servingConfigs.search.

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla colonna ID.

2. Crea una query di ricerca e includi il campo orderBy.

   Termine chiave: in Vertex AI Search, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle 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"
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud .
   • APP_ID: l'ID dell'app Vertex AI Search.
   • QUERY: il testo della query da cercare.
   • ORDER_BY: l'ordine in cui sono disposti i risultati. L'ordine di ordinamento predefinito è crescente. Ad esempio, specificando date vengono restituiti i risultati dal meno recente al più recente. Per ottenere l'ordinamento decrescente, aggiungi desc al valore date, ad esempio, date desc. Per altri esempi, consulta Esempi di orderBy.

   Esempio di comando e risultato

   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 questo esempio, i documenti che contengono la parola "hotel" sono ordinati in base alla valutazione, dall'hotel Serenity Springs con una valutazione di 4,6 all'hotel Ocean Breeze con una valutazione di 4,1.

orderBy esempi

Per ordinare in base a un campo stringa denominato title:

• "orderBy": "title" per restituire i documenti in ordine alfabetico crescente in base al titolo.

• "orderBy": "title desc" per restituire i documenti ordinati in ordine alfabetico inverso (dalla Z alla A) in base al titolo.

Per ordinare in base a un campo numerico denominato rating:

• "orderBy": "rating" per ordinare i documenti dalla valutazione più bassa a quella più alta.

• "orderBy": "rating desc" per ordinare i documenti dalla valutazione più alta a quella più bassa.

Per ordinare in base a un campo data/ora denominato available_date:

• "orderBy": "available_date" per ordinare dal documento disponibile più recente a quello più lontano nel tempo.

• "orderBy": "available_date desc" per ordinare i documenti dalla data più lontana disponibile a quella più vicina.

Per ordinare in base alla geolocalizzazione in un campo denominato location:

• "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" ordina i documenti in ordine di distanza da Mountain View, dai più vicini ai più lontani.

• "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" ordina i documenti in ordine dalla posizione più lontana a quella più vicina alle coordinate 37,38° N e 122,08° O.