Frases de preparación

Las frases de entrenamiento son frases de ejemplo de lo que pueden escribir o decir los usuarios finales, también llamadas expresiones de usuario final. Por cada intención, se crean muchas frases de entrenamiento. Cuando la expresión de un usuario final se parece a una de estas frases, Dialogflow la asocia con la intención.

Por ejemplo, la frase de entrenamiento "Quiero pizza" entrena a tu agente para que reconozca las expresiones de los usuarios finales que sean similares a esa frase, como "Pide una pizza" o "Quiero pizza".

No tienes que definir todos los ejemplos posibles, ya que el aprendizaje automático integrado de Dialogflow amplía tu lista con otras frases similares. Debes crear al menos entre 10 y 20 frases de entrenamiento (en función de la complejidad de la intención) para que tu agente pueda reconocer una variedad de expresiones de los usuarios finales. Por ejemplo, si quieres que tu intención reconozca la expresión de un usuario final sobre su color favorito, puedes definir las siguientes frases de entrenamiento:

• "Me gusta el rojo"
• "Mi color favorito es el amarillo"
• "black"
• "El azul es mi color favorito"
• ...

Dónde encontrar estos datos

Cuando se crea un agente, lo más habitual es usar la consola de Dialogflow ES (consulta la documentación o abre la consola). Las instrucciones que se indican a continuación se centran en el uso de la consola. Para acceder a los datos de las frases de entrenamiento:

1. Ve a la consola de Dialogflow ES.
2. Selecciona un agente.
3. Selecciona Intenciones en el menú de la barra lateral de la izquierda.
4. Selecciona una intención.
5. Desplázate hacia abajo hasta la sección Frases de entrenamiento.

Si vas a crear un agente con la API en lugar de con la consola, consulta la referencia de intents. Los nombres de los campos de la API son similares a los nombres de los campos de la consola. Las instrucciones que se indican a continuación destacan las diferencias importantes entre la consola y la API.

Añadir frases de preparación

Para añadir frases de entrenamiento a una intención, sigue estos pasos:

1. Haz clic en el campo de texto que muestra "Añadir expresión de usuario".
2. Escribe tus frases de entrenamiento y pulsa la tecla Enter después de cada una.

Anotar frases de preparación

Cuando se encuentra una coincidencia con una intención en el tiempo de ejecución, Dialogflow proporciona los valores extraídos de la expresión del usuario final como parámetros. Cada parámetro tiene un tipo, denominado tipo de entidad, que determina exactamente cómo se extraen los datos. A diferencia de las entradas sin procesar de los usuarios finales, los parámetros son datos estructurados que se pueden usar fácilmente para realizar alguna lógica o generar respuestas.

Cuando creas un agente, controlas cómo se extraen los datos anotando partes de tus frases de entrenamiento y configurando los parámetros asociados.

Por ejemplo, considera la frase de entrenamiento "¿Qué tiempo va a hacer mañana en Tokio?". Deberías anotar "mañana" con un parámetro date y "Tokio" con un parámetro location. Cuando anotas partes de una frase de entrenamiento, Dialogflow reconoce que estas partes son solo ejemplos de valores reales que proporcionarán los usuarios finales en el tiempo de ejecución. En el caso de una expresión de usuario final como "¿Qué tiempo hará el viernes en Sídney?", Dialogflow extraerá el parámetro date de "Friday" (viernes) y el parámetro location de "Sydney" (Sídney).

Cuando creas un agente con la consola, la mayoría de las anotaciones se crean automáticamente al añadir frases de entrenamiento que contienen partes que se pueden asociar a un tipo de entidad. Estas partes se resaltan en la consola. Puedes editar estas anotaciones y parámetros según sea necesario.

Para anotar manualmente una frase de entrenamiento con la consola, sigue estos pasos:

1. Selecciona la parte de la frase de entrenamiento que quieras anotar.
2. Seleccione el tipo de entidad que quiera en la lista.
3. Se creará un parámetro en la tabla de parámetros que aparece más abajo.
4. Haz clic en el botón Guardar y espera hasta que el cuadro de diálogo Entrenamiento del agente indique que se ha completado.

Cuando creas un agente con la API, debes anotar las frases de entrenamiento y configurar los parámetros manualmente. 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 concretos.

Entidades implícitas creadas por frases de preparación

La mayoría de las entidades personalizadas se definen explícitamente creando tipos de entidades y añadiendo entradas de entidades. Sin embargo, las entidades personalizadas también pueden contener valores implícitos. Esto ocurre cuando anotas 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 añadida implícitamente. Si el tipo de entidad es una entidad de mapa, el texto también se convierte en un sinónimo de la entrada de la entidad.

Modos de ejemplo y plantilla

Cada frase de entrenamiento puede tener uno de estos dos modos:

• Modo de ejemplo: se indica con format_quote a la izquierda de la frase de entrenamiento. Las frases de entrenamiento en el modo de ejemplo se escriben en lenguaje natural y se anotan para extraer parámetros.
• Modo de plantilla: se indica con alternate_email a la izquierda de la frase de entrenamiento. Las frases de entrenamiento en el modo de plantilla contienen referencias directas a tipos de entidades.