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 como expresiones de usuario final. Debes crear muchas frases de entrenamiento por cada intent. Cuando una expresión de usuario final se parece a una de estas frases, Dialogflow detecta la coincidencia con el intent.

Por ejemplo, la frase de entrenamiento “Quiero pizza” entrena a tu agente para que reconozca otras expresiones similares del usuario final, como “Pide una pizza” o “Se me antoja pizza”.

No es necesario que definas todos los ejemplos posibles, ya que el aprendizaje automático integrado de Dialogflow expande tu lista con otras frases similares. Debes crear al menos 10 frases de entrenamiento para que tu 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

Lo más común cuando se compila un agente es usar la consola de Dialogflow (consultar la documentación, abrir 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.
  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. 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 anotar distintas partes de tus frases de entrenamiento y configurar los parámetros asociados a fin de controlar la forma en que se extraen los datos.

Por ejemplo, considera una frase de entrenamiento como “¿Cuál es el pronóstico para mañana en Tokio?” Deberías 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 aparecen destacados 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.

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 los intents. El campo Part.alias asocia las anotaciones de las frases de entrenamiento con parámetros específicos.

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 format_quote 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 alternate_email a la izquierda de la frase de entrenamiento. Las frases de entrenamiento en el modo de plantilla contienen referencias directas a los tipos de entidades.