Configura los resultados para la IU

En esta página, se describe cómo configurar los resultados para la IU de la app web, que es la interfaz que usan los usuarios para acceder a tu app.

Conceptos del Widget de la Búsqueda

Estos son algunos conceptos que te ayudarán a comprender cómo usar los controles de la pestaña IU.

  • Fragmento. Es una sección de texto corta, por lo general, una oración, bajo el título del documento. De forma predeterminada, se muestra un fragmento para cada resultado de la búsqueda de sitios web y datos no estructurados.

  • Búsqueda con una respuesta. Esta función proporciona un párrafo de información (la respuesta) sintetizado a partir de los principales resultados de sitios web o datos no estructurados. Puedes personalizar la cantidad de resultados principales en los que se basa la respuesta. De forma predeterminada, se resumen los cinco resultados principales para crear la respuesta. La búsqueda con una respuesta no se puede combinar con la búsqueda con seguimientos.

  • Búsqueda con seguimientos. Esta función para sitios web y datos no estructurados permite realizar preguntas adicionales que mantienen el contexto de la búsqueda inicial.

  • Autocompletar. Sugiere búsquedas en función de las primeras letras que ingresa un usuario en la barra de búsqueda. Para obtener más información, consulta Configura la función de autocompletar.

  • Comentarios. Proporciona botones Me gusta y No me gusta para que los usuarios puedan calificar la calidad de los resultados de la búsqueda. Esta información solo se envía a Google. Para obtener más información, consulta Configura los comentarios.

  • Metadatos. Si los datos están estructurados o incluyen metadatos, puedes configurar qué campos de los metadatos deseas incluir en los resultados de la búsqueda. También puedes asignar campos a nombres visibles para las facetas. Para obtener más información, consulta Configura facetas para la IU.

  • Nombre visible configurado por el administrador para las fuentes. Muestra el nombre visible configurado por el administrador para las fuentes de datos en la app web en lugar del tipo de conector. Para obtener más información, consulta Muestra los nombres visibles configurados por el administrador para las fuentes de datos.

Configura los resultados de la búsqueda para datos no estructurados o de sitios web

La IU para datos no estructurados y de sitios web ofrece las siguientes personalizaciones de búsqueda:

  • Búsqueda (un solo turno)
  • Búsqueda con una respuesta (búsqueda de un solo turno con resumen)
  • Búsqueda con seguimientos (búsqueda de varios turnos)

Para configurar la forma en que la IU muestra los resultados de la búsqueda de datos no estructurados, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. Haz clic en el nombre de la app que deseas editar.

  3. En el menú de navegación, haz clic en Configuraciones.

  4. Haz clic en la pestaña IU.

  5. Edita los campos de la pestaña.

  6. Usa el panel Vista previa para asegurarte de que los cambios se muestren como esperas.

  7. Haz clic en Guardar y publicar para aplicar los cambios.

Configura los resultados de la búsqueda para datos estructurados

Para los datos estructurados, de forma predeterminada, la IU muestra todos los pares nombre-valor de cada elemento en los resultados de la búsqueda. Puedes usar la página Configuraciones en la Google Cloud consola de para personalizar la forma en que la IU muestra los resultados de la búsqueda.

En la siguiente lista, se muestran los campos principales para mostrar los resultados de la búsqueda:

  • Título. Es el título de un elemento en el que un usuario puede hacer clic para seleccionarlo en un resultado de la búsqueda.
  • Miniatura. Es la URL de una imagen que se mostrará junto al título del elemento en un resultado de la búsqueda.
  • URL. Es una URL a la que se dirige al usuario cuando hace clic en el título del elemento.

Puedes mostrar hasta tres campos adicionales en los resultados de la búsqueda y configurar cómo aparecen.

Además, puedes seleccionar facetas para filtrar los resultados de la búsqueda y establecer nombres visibles para ellas. Para obtener más información sobre la configuración de facetas, consulta Configura facetas para la IU.

