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 la 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:
- Ve a la consola de Dialogflow ES.
- Selecciona un agente.
- En el menú de la barra lateral izquierda, selecciona Intents.
- Selecciona un intent.
- 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:
- Haz clic en el campo de texto que muestra “Agregar expresión de usuario”.
- Escribe tus frases de entrenamiento y presiona la tecla
Enterdespués de cada una.
Anota las frases de entrenamiento
Cuando un intent coincide 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, llamado tipo de entidad, que 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 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.
Para anotar una frase de entrenamiento con la consola de forma manual, haz lo siguiente:
- Selecciona el fragmento de la frase de entrenamiento que deseas anotar.
- Selecciona el tipo de entidad deseado de la lista.
- Se crea un parámetro para ti en la tabla de parámetros a continuación.
- Haz clic en el botón Guardar y espera a que el cuadro de 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 forma explícita creando tipos de entidades y agregando entradas de entidades. Sin embargo, las entidades personalizadas también pueden contener valores implícitos. Esto sucede cuando anotas el texto de una frase de entrenamiento, en la que 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 la entidad para la entrada de entidad agregada de forma implícita. Si el tipo de entidad es una entidad de asignación, el texto también se convierte en un sinónimo de la entrada de la 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 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 fase de entrenamiento. Las frases de entrenamiento en el modo de plantilla contienen referencias directas a los tipos de entidades.