Obtener resultados de navegación personalizados

La navegación usa métodos de navegación para mostrar los resultados de 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 navegación de almacenes de datos de búsqueda genéricos.

Acerca de la navegación

En una aplicación de búsqueda de aplicaciones de IA, navegar es buscar sin ninguna consulta o con una consulta vacía. Si tiene un almacén de datos de búsqueda genérico que contiene datos estructurados, datos no estructurados con metadatos o datos de sitios web, puede enviar una consulta de búsqueda vacía para recibir resultados de navegación.

Cuando envías una solicitud de búsqueda, los documentos de tu almacén de datos que coinciden con los filtros se devuelven según las señales basadas en eventos. Para ofrecer una experiencia de navegación mejorada, puedes hacer lo siguiente:

  • Usa filtros en tu solicitud de búsqueda para acotar los resultados. Si usa la indexación avanzada de sitios web, consulte el artículo Usar datos estructurados para la indexación avanzada de sitios web para saber cómo añadir metadatos a su esquema y usarlos para enriquecer sus campos de filtro y de impulso.
  • Añade una especificación de impulso para influir en el orden de los resultados devueltos impulsando o enterrando resultados específicos.
  • Interpretar los eventos de usuario y registrarlos. Google usa tus eventos de usuario para optimizar la clasificación de los resultados en función del porcentaje de clics.

En la siguiente tabla se muestran las diferencias entre buscar y navegar.

Función Buscar Explorar
Finalidad Buscar información específica Explorar y descubrir contenido
Ejemplo Búsqueda de "mejores restaurantes coreanos en Vancouver" en la Búsqueda de Google Buscar un restaurante por las categorías a las que podría pertenecer, como "Restaurantes > Coreanos > Vancouver > 4 estrellas o más"
User Intent Suelen estar orientados a objetivos Exploratorio
Punto de partida Una consulta o una palabra clave normalmente en una barra de búsqueda Un sitio web o una plataforma específicos que suelen usar un menú, una ruta de navegación, enlaces u otros métodos de navegación, como facetas
Método Introducir palabras clave o frases y aplicar la configuración de búsqueda y publicación Búsqueda con una consulta vacía, aplicación de la configuración de búsqueda y servicio
Resultados Una lista de resultados relevantes Todos los documentos del almacén de datos que coincidan con los filtros

Obtener resultados de navegación de una aplicación con datos de sitios web

Para usar la API y obtener resultados de búsqueda de una aplicación con datos de un sitio web,

  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. Llama al método engines.servingConfigs.search con una consulta vacía o sin consulta, como se indica a continuación:

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

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
    • APP_ID: el ID de la aplicación de Vertex AI Search que quieres consultar.
    • ORDER_BY: opcional. El orden en el que se organizan los resultados. El atributo por el que se debe ordenar debe tener una interpretación numérica; por ejemplo, date. Para obtener más información, consulta Ordenar resultados de búsqueda web.
    • FILTER: opcional, pero recomendado. Campo de texto para filtrar la búsqueda mediante una expresión de filtro. El valor predeterminado es una cadena vacía. Para obtener más información sobre cómo usar el campo filter, consulta Filtrar búsquedas genéricas de datos estructurados o no estructurados y Filtrar búsquedas en sitios web.
    • BOOST_SPEC: opcional. Una especificación para potenciar o ocultar documentos. Valores:
      • BOOST: un número de punto flotante en el intervalo [-1,1]. Si el valor es negativo, los resultados se degradan (aparecen más abajo en los resultados). Si el valor es positivo, los resultados se promocionan (aparecen más arriba en los resultados).
      • CONDITION: una expresión de filtro de texto para seleccionar los documentos a los que se aplica el aumento. El filtro debe dar como resultado un valor booleano. Para obtener información sobre la mejora de la búsqueda estructurada, consulta Mejorar los resultados de búsqueda.

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