Establece los parámetros de configuración de los campos

En esta página, se muestra cómo configurar los campos del esquema para configurar una app para datos estructurados, para datos no estructurados con metadatos o para datos de sitios web con atributos estructurados y personalizados.

La configuración de los campos ayuda a determinar cómo Agent Search usa los campos en sus resultados. Puedes usar la pestaña Esquema en la Google Cloud consola para configurar los parámetros de configuración de los campos.

La configuración de los campos solo está disponible para las apps con almacenes de datos que contienen datos estructurados o datos no estructurados con metadatos.

Configuración de campo

Los siguientes parámetros de configuración de los campos están disponibles para muchos tipos de campos en tus datos de búsqueda o recomendaciones, pero no para todos los tipos de datos. Un esquema contiene varios parámetros de configuración de los campos para campos individuales, y la siguiente tabla contiene parámetros de configuración que se pueden aplicar a un campo dentro de un esquema. Se recomienda usar datos estructurados para estos parámetros de configuración de los campos:

Configuración Definición Objetivo Ejemplo de caso de uso
Indexable

Si configuras los campos como indexables se permiten operaciones como el filtrado, el aumento y la creación de facetas en los campos estructurados dentro de un documento.

Los campos de tipo Object no se pueden configurar como Indexable.

Si marcas un campo como Indexable, se permiten búsquedas más rápidas.

Ten en cuenta que, si marcas un campo como Indexable, se aumenta el tamaño del índice de búsqueda y se puede ralentizar la indexación.

 En un almacén de datos de hoteles, puedes configurar un campo, como hotel_chain, como indexable. Esto te permite aplicar operaciones de clasificación, filtrado y aumento en hotel_chain. Por ejemplo, puedes aplicar un filtro para que la búsqueda solo muestre los resultados de la búsqueda que contengan la cadena hotelera filtrada.
Se pueden buscar

Los campos que tienen más probabilidades de estar relacionados con las búsquedas se designan como Searchable. Un campo puede ser apto para búsquedas sin ser indexable ni recuperable.

Solo los campos con valores de texto se pueden marcar como aptos para búsquedas. Por lo tanto, un campo de precio numérico puede ser indexable (para filtrar o crear facetas), pero no se puede buscar como texto completo.

Si configuras un campo como Se pueden buscar , se mejora su recuperación en las búsquedas, lo que permite a los usuarios encontrar contenido, como páginas web, consultando el texto dentro de estos campos. Si marcas un campo como apto para búsquedas, se puede aplicar la clasificación. Por lo tanto, si marcas una cantidad excesiva de campos como aptos para búsquedas, se puede afectar negativamente la precisión de la búsqueda, ya que se sobresatura el algoritmo de clasificación y se muestran demasiados resultados. Esto puede generar resultados de la búsqueda irrelevantes.

Puedes aplicar una ponderación relativa a los campos aptos para búsquedas; sin embargo, debido a los valores predeterminados sólidos, esto rara vez es necesario. Consulta Pondera los campos aptos para búsquedas a continuación.

El sistema de tickets de asistencia de un proveedor de servicios de Internet almacena cada ticket como un documento estructurado. Si estos documentos contienen campos de texto aptos para búsquedas, como issue_description o resolution_notes, un agente de asistencia puede realizar una consulta relacionada con el contenido de esos campos, como cómo solucionar la lentitud de la velocidad de Internet después de restablecer el módem. Luego, el sistema mostrará los documentos que contengan cualquiera de esos términos de búsqueda, incluidos módem, Internet y velocidad, en uno o ambos campos issue_description o resolution_notes.
Faceta dinámica Proporciona filtros contextuales para segmentar mejor las búsquedas de los usuarios. Si configuras un campo como Dynamic Facetable permite que el sistema genere automáticamente filtros interactivos (facetas) en función de los valores únicos presentes en el campo. Si configuras un campo como Dynamic facetable, los usuarios pueden refinar dinámicamente los resultados de la búsqueda seleccionando categorías o atributos derivados directamente de los datos ingeridos, sin tener que predefinir manualmente todas las opciones de filtro posibles. Esto permite que el usuario limite su búsqueda a contenido web muy específico.
Usa Faceta dinámica con Se pueden buscar para obtener mejores resultados, lo que mejora la recuperación de tu búsqueda y la calidad de las facetas que se ofrecen al usuario. 		Las páginas de una base de conocimiento corporativa interna, como las políticas de RR.HH., se ingieren con datos como department, document_type, o last_modified_date. Si estos campos están etiquetados como dynamic facetable, la búsqueda de un empleado de un término como reembolso de gastos genera dinámicamente filtros interactivos en función de los resultados pertinentes encontrados. En ese caso, la interfaz web podría mostrar facetas para Departamento: Finanzas, Viajes, Tipo de documento: Política, Preguntas frecuentes o Fecha de modificación más reciente: Este trimestre, Año pasado.
Recuperable Cuando una consulta de búsqueda encuentra contenido coincidente el motor de búsqueda puede extraer los valores de los campos recuperables para mostrarlos o usarlos en la aplicación, lo que significa que la información del documento original se muestra como parte de los resultados de la búsqueda. Los campos clave (identificadores únicos para documentos) se configuran como recuperables. Los campos recuperables proporcionan contexto de búsqueda al distinguir los campos cuyos valores se pueden mostrar de aquellos que solo se usarán en la lógica de búsqueda, pero cuyos valores sin procesar no están destinados a mostrarse al usuario final. Para una búsqueda de productos en un sitio de comercio, product_id, name, price y una image_url son campos típicos que deseas configurar como recuperables. Por otro lado, el internal_tracking_code se puede indexar y filtrar solo con fines administrativos, pero no se puede recuperar en los resultados de la búsqueda pública.
Completable Permite que el contenido de un campo se use para sugerencias de búsquedas. Para obtener más información, consulta Configura la función de autocompletar.

