Frases de entrenamiento

Las frases de entrenamiento son frases de ejemplo de algo que los usuarios finales podrían escribir o decir, lo que se denomina expresiones de usuario final. Para cada intent, debes crear muchas frases de entrenamiento. Cuando una expresión de usuario final se parece a una de estas frases, Dialogflow hace una coincidencia con el intent.

Por ejemplo, la frase de entrenamiento “Quiero pizza” entrena a tu agente para que reconozca las expresiones de usuario final que son similares a esa frase, como “Obtener una pizza” o “Pedir pizza”.

No tienes que definir todos los ejemplos posibles, porque el aprendizaje automático integrado de Dialogflow expande tu lista con otras frases similares. Debes crear al menos de 10 a 20 frases de entrenamiento (según la complejidad del intent) para que el agente pueda reconocer una variedad de expresiones de usuario final. Por ejemplo, si deseas que tu intent reconozca una expresión de un usuario final acerca de su color favorito, puedes definir las siguientes frases de entrenamiento:

  • “Me gusta el rojo”
  • "Mi color favorito es el amarillo"
  • "negro"
  • “El azul es mi color favorito”
  • ...

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. Para acceder a los datos de la frase de entrenamiento, haz lo siguiente:

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona un agente.
  3. En el menú de la barra lateral izquierda, selecciona Intents.
  4. Selecciona un intent.
  5. Desplázate hasta la sección Frases de entrenamiento.

Si compilas un agente con la API en lugar de la consola, consulta la referencia de los intents. Los nombres de los campos de la API son similares a los de la consola. En las instrucciones que se detallan continuación, se resaltan las diferencias importantes entre la consola y la API.

Agrega frases de entrenamiento

Para agregar frases de entrenamiento a un intent, haz lo siguiente:

  1. Haz clic en el campo de texto que muestra “Agregar expresión de usuario”.
  2. Escribe tus frases de entrenamiento y presiona la tecla Enter después de cada una.

Anota las frases de entrenamiento

Cuando se detecta una coincidencia con un intent en el entorno de ejecución, Dialogflow proporciona los valores extraídos de la expresión del usuario final en forma de parámetros. Cada parámetro tiene un tipo que se denomina tipo de entidad, el cual determina cómo se extraen los datos de forma exacta. A diferencia de la entrada sin procesar del usuario final, los parámetros son datos estructurados que se pueden usar con facilidad para realizar alguna lógica o generar respuestas.

Cuando compilas un agente, puedes controlar cómo se extraen los datos mediante anotaciones de fragmentos en tus frases de entrenamiento y la configuración de los parámetros asociados.

Por ejemplo, considera una frase de entrenamiento como “¿Cuál es el pronóstico para mañana en Tokio?” Debes anotar “mañana” con un parámetro date y “Tokio” con un parámetro location. Cuando anotas fragmentos de una frase de entrenamiento, Dialogflow reconoce que estos fragmentos son solo ejemplos de valores reales que proporcionarán los usuarios finales en el entorno de ejecución. Con una expresión de usuario final como “¿Cuál es el pronóstico para el viernes en Sídney?”, Dialogflow extraería el parámetro date de “Viernes” y el parámetro location de “Sídney”.

Si compilas un agente con la consola, la mayoría de las anotaciones se crean de forma automática cuando agregas frases de entrenamiento que contienen fragmentos que pueden coincidir con un tipo de entidad existente. Estos fragmentos están resaltados en la consola. Puedes editar estas anotaciones y parámetros si lo necesitas.

Captura de pantalla de anotación de frase de entrenamiento

Para anotar una frase de entrenamiento con la consola de forma manual, haz lo siguiente:

  1. Selecciona el fragmento de la frase de entrenamiento que deseas anotar.
  2. Selecciona el tipo de entidad deseado de la lista.
  3. Se crea un parámetro para ti en la tabla de parámetros a continuación.
  4. Haz clic en el botón Guardar y espera hasta que el diálogo Entrenamiento del agente indique que se completó el entrenamiento.

Cuando compilas un agente con la API, debes anotar las frases de entrenamiento y configurar los parámetros de forma manual. Consulta los tipos TrainingPhrase y Parameter en la referencia de intents. El campo Part.alias asocia las anotaciones de frases de entrenamiento con parámetros particulares.

Entidades implícitas creadas por frases de entrenamiento

La mayoría de las entidades personalizadas se definen de manera explícita mediante la creación de tipos de entidades y el agregado de entradas de entidad. Sin embargo, las entidades personalizadas también pueden contener valores implícitos. Esto sucede cuando anotas el texto de una frase de entrenamiento y el texto anotado no es un valor definido por el tipo de entidad seleccionado. El texto anotado se convierte en un valor de referencia de entidad para la entrada de entidad agregada implícitamente. Si el tipo de entidad es una entidad de asignación, el texto también se convierte en sinónimo de la entrada de entidad.

Modos de plantilla y ejemplo

Cada frase de entrenamiento puede estar en uno de estos dos modos:

  • Modo de ejemplo: Esto se indica con el signo  a la izquierda de la frase de entrenamiento. Las frases de entrenamiento en modo de ejemplo se escriben en lenguaje natural y se anotan para la extracción de parámetros.
  • Modo de plantilla: Esto se indica con el signo  a la izquierda de la fase de entrenamiento. Las frases de entrenamiento en el modo de plantilla contienen referencias directas a los tipos de entidades.