Ordina i risultati dai datastore di dati strutturati (legacy)

Importante: Gemini Enterprise recupera i risultati di ricerca dall'assistente utilizzando StreamAssist. Ti consigliamo di utilizzare StreamAssist anziché Ricerca e risposta. Per saperne di più, consulta Visualizza i risultati di ricerca utilizzando StreamAssist.

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 contiene dati strutturati o non strutturati con metadati.

Ordina 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 console Google Cloud , vai alla pagina Gemini Enterprise.

      Vai ad App

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

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

   Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine engine nel contesto delle API. Un motore di Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su APP_TYPE_INTRANET.

   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 progetto.
   • APP_ID: l'ID dell'app.
   • QUERY: il testo della query da cercare.
   • ORDER_BY: l'ordine in cui sono disposti i risultati. L'ordinamento predefinito è crescente. Ad esempio, se specifichi 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 per valutazione, dal Serenity Springs Hotel con una valutazione di 4,6 all'Ocean Breeze Hotel 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 da quello con la valutazione più alta a quello con la valutazione più bassa.

Per ordinare in base a un campo datetime denominato available_date:

• "orderBy": "available_date" per ordinare i documenti dal più recente al più vecchio.

• "orderBy": "available_date desc" per ordinare i documenti da quello con la data di disponibilità più lontana a quello con la data di disponibilità più vicina.

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

• "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" ordina i documenti da quelli più vicini a Mountain View a quelli più lontani.

• "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" ordina i documenti dal più lontano al più vicino alla posizione 37,38°N e 122,08°O.