Obtén resultados de navegación personalizados

La navegación usa métodos de navegación para mostrar los resultados de la búsqueda que coinciden con las categorías o los filtros seleccionados por el usuario final. La navegación devuelve resultados que se pueden personalizar. En esta página, se describe cómo obtener resultados de exploración para almacenes de datos de búsqueda genéricos.

Acerca de la navegación

En una app de búsqueda de AI Applications, explorar es buscar sin una consulta o con una consulta vacía. Si tienes un almacén de datos de búsqueda genérica que contiene datos estructurados, datos no estructurados con metadatos o datos de sitios web, puedes enviar una búsqueda vacía para recibir resultados de exploración.

Cuando envías una solicitud de exploración, los documentos de tu almacén de datos que coinciden con los filtros se devuelven según los indicadores basados en eventos. Puedes ofrecer una experiencia de navegación mejorada de las siguientes maneras:

  • Usa filtros en tu solicitud de búsqueda para acotar los resultados. Si utilizas la indexación avanzada de sitios web, consulta Cómo usar datos estructurados para la indexación avanzada de sitios web para comprender cómo agregar metadatos a tu esquema y usarlos para enriquecer tus campos de filtro y de refuerzo.
  • Agrega una especificación de refuerzo para influir en el orden de los resultados devueltos reforzando o descartando resultados específicos.
  • Comprender los eventos de usuario y registrarlos Google utiliza tus eventos del usuario para optimizar la clasificación de los resultados según la tasa de clics.

En la siguiente tabla, se presentan las diferencias entre la búsqueda y la exploración.

Función Buscar Explorar
Objetivo Cómo encontrar información específica Explorar y descubrir contenido
Ejemplo Búsqueda de "los mejores restaurantes coreanos en Vancouver" en la Búsqueda de Google Buscar un restaurante según las categorías a las que podría pertenecer, como "Restaurantes > Coreanos > Vancouver > 4 estrellas y más"
Intención del usuario Suelen estar orientadas a objetivos Exploratorio
Punto de partida Una consulta o palabra clave, por lo general, en una barra de búsqueda Un sitio web o una plataforma específicos que suelen usar un menú, rutas de navegación, vínculos o algún otro método de navegación, como facetas
Método Ingresar palabras clave o frases y aplicar la configuración de búsqueda y publicación Búsqueda con una consulta vacía y aplicación de la configuración de búsqueda y entrega
Resultados Una lista de resultados relevantes Todos los documentos del almacén de datos que coinciden con los filtros

Cómo obtener resultados de exploración para una app con datos de sitios web

Para usar la API y obtener resultados de exploración de una app con datos de sitios web, haz lo siguiente:

  1. Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la consola de Google Cloud , ve a la página AI Applications.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID en la columna ID.

  2. Llama al método engines.servingConfigs.search con una consulta vacía o sin consulta de la siguiente manera:

    REST

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/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",
"orderBy": "ORDER_BY",
"params": {
     "searchType": "0"
 },
"filter": "FILTER",
"boostSpec": "BOOST_SPEC",
}'

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • APP_ID: Es el ID de la app de Vertex AI Search que deseas consultar.
    • ORDER_BY: es opcional. Es el orden en el que se organizan los resultados. El atributo según el cual se ordena debe tener una interpretación numérica; por ejemplo, date. Para obtener más información, consulta Cómo ordenar los resultados de la búsqueda web.
    • FILTER: Es opcional, pero se recomienda. Es un campo de texto para filtrar tu búsqueda con una expresión de filtro. El valor predeterminado es una string vacía. Para obtener más información sobre el uso del campo filter, consulta Cómo filtrar la búsqueda genérica para datos estructurados o no estructurados y Cómo filtrar la búsqueda en sitios web.
    • BOOST_SPEC: es opcional. Es una especificación para aumentar o disminuir la visibilidad de los documentos. Valores:
      • BOOST: un número de punto flotante en el rango [-1,1]. Cuando el valor es negativo, los resultados se degradan (aparecen más abajo en los resultados). Cuando el valor es positivo, los resultados se promocionan (aparecen más arriba en los resultados).
      • CONDITION: Es una expresión de filtro de texto para seleccionar los documentos a los que se aplica el refuerzo. El filtro debe evaluarse como un valor booleano. Para obtener información sobre el aumento de la búsqueda estructurada, consulta Aumenta los resultados de la búsqueda.

    Deberías recibir una respuesta JSON similar a la siguiente respuesta truncada. La respuesta contiene resultados de la búsqueda detallados que se enumeran en el orden determinado por los campos establecidos en la solicitud de búsqueda.