Este parámetro de configuración permite que los valores dentro de ese campo se usen para proporcionar sugerencias de consultas en tiempo real a medida que los usuarios escriben. Esta función ayuda a guiar a tus usuarios hacia el contenido pertinente y acelera el proceso de búsqueda. Ciertos factores, como el uso del filtrado de lenguaje natural , pueden afectar este rendimiento.

 Si el completable campo está configurado para product_name, brand, y category, cuando el usuario escribe Tecnología, las sugerencias de autocompletar pueden mostrar lo siguiente:
  • TechCo (del campo brand)
  • TechCo UltraBook X1 (del product_name campo)
  • Tecnología GameMaster Pro (otro producto del campo category)
Filtrable Permite que las recomendaciones usen un campo para filtrar resultados recomendados, lo que determina qué resultados de la búsqueda ven tus usuarios. Para obtener información sobre el filtrado de recomendaciones, consulta Filtra recomendaciones. Si configuras un campo como Filterable, se ayuda a personalizar las recomendaciones para los usuarios. Ten en cuenta que se aplican límites de filtrado. Un parámetro de configuración de filtro por idioma y drama podría verse de la siguiente manera: language_code: ANY("en", "fr") OR categories: ANY("drama").

Diferencias entre los parámetros de configuración de uso frecuente

Existen diferencias clave entre los parámetros de configuración de los campos indexables, aptos para búsquedas y recuperables. En la tabla, se resumen estas diferencias.

Función Indexable Se pueden buscar Recuperable
Rol principal Hace que el contenido del campo esté disponible para el motor de búsqueda Permite realizar consultas de texto completo en el contenido del campo Permite que el valor del campo se muestre en los resultados de la búsqueda
Análisis El contenido se procesa y se coloca en un índice. Por lo general, se somete a un análisis léxico extenso. El valor se almacena tal como está para mostrarse.
¿Puede ser...?
¿...apto para búsquedas? Sí (a menudo, es un requisito previo) N/A No necesariamente (puede ser recuperable sin ser apto para búsquedas)
¿...recuperable? No necesariamente No necesariamente N/A
¿...filtrable, ordenable o con facetas? Sí (por lo general, también es un requisito previo para estos) No directamente; estos son atributos separados que a menudo se basan en un campo indexable. No directamente; estos atributos se relacionan con la forma en que se indexa y se consulta el campo, no solo con la forma en que se muestra.

En la práctica, muchos campos que son fundamentales para la experiencia del usuario (como títulos, descripciones e información de identificación) a menudo se configuran como indexable, searchable y retrievable.

Limitaciones

Los parámetros de configuración de los campos tienen las siguientes limitaciones:

  • Puedes configurar hasta 50 campos como indexables, aptos para búsquedas, recuperables o con facetas dinámicas.
  • Para configurar un campo como con facetas dinámicas, primero se debe configurar como indexable.
  • Para cambiar el parámetro de configuración indexable, es necesario volver a indexar los datos, lo que puede demorar horas, en especial para los almacenes de datos grandes.

