Introducción a las acciones del bot
Una acción del bot es un componente que permite programar condiciones lógicas que conducen a respuestas y vincular las acciones del usuario para crear flujos conversacionales complejos. Las acciones del bot suelen activarse mediante intenciones, pero también pueden activarse mediante un filtro.
📌 Nota:
No hay ninguna diferencia técnica entre una «acción de inicio del bot» y una «acción del bot» estándar.
Ejecución de una acción del bot
Una acción del bot se ejecuta según estas reglas:
Llamadas a API: Se ejecutan en el orden de las conexiones API.
Condiciones: Se evalúan de arriba abajo. La primera condición coincidente determina la respuesta que se muestra al usuario.
Conexiones API
Tutorial en vídeo
Mira un tutorial paso a paso sobre la integración de API externas en tu plataforma ViaSay Chatbot en Tutoriales en vídeo.
Cuándo utilizar las conexiones API
Utiliza conexiones API cuando interactúes con sistemas externos mediante API web o una base de conocimientos alojada por ViaSay.
Añadir una conexión API
Haz clic en Añadir una conexión API.
Selecciona una API (nota: configura primero la API en la sección Integrate/APIs).
Ejecutar en paralelo
Las llamadas a API se ejecutan secuencialmente de forma predeterminada. Activa la opción «Ejecutar en paralelo» para ejecutar varias conexiones simultáneamente. Ten en cuenta que el orden de ejecución no se puede controlar en el modo paralelo.
Entradas y salidas
Entradas: Define los campos de entrada compatibles con la API. Para las entradas obligatorias:
Utiliza un nombre de variable del contexto del bot.
Envía valores fijos como cadenas.
Envía JSON convirtiéndolo primero en una cadena y luego volviendo a convertirlo mediante filtros y funciones de Jinja.
Salidas: Asigna nombres de variables para que la respuesta de la API aparezca en el contexto del bot. Evita conflictos entre las variables de salida.
Entrada predeterminada: «status_code» (almacena el código de estado de la API).
Bucles
Activa los bucles para realizar llamadas repetitivas a la API:
For: Especifica la variable de entrada que cambia.
En: Define la lista de elementos sobre los que se ejecutará el bucle (utiliza JMESPath).
Los bucles están limitados a 8 llamadas por API. .
Condiciones y respuestas
Condiciones
Sentencias IF: Utiliza Jinja para escribir condiciones. Se pueden utilizar variables, funciones y extensiones de ViaSay. Para una ejecución incondicional, utiliza IF True.
Ir a: Dirige al usuario a otro nodo del grafo conversacional. Las opciones incluyen:
Acción de usuario inicial: Redirige al inicio de otro caso de uso.
Acción de usuario actual: Mantiene al usuario en la acción actual (por ejemplo, después de una respuesta por malentendido).
Borrar: Define las variables que se borrarán después de la ejecución. Las opciones incluyen:
"erase_all": Restablece el contexto.«erase_all_except variable1, variable2»: Conserva las variables especificadas.
Eventos: Activa eventos para análisis cuando se cumple una condición.
Programadores
Añade programadores haciendo clic en el icono de acción.
Respuestas
Las respuestas son los mensajes que se muestran a los usuarios después de ejecutar una acción del bot. Se activan mediante condiciones dentro de las acciones del bot.