Ordenar los resultados de los almacenes de datos estructurados

Nota: Esta función es una oferta de vista previa, sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de los Términos Específicos de los Servicios de GCP. Las funciones y los productos previos a la disponibilidad general pueden tener una asistencia limitada y los cambios que se produzcan en ellos podrían no ser compatibles con otras versiones previas a la disponibilidad general. Para obtener más información, consulta las descripciones de las fases de lanzamiento. Además, al usar esta función, aceptas los términos y condiciones de la vista previa de IA generativa ("Términos de la Vista Previa"). Para usar esta función, puedes tratar datos personales tal como se indica en la Adenda sobre Tratamiento de Datos de Cloud, de acuerdo con las restricciones y obligaciones aplicables del Contrato (tal como se definen en los Términos de la Vista Previa).

En esta página se explica cómo ordenar los resultados de una consulta de búsqueda realizada en almacenes de datos estructurados y en almacenes de datos sin estructurar con metadatos.

Tipos de datos admitidos para ordenar los resultados

Estos son los tipos de campos por los que puedes ordenar los resultados de búsqueda:

• string
• number
• datetime
• geolocation

Antes de empezar

Asegúrate de tener una aplicación con un almacén de datos que contenga datos estructurados o datos sin estructurar con metadatos.

Ordenar los resultados de búsqueda

Para ordenar los resultados de búsqueda de un almacén de datos estructurados o de un almacén de datos no estructurados con metadatos, sigue estos pasos:

REST

Para usar la API y ordenar los resultados de búsqueda de una aplicación con datos estructurados o datos no estructurados con metadatos, usa el método engines.servingConfigs.search:

Nota: Puedes buscar en una aplicación con el método engines.servingConfigs.search y en un almacén de datos con el método dataStores.servingConfigs.search. Para el siguiente procedimiento, Google recomienda buscar con el método engines.servingConfigs.search.

1. Busca el ID de tu aplicación. Si ya tienes el ID de tu aplicación, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

      Ir a Aplicaciones

   2. En la página Aplicaciones, busca el nombre de tu aplicación y consulta su ID en la columna ID.

2. Crea una consulta de búsqueda e incluye el campo orderBy.

   Término clave: en Vertex AI Search, el término aplicación se puede usar indistintamente con el término buscador en el contexto de las APIs.

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

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu Google Cloud proyecto.
   • APP_ID: el ID de la aplicación Vertex AI Search.
   • QUERY: el texto de la consulta que se va a buscar.
   • ORDER_BY: el orden en el que se organizan los resultados. El orden de clasificación predeterminado es ascendente. Por ejemplo, si se especifica date se devuelven los resultados de más antiguos a más recientes. Para obtener el orden descendente, añade desc al valor de date; por ejemplo, date desc. Para ver más ejemplos, consulta los ejemplos de orderBy.

   Ejemplo de comando y resultado

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

   En este ejemplo, los documentos que contienen la palabra "hotel" se ordenan por valoración, desde el Serenity Springs Hotel, con una valoración de 4,6, hasta el Ocean Breeze Hotel, con una valoración de 4,1.

orderBy ejemplos

Para ordenar por un campo de cadena llamado title:

• "orderBy": "title" para devolver los documentos en orden alfabético ascendente según el título.

• "orderBy": "title desc" para devolver los documentos ordenados alfabéticamente de forma inversa (de la Z a la A) según el título.

Para ordenar por un campo numérico llamado rating:

• "orderBy": "rating" para ordenar los documentos de menor a mayor valoración.

• "orderBy": "rating desc" para ordenar los documentos de mayor a menor valoración.

Para ordenar por un campo de fecha y hora llamado available_date, sigue estos pasos:

• "orderBy": "available_date" para ordenar los documentos desde el más reciente hasta el más antiguo.

• "orderBy": "available_date desc" para ordenar los documentos por fecha de disponibilidad, desde la más lejana hasta la más próxima.

Para ordenar los resultados según la geolocalización en un campo llamado location, sigue estos pasos:

• "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" ordena los documentos desde los más cercanos a Mountain View hasta los más lejanos.

• "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" ordena los documentos de más lejos a más cerca de la ubicación 37,38°N y 122,08°O.