Entidades

Los tipos de entidades se usan para controlar cómo se extraen los datos de la entrada del usuario final.

Los agentes conversacionales (Dialogflow CX) proporcionan entidades del sistema predefinidas que pueden coincidir con muchos tipos comunes de datos. Por ejemplo, hay entidades del sistema que coinciden con fechas, horas, colores, direcciones de correo electrónico, etcétera. También puedes crear tus propias entidades personalizadas para detectar coincidencias en datos personalizados. Por ejemplo, podrías definir una entidad vegetal que coincida con los tipos de vegetales disponibles para la compra con un agente de supermercado.

Terminología de la entidad

El término entidad se usa en esta documentación y en la consola de Dialogflow CX para describir el concepto general de entidades. Cuando se analizan los detalles de la entidad, es importante entender términos más específicos:

  • Tipo de entidad: Define el tipo de información que deseas extraer de la entrada del usuario. Por ejemplo, verdura podría ser el nombre de un tipo de entidad. Si haces clic en Crear en la sección Tipos de entidades de la consola de Dialogflow CX, se crea un tipo de entidad. Cuando se usa la API, el término tipo de entidad hace referencia al tipo EntityType.

    Selecciona un protocolo y una versión para la referencia de EntityType:

    Protocolo V3 V3beta1
    REST Recurso de EntityType Recurso de EntityType
    RPC Interfaz de EntityType Interfaz de EntityType
    C++ EntityTypesClient No disponible
    C# EntityTypesClient No disponible
    Go EntityTypesClient No disponible
    Java EntityTypesClient EntityTypesClient
    Node.js EntityTypesClient EntityTypesClient
    PHP No disponible No disponible
    Python EntityTypesClient EntityTypesClient
    Ruby No disponible No disponible

  • Descripción(opcional): Describe el propósito del tipo de entidad, por ejemplo, "Esta entidad se activa cuando el usuario menciona un vegetal". Si pretendes usar la generación de IA para generar automáticamente sinónimos de valores de referencia, el modelo usará este campo para producir resultados de mayor calidad.

  • Entrada de entidad: Para cada tipo de entidad, puede haber muchas entradas de entidad. Cada entrada de entidad proporciona un conjunto de palabras o frases que se consideran equivalentes, un valor de referencia en la primera columna y uno o más sinónimos para ese valor de referencia en la segunda columna. Por ejemplo, si verdura es un tipo de entidad, puedes definir estas entradas de entidad:

    Valor de referencia Sinónimos
    cebolla de verdeo cebollín, cebolla verde
    pimiento pimentón, pimiento dulce
    carrot carrot
    papa papa, tubérculo

    En lugar de ingresar entradas de entidades y sinónimos de forma manual, puedes seleccionar la casilla de verificación Generar automáticamente __ sinónimos por entidad cuando crees una entrada de entidad nueva. El valor predeterminado es 3 sinónimos. La IA generará sinónimos según el valor de referencia y la descripción del tipo de entidad, y los ingresará en la tabla. Ten en cuenta que la lista de sinónimos también debe incluir el valor de referencia original para que se produzca una coincidencia con ese valor.

    Cuando se edita un tipo de entidad desde la consola de Dialogflow CX, cada fila de la pantalla es una entrada de entidad. Cuando se usa la API, el término entrada de entidad hace referencia al tipo Entity (EntityType.Entity o EntityType_Entity para algunos lenguajes de la biblioteca cliente).

  • Valor de referencia de una entidad y sinónimos: Algunas entradas de entidad tienen múltiples palabras o frases que se consideran equivalentes, como el ejemplo anterior de cebollín. Para estas entradas de entidad, debes proporcionar un valor de referencia y uno o más sinónimos.