Para configurar la forma en que la IU muestra los resultados de la búsqueda de datos estructurados, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. Haz clic en el nombre de la app de búsqueda que deseas editar.

  3. Haz clic en Configuraciones.

  4. Haz clic en la pestaña IU.

  5. Si tienes varios almacenes de datos conectados a tu app, selecciona el almacén de datos para el que deseas configurar los resultados.

  6. Expande la sección Configura campos en los resultados.

  7. En el panel Vista previa, escribe una consulta y presiona Intro para ver cómo se muestran los resultados de la búsqueda con la configuración actual. La vista previa se actualiza automáticamente cuando ingresas una configuración nueva.

  8. Opcional: Haz clic en un ícono de dispositivo para ver la vista previa en formato para dispositivos móviles o de escritorio.

  9. Para configurar los campos principales (Título, Miniatura y URL) en los resultados de la búsqueda, haz lo siguiente:

    1. Haz clic en el cuadro Título y selecciona un campo para asignarlo a los títulos de los resultados de la búsqueda. O bien, selecciona Ninguno si no quieres que aparezcan títulos en los resultados de la búsqueda.

    2. Haz clic en el cuadro Miniatura y selecciona un campo para asignarlo a las imágenes en miniatura de los resultados de la búsqueda. O bien, selecciona Ninguno si no quieres que aparezcan imágenes en miniatura en los resultados de la búsqueda.

    3. Haz clic en el cuadro URL y selecciona un campo que se asigne a los elementos que se abren cuando los usuarios hacen clic en los títulos de los elementos en los resultados de la búsqueda. O bien, selecciona Ninguno si no quieres que los títulos de los elementos en los resultados de la búsqueda se vinculen a los elementos.

  10. Para agregar campos adicionales a los resultados de la búsqueda, haz lo siguiente:

    1. Haz clic en el cuadro Texto 1 y selecciona un campo que deseas mostrar en los resultados de la búsqueda. De forma predeterminada, solo se muestra el valor del campo en los resultados de la búsqueda.

    2. Haz clic en la flecha junto al cuadro Texto 1 para mostrar el cuadro Plantilla. El campo {value} en el cuadro Plantilla representa el valor del campo que se mostrará en el resultado de la búsqueda. Agrega texto antes o después del campo {value} (o ambos) para dar contexto al valor en los resultados de la búsqueda. Por ejemplo, supongamos que seleccionaste price en el cuadro Texto 1 y que el valor del precio de un elemento en particular es 42. Si actualizas el campo Plantilla a "Total Price: {value} USD", se mostrará "Total Price: 42 USD" en los resultados de la búsqueda de ese elemento.

    3. Para agregar campos adicionales, repite estos pasos para los cuadros Texto 2 y Texto 3.

  11. Para configurar los parámetros de facetas, haz lo siguiente:

    1. Expande la sección Parámetros de facetas.

    2. Selecciona un campo para establecerlo como faceta y, luego, ingresa un nombre visible.

    3. Para agregar más facetas, haz clic en Agregar faceta.

  12. Consulta el panel Vista previa para asegurarte de que los cambios se muestren correctamente.

  13. Haz clic en Guardar y publicar para aplicar los cambios.

Muestra los nombres visibles configurados por el administrador para las fuentes de datos

De forma predeterminada, la app web muestra el tipo de conector como etiqueta para las fuentes de datos de una sola instancia. Puedes activar el parámetro Usar el nombre visible configurado por el administrador para las fuentes para que la app web muestre el nombre visible personalizado que configuraste para cada fuente de datos.

Para activar o desactivar los nombres visibles configurados por el administrador para las fuentes de datos, haz lo siguiente:

Console

  1. En la Google Cloud consola de, ve a la página Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Haz clic en el nombre de la app que deseas editar.

  3. En el menú de navegación, haz clic en Configuraciones.

  4. Haz clic en la pestaña IU de búsqueda.

  5. En la sección Configuraciones generales, activa o desactiva el botón Usar el nombre visible configurado por el administrador para las fuentes.

  6. Haz clic en Guardar y publicar para aplicar los cambios.

REST

Para actualizar el campo uiSettings.sourceAdminDisplayNameEnabled en el recurso WidgetConfig de la app, llama al método engines.widgetConfigs.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
  -d '{
    "uiSettings": {
      "sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
    }
  }'

Reemplaza lo siguiente:

  • ENDPOINT_LOCATION: Es la multirregión para tu solicitud a la API. Especifica uno de los siguientes valores:
    • us para la multirregión de EE.UU.
    • eu para la multirregión de la UE
    • global para la ubicación global
    Para obtener más información, consulta Cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_ID: Es el número o el ID de tu Google Cloud proyecto.
  • LOCATION_ID: Es la ubicación geográfica de tu almacén de datos, como global. Para obtener más información, consulta Ubicaciones.
  • APP_ID: Es el ID de la app.
  • SOURCE_ADMIN_DISPLAY_NAME_ENABLED: Es un valor booleano. Especifica true para mostrar el nombre visible configurado por el administrador para las fuentes de datos o false para mostrar el tipo de conector.

Próximos pasos