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, que se encuentra debajo del 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.

  • Busca 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 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 hacer preguntas de seguimiento que conservan el contexto de la búsqueda inicial.

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

  • Comentarios. Proporciona botones de 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 Cómo configurar 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 Cómo mostrar 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 los 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 cómo la IU muestra los resultados de la búsqueda de datos no estructurados, haz lo siguiente:

  1. En la consola de Google Cloud , 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 los datos estructurados

En el caso de 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 de la consola de Google Cloud 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 la 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 cómo configurar facetas, consulta Configura facetas para la IU.

Para configurar cómo la IU muestra los resultados de la búsqueda de datos estructurados, haz lo siguiente:

  1. En la consola de Google Cloud , 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 búsqueda 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 parámetros de configuración nuevos.

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

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

    1. Haz clic en el cuadro Título y selecciona un campo para asignarlo a los títulos de tus 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 Ninguna 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. Sigue estos pasos para agregar campos adicionales a los resultados de la búsqueda:

    1. Haz clic en el cuadro Texto 1 y selecciona un campo que quieras 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 darle contexto al valor en los resultados de la búsqueda. Por ejemplo, supongamos que seleccionaste price en el cuadro Texto 1 y el valor del precio de un artículo en particular es 42. Si actualizas el campo Plantilla a "Total Price: {value} USD", se mostrará "Precio total: USD 42" 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, sigue estos pasos:

    1. Expande la sección Configuración 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. Revisa el panel Vista previa para asegurarte de que los cambios se muestren correctamente.

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

Mostrar 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 de configuración 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 consola de Google Cloud , 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 de activación Usar el nombre visible configurado por el administrador para las fuentes.

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

REST

Actualiza el campo uiSettings.sourceAdminDisplayNameEnabled en el recurso WidgetConfig de la app llamando 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 región múltiple 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 región múltiple para tu almacén de datos.
  • PROJECT_ID: Es el número o ID de tu proyecto de Google Cloud .
  • LOCATION_ID: 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