Entidades del sistema

Dialogflow proporciona muchas entidades del sistema para extraer los tipos comunes de las expresiones del usuario final. Por ejemplo, el tipo @sys.color se puede usar para extraer valores como “rojo” o “azul”. Puedes ver la lista completa de entidades del sistema en la referencia de las entidades del sistema.

En la mayoría de las aplicaciones, los valores que proporcionan las entidades del sistema funcionan bien. Sin embargo, es posible que tu aplicación deba agregar otros valores para las entidades del sistema. Por ejemplo, es posible que quieras agregar “azul-verde” a la lista de valores para @sys.color. Algunas entidades del sistema se pueden extender para este propósito. La referencia de las entidades del sistema enumera las que se pueden extender. En las secciones restantes de este documento, se describe cómo extender las entidades del sistema.

La compatibilidad de las entidades del sistema es diferente para cada idioma. Si deseas obtener más detalles, consulta las limitaciones de entidades del sistema.

Dónde encontrar estos datos

Cuando compilas un agente, es más común usar la consola de Dialogflow ES (consulta la documentación, abre consola). En las instrucciones que se detallan a continuación, nos enfocaremos en el uso de la consola. Sigue estos pasos a fin de acceder a los datos de las entidades del sistema del agente:

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona un agente.
  3. Selecciona Entidades en el menú de la barra lateral izquierda.
  4. Selecciona la pestaña Sistema para ver las entidades del sistema.

Si quieres compilar el agente con la API en lugar de la consola, consulta la referencia sobre los tipos de entidades. Los nombres de los campos de la API son similares a los de la consola. En las instrucciones que se detallan continuación, destacaremos las diferencias importantes entre la consola y la API.

Extiende una entidad del sistema desde la página de entidades

En la página de entidades, puedes ver las entidades del sistema que usa tu agente y extenderlas si sigues estos pasos:

  1. Usa la entidad del sistema en uno de tus parámetros.
  2. Selecciona Entidades en el menú de la barra lateral izquierda.
  3. Selecciona la pestaña Sistema para ver las entidades del sistema.
  4. Las entidades del sistema que usa tu agente aparecen en una lista. Las entidades que se muestran en un color de fuente gris no son extensibles. Las que se muestran en un color de fuente normal son extensibles.
  5. Puedes seleccionar una entidad extensible y actualizar los valores extendidos.
  6. Proporciona entradas para la entidad con los valores con los que deseas extenderla.

Captura de pantalla de la pestaña de entidades del sistema

Extiende una entidad del sistema con la API

Si usas la API para extender las entidades del sistema, crea las extensiones de manera similar a cómo creas entidades personalizadas. Proporciona el nombre de la entidad del sistema que deseas extender y los valores con los que quieres extenderla. Si intentas extender una entidad del sistema no extensible, recibirás un error.

Extiende una entidad del sistema mientras anotas una frase de entrenamiento

Desde la sección de frases de entrenamiento de la página del intent, puedes extender una entidad del sistema mientras anotas una frase de entrenamiento. Si anotas una parte de una frase de entrenamiento de forma manual con una entidad del sistema extensible que no incluye el valor seleccionado, se te pedirá que agregues este valor a la entidad del sistema.