Si configuras campos para una app de búsqueda de contenido multimedia y deseas obtener información detallada sobre los campos del esquema, consulta Acerca de los documentos y almacenes de datos de contenido multimedia.

Actualiza la configuración de los campos

Para actualizar la configuración de los campos, sigue estos pasos:

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

    AI Applications

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

  3. Haz clic en Datos (Data).

  4. Haz clic en la pestaña Esquema. En esta pestaña, se muestra la configuración actual de los campos.

    No verás la pestaña Esquema si tu almacén de datos contiene datos básicos de sitios web o datos no estructurados sin metadatos.

  5. Haz clic en Editar.

  6. Selecciona o anula la selección de los parámetros de configuración de los campos que necesitas actualizar. No se admiten algunos parámetros de configuración de los campos. Por ejemplo, los campos numéricos no se pueden configurar como Se pueden buscar.

  7. Haz clic en Guardar para aplicar los cambios.

Si marcas un campo como apto para búsquedas, puedes especificar un peso para indicar su importancia relativa en los resultados de la búsqueda. En la mayoría de las situaciones, no es necesario que especifiques pesos para los campos individuales porque los pesos predeterminados funcionan bien.

Sin embargo, ajustar los pesos puede ser necesario en algunas situaciones, por ejemplo:

  • Estás migrando datos desde una plataforma de búsqueda existente que ya usa campos ponderados.

  • Cuando los pesos predeterminados no proporcionan resultados de la búsqueda satisfactorios. En particular, esto puede suceder cuando tienes muchos campos aptos para búsquedas y algunos son mucho más importantes que otros.

    Quizás, el resumen sea el campo más importante para las búsquedas, por lo que deseas priorizar ese texto.

    O bien, el esquema tiene un campo que contiene palabras clave muy pertinentes que son excelentes predictores para los resultados de la búsqueda, pero, debido a que este campo es mucho más corto que otros, su influencia a menudo se ve eclipsada por campos más largos. Si aumentas su peso, te aseguras de que tenga el impacto deseado.

Niveles de peso

Los pesos se agrupan en los siguientes niveles:

Importancia del campo Explicación
Muy baja Un valor bajo que el sistema aún considera cuando combina las puntuaciones de todos los campos. Si deseas aún menos peso para que el efecto sea insignificante, no marques el campo como apto para búsquedas.
Baja Un peso inferior al predeterminado.
Valor predeterminado El peso estándar para los campos aptos para búsquedas. Este peso proporciona un rendimiento razonablemente bueno para la mayoría de los casos.
Alta Un peso que es notablemente superior al predeterminado.
Muy alta Un peso dominante. Por lo general, lo reservas para, como máximo, un campo.

Actualización del esquema y reindexación

Para agregar pesos a los campos aptos para búsquedas, se requiere una actualización del esquema y la reindexación posterior de los datos en el almacén de datos. La actualización del esquema demora horas, y no hay un indicador confiable que te indique cuándo se completa la indexación, por lo que debes sobreestimar el tiempo de indexación.

Establece niveles de peso en los campos

La tarea de establecer niveles de peso para los campos puede ser tediosa porque solo debes realizar cambios pequeños y revisar cuidadosamente los resultados de la búsqueda después para verificar si hay consecuencias no deseadas. Después de cada cambio, debes esperar a que se complete la reindexación antes de poder evaluar el impacto del cambio.

Solo puedes configurar la ponderación de los campos de búsqueda a través de la API. Esta función no está disponible en la Google Cloud consola de.

Para establecer pesos, debes actualizar el esquema del almacén de datos a través del método de la API projects.locations.dataStores.schemas.patch.

  1. Si aún no tienes tu esquema ya, sigue las instrucciones para obtenerlo en Consulta una definición de esquema.

  2. Sigue las instrucciones para actualizar el esquema de manera programática. Agrega pesos a uno o más campos aptos para búsquedas, como en estos ejemplos:

    "summary": {
   "type": "string",
   "searchable": true,
   "weight": "high"
 },
 "uri": {
   "type": "string",
   "searchable": true,
   "weight": "low"
 },

    En este ejemplo, el campo summary se establece en un peso más alto de lo normal y el campo uri en un peso más bajo. Si deseas devolver un peso al valor predeterminado, configúralo como default.

    Los valores permitidos para el parámetro de peso son los siguientes:

    • very_low
    • low
    • default
    • high
    • very_high

  3. Espera a que se complete la reindexación y prueba el comportamiento de la búsqueda.

¿Qué sigue?