En esta sección, revisaremos el proceso de creación y modificación de intents, mediante la anotación de frases de entrenamiento dentro de ese intent y la visualización de respuestas al usuario.
Crea intents
Los intents conforman la mayor parte de la funcionalidad de tu agente. Para crear un intent, sigue estos pasos:
- Haz clic en el ícono para agregar (add) que está junto a Intents en el menú del lado izquierdo de la consola de Dialogflow.
- Ingresa un nombre para tu intent. Por lo general, el nombre de tu intent debe representar el tipo de consultas de usuarios que reconoce. Por ejemplo, si esperas que el usuario proporcione su color favorito, podrías nombrar a tu intent
favorite_color. - Haz clic en GUARDAR.
Define frases de entrenamiento
Una vez que creaste un intent, puedes definir las frases de entrenamiento para ese intent que representa lo que los usuarios dirían. Para definir las frases de entrenamiento dentro de un intent, sigue estos pasos:
- Selecciona el intent para el que quieres definir las frases de entrenamiento.
- En la sección frases de entrenamiento, haz clic en el campo de texto que dice "Agregar expresión del usuario".
Escribe tus frases de entrenamiento y presiona Intro después de cada una de ellas. Estas frases deben tener alguna diferencia entre ellas, pero expresar el mismo intent. Por ejemplo, si quieres que tu intent reconozca la entrada de un usuario sobre su color favorito, podrías definir las siguientes frases de entrenamiento:
- "Me gusta el rojo"
- "Mi color favorito es el amarillo"
- "negro"
- "El azul es mi color favorito"
Una vez que defines tus frases de entrenamiento, se destacan las palabras, frases o valores correspondientes a entidades conocidas.
Anota las frases de entrenamiento
Anotar tus frases de entrenamiento con entidades le indica a Dialogflow cómo analizar los parámetros desde la entrada del usuario. Por ejemplo, si anotaste frases de entrenamiento con la entidad "color", Dialogflow reconoce y extrae cualquier parámetro de color de la entrada del usuario. Cuando Dialogflow analiza los parámetros desde las declaraciones de los usuarios, esos parámetros están a tu disposición en la entrega.
Cuando defines tus frases de entrenamiento, la consola de Dialogflow anota las entidades del sistema de manera automática y las muestra en la tabla Acción y parámetros (Action and parameters); puedes editar estas anotaciones de forma manual, si es necesario. En la captura de pantalla siguiente aparece la entidad del sistema "color" extraída en la tabla Acción y parámetros (Action and parameters):
Si necesitas crear entidades personalizadas que no están incluidas en las entidades del sistema de Dialogflow, puedes hacerlo de forma manual con tus entidades del desarrollador.
Hay algunos casos en los que la consola de Dialogflow no anota los valores de las entidades en las frases de entrenamiento de manera automática. Para anotar una entidad de forma manual, sigue estos pasos:
- Destaca el valor correspondiente de la entidad en una frase de entrenamiento.
- Selecciona la entidad correspondiente de la lista. Por ejemplo, si tu frase de entrenamiento es "Me gusta el rojo", destacarás "rojo".
Selecciona la entidad
@sys.color.
Después de crear la entidad, esta aparece en la lista de entidades.
Muestra respuestas estáticas
Cada intent debería mostrar una respuesta, ya sea que se trate de una respuesta estática o una respuesta dinámica mostrada desde un webhook.
Para mostrar una respuesta de texto estático, sigue estos pasos:
- Dentro de un intent, desplázate hacia abajo hasta Respuestas.
En el campo de texto Respuesta de texto, escribe una respuesta y presiona Intro. Por lo general, tus respuestas deben guiar al usuario a que siga la gramática de la conversación. Por ejemplo, si quieres que el usuario diga su color favorito, podrías definir respuestas como: "¿Cuál es tu color favorito?" y "¿Cuál es el color que más te gusta?".
Haz clic en Guardar.
Muestra respuestas con un webhook
Puedes elegir mostrar respuestas con un webhook (entrega), en lugar de con respuestas de texto estáticas dentro de la consola de Dialogflow. Debes activar la entrega para cada intent.
Para habilitar la entrega, sigue estos pasos:
- Haz clic en la pestaña Entrega, en el menú del lado izquierdo.
Haz clic en el control deslizante que está junto a Webhook para que se habilite.
En el campo de texto de la URL, ingresa la URL completa para tu webhook.
Usa el editor intercalado
Otra alternativa es que puedes usar el editor intercalado de Dialogflow para crear y administrar la entrega. Dentro del editor intercalado, puedes escribir tu webhook de entrega en JavaScript y rápidamente implementar tu código en Cloud Functions para Firebase. Para implementar tu código con el editor intercalado, sigue estos pasos:
- Haz clic en la pestaña Entrega, en el menú del lado izquierdo.
Haz clic en el control deslizante que está junto a Editor intercalado para habilitarlo.
Haz clic en Implementar, debajo de la muestra de código.
Una vez que hayas habilitado un método de entrega, puedes activar la entrega para intents individuales. Si quieres activar la entrega para un intent, sigue estos pasos:
- Dentro de un intent, desplázate hacia abajo hasta la parte inferior de la página y haz clic en la flecha que está junto a Entrega.
Haz clic en el control deslizante que está junto a Enable webhook call for this intent (Habilitar llamada de webhook para este intent).
Haz clic en Guardar.
Para obtener más información sobre cómo usar la entrega, consulta Entrega.
Administra intents
Para borrar un intent, sigue estos pasos:
- Haz clic en la pestaña Intents, en el panel de navegación.
- Desplaza el cursor sobre el intent que deseas borrar.
- Haz clic en el ícono de la papelera delete_outline que aparece para borrar el intent.
Para borrar una frase de entrenamiento, sigue estos pasos:
- Busca la sección de Frases de entrenamiento y desplaza el cursor sobre la frase.
- Haz clic en el ícono de la papelera delete_outline que aparece para borrar la frase.
Para borrar un parámetro, sigue estos pasos:
- Busca la tabla Acción y parámetros (Action and parameters) y haz clic en los tres puntos more_vert que aparecen cuando desplazas el cursor sobre el nombre del parámetro.
- Haz clic en Borrar en el menú emergente.
Para borrar una respuesta de texto, sigue estos pasos:
- Busca la sección de Respuestas y desplaza el cursor sobre la respuesta que deseas borrar.
- Haz clic en el ícono de la papelera delete_outline que aparece para borrar la respuesta.
Operaciones por lotes
Para ser más eficiente, puedes realizar operaciones por lotes en varios intents a la vez.
Copia o mueve intents
Para copiar o mover uno o más intents a otro agente, sigue estos pasos:
- Desplázate sobre la lista de intents.
- Selecciona los intents que deseas copiar o mover a otro agente.
Haz clic en COPIAR (COPY) o en MOVER (MOVE).
Elige un agente de destino en el menú desplegable.
Otra opción es que verifiques cualquiera de las opciones adicionales siguientes:
- Copiar entidades relacionadas: esta opción copia o mueve las entidades relacionadas con los intents que se copian o se mueven.
- Reemplazar entidades: esta opción reemplaza las entidades con el mismo nombre.
- Reemplazar intents: reemplaza los intents con el mismo nombre.
Haz clic en INICIAR.
Borra intents
Para borrar uno o más intents, sigue estos pasos:
- Desplázate sobre la lista de intents.
- Selecciona los intents que deseas borrar.
- Haz clic en BORRAR.
- Haz clic en BORRAR para confirmar.
Prioridad de intents
Prioridad de intents te permite asignar una determinada prioridad a un intent. Si una frase de entrenamiento coincide con varios intents, se establecerá la coincidencia con el intent que tenga mayor prioridad.
Para cambiar la prioridad de intents, haz clic en el botón azul (predeterminado) que está a la izquierda del nombre del intent y selecciona la prioridad en el menú desplegable.
¿Necesitas ayuda? Visita nuestra