¿Cómo utilizar Agentic Flow en wolkvox Studio?
Table of Contents
Introducción
Agentic Flow es una herramienta de inteligencia artificial integrada en wolkvox Studio que permite crear, modificar y adaptar flujos de enrutamiento mediante instrucciones en lenguaje natural, sin necesidad de configurar manualmente cada componente del diagrama.
A través de un asistente conversacional, el administrador puede describir los cambios que necesita realizar. Agentic Flow interpreta las instrucciones, identifica los componentes y las conexiones del flujo, y ejecuta las modificaciones directamente sobre el diagrama de enrutamiento.
La herramienta también permite consultar otros routing points existentes para utilizar su estructura como referencia y adaptar su funcionamiento a un nuevo flujo. Por ejemplo, es posible solicitar que un IVR de voz se convierta en un flujo de chat, conservando su lógica de atención y reemplazando los componentes específicos del canal de voz por sus equivalentes para chat.
Para solicitudes que requieren múltiples modificaciones, Agentic Flow dispone del modo Plan, que organiza el trabajo en tareas individuales, permite seguir su ejecución y realiza la compilación del flujo al finalizar el plan.
Agentic Flow está disponible en los routing points de tipo Voice Flow y Chat Flow de wolkvox Studio.
¿Para qué sirve Agentic Flow?
Con esta herramienta puedes:
- Crear y modificar flujos mediante instrucciones: solicitar cambios en el diagrama describiendo en lenguaje natural lo que necesitas.
- Adaptar flujos entre canales: utilizar un routing point de voz como referencia para construir un flujo equivalente de chat, adecuando los componentes a las características del canal.
- Reutilizar configuraciones existentes: consultar otros routing points para aprovechar su estructura y funcionamiento en nuevos diseños.
- Modificar componentes y conexiones: solicitar cambios en los componentes utilizados, las condiciones, las rutas y las conexiones del flujo.
- Automatizar modificaciones complejas: dividir una solicitud en tareas organizadas mediante el modo Plan, evitando realizar cada modificación individualmente.
- Supervisar la ejecución de cambios: consultar el estado de las tareas, los resultados obtenidos y las modificaciones realizadas en el diagrama.
- Validar los cambios: revisar la compilación del flujo y utilizar las herramientas de prueba de wolkvox Studio para comprobar su funcionamiento.
¿Cómo utilizar Agentic Flow en wolkvox Studio?
Acceder a Agentic Flow
Ingresa a wolkvox Manager y abre la sección wolkvox Studio desde el menú lateral izquierdo. En la pestaña Diagram Routing, abre el routing point de tipo Voice Flow o Chat Flow que deseas configurar. En la parte superior izquierda del editor, encima del identificador y tipo de routing point, encontrarás un botón con un ícono de estrella roja. Haz clic en la estrella para abrir Agentic Flow.
Al activar la herramienta, aparecerá un panel lateral izquierdo con el asistente conversacional, desde el cual podrás enviar instrucciones y consultar las respuestas de la inteligencia artificial.
El lienzo de diseño permanecerá disponible al lado derecho para visualizar las modificaciones realizadas sobre el flujo.

Seleccionar el modo de funcionamiento
En la parte inferior del panel de Agentic Flow encontrarás un menú desplegable que permite seleccionar el modo de funcionamiento del asistente.
Las opciones disponibles son:
- Agent
- Plan
- Ask
Para realizar modificaciones que requieren varias tareas relacionadas, puedes utilizar el modo Plan.
Este modo permite que Agentic Flow analice la solicitud, la divida en una secuencia de actividades y ejecute los cambios necesarios de manera organizada.
Ejemplo: si necesitas adaptar un IVR de voz a un flujo de chat, el modo Plan puede identificar los componentes del flujo original, determinar cuáles deben reemplazarse y establecer las modificaciones necesarias para conservar el comportamiento esperado.

Enviar instrucciones a Agentic Flow
En la parte inferior del panel encontrarás un campo para escribir las instrucciones que deseas enviar al asistente. Puedes realizar las solicitudes de dos maneras:
Mediante texto
- Escribe una instrucción describiendo el cambio que necesitas realizar.
- Identifica el routing point que deseas modificar y, cuando corresponda, el identificador de otro flujo que quieras utilizar como referencia.
- Envía la instrucción para que Agentic Flow la procese.

Mediante voz
- Haz clic en el botón con el ícono de micrófono, ubicado a la derecha del campo de entrada.
- Dicta la instrucción que deseas enviar.
- Durante la grabación aparecerá una representación de las ondas de audio y el tiempo transcurrido.
- Si deseas descartar la grabación, utiliza el botón con el ícono de papelera.
- Para enviar la grabación, haz clic en el botón con el ícono de avión de papel.
El sistema transcribe el contenido de voz a texto para que Agentic Flow pueda interpretar la solicitud.
Recomendación: proporciona instrucciones específicas, indicando qué deseas conservar y qué necesitas modificar. Si el trabajo involucra otro routing point, incluye su identificador para que el asistente pueda localizarlo.


Solicitar la creación o modificación de un flujo
Una vez seleccionado el modo de funcionamiento, describe el resultado que necesitas obtener.
Por ejemplo, para adaptar un IVR de voz a un flujo de chat, puedes enviar una instrucción como la siguiente:
Necesito adaptar el routing point de tipo Voice Flow con ID 61005 a este Chat Flow. Conserva la lógica de atención, las validaciones, las condiciones y las rutas del flujo original. Reemplaza los componentes de reproducción de audio y mensajes de voz por componentes compatibles con chat, y adapta las conexiones y las respuestas conversacionales para que funcionen correctamente en este canal.
Cuando se utiliza el modo Plan, Agentic Flow analiza la solicitud y determina las actividades necesarias para realizarla.
En el ejemplo de adaptación de un IVR a chat, el asistente puede realizar acciones como:
- Abrir el routing point de origen para consultar su estructura.
- Identificar los componentes de audio y texto a voz (TTS).
- Reemplazar los componentes de voz por componentes Send Chat, utilizados para enviar mensajes en el canal de chat.
- Adecuar los componentes conversacionales y sus conexiones, incluyendo las salidas NO-MATCH cuando corresponda.
- Conservar y adaptar las condiciones de decisión y las diferentes rutas de atención.
- Incorporar los mensajes necesarios para el inicio, desarrollo y finalización de la conversación.
- Validar la estructura del diagrama y realizar su compilación al finalizar.
Estas actividades dependen de las características del flujo original y de las instrucciones proporcionadas.

Supervisar la ejecución de las tareas
Cuando Agentic Flow trabaja en modo ‘Plan’, en la parte inferior de su panel se muestra una tabla con las tareas identificadas para completar la solicitud.
La tabla contiene las siguientes columnas:
- Task: describe la actividad que debe ejecutar Agentic Flow.
- Status: indica el estado de ejecución de cada tarea.
- Result: muestra el resultado obtenido al ejecutar la actividad.
Los estados visibles durante el proceso incluyen:
- pending: la tarea está pendiente de ejecución.
- running: la tarea se encuentra en ejecución.
- done: la tarea ha finalizado.
Por encima de la tabla se muestra el historial de la conversación, que incluye las instrucciones enviadas, las respuestas del asistente y los avances de la ejecución.
Por ejemplo, puedes observar mensajes que indican que Agentic Flow está abriendo un routing point, reemplazando determinados componentes o comprobando las modificaciones realizadas.
También se muestra el avance del plan mediante mensajes como Step 2 of 8, que indican la tarea que se está ejecutando y el número total de actividades planificadas.
Durante este proceso, el diagrama de enrutamiento se va actualizando con los cambios realizados.
Importante: cuando una solicitud comprende múltiples tareas, su ejecución puede requerir más tiempo que una modificación sencilla. Puedes consultar el estado de cada actividad y las respuestas del asistente para conocer su avance.

Revisar las modificaciones realizadas en el diagrama
Mientras Agentic Flow ejecuta las instrucciones, puedes observar las modificaciones directamente en el lienzo de diseño del routing point.
Los cambios pueden incluir la incorporación de nuevos componentes, el reemplazo de elementos existentes, la modificación de condiciones y la actualización de las conexiones entre componentes.
Por ejemplo, al adaptar un flujo de voz a chat, los componentes utilizados para reproducir mensajes de voz pueden sustituirse por componentes destinados a enviar mensajes escritos.
También pueden modificarse las conexiones de los componentes conversacionales para adaptarlas al funcionamiento del canal de chat.
Una vez finalizadas las tareas, revisa que:
- Los componentes utilizados correspondan al canal del routing point.
- Las rutas de atención y las condiciones de decisión mantengan el comportamiento requerido.
- Los mensajes enviados al usuario sean adecuados para el canal.
- Las conexiones entre componentes permitan continuar o finalizar las conversaciones según lo esperado.
- Los componentes que dependen de variables o información externa mantengan la configuración necesaria.
Si encuentras algún comportamiento que deba corregirse, puedes enviar nuevas instrucciones a Agentic Flow indicando los cambios específicos que necesitas realizar.

Verificar la compilación del flujo
Al completar las tareas del modo Plan, Agentic Flow realiza la compilación del flujo.
En la parte inferior del editor de wolkvox Studio encontrarás la pestaña Compile Log, donde puedes consultar los resultados del proceso.
Durante una compilación exitosa, pueden aparecer mensajes como:
- No syntax errors detected: no se detectaron errores de sintaxis.
- Loading compiled chat file: se está cargando el archivo compilado del flujo de chat.
- Upload successful: el archivo se cargó correctamente.
Estos mensajes permiten comprobar que el flujo superó las validaciones de compilación y que el proceso de carga se completó.
Importante: una compilación exitosa no garantiza que todas las respuestas y condiciones del flujo se comporten exactamente como se espera. Por esta razón, es necesario realizar pruebas funcionales después de modificar el diagrama.
Si la compilación presenta errores, revisa la información de Compile Log, realiza las correcciones necesarias y vuelve a compilar el flujo antes de utilizarlo.

Probar el funcionamiento del flujo de chat
Después de finalizar la configuración y verificar la compilación, puedes probar el routing point de tipo Chat Flow mediante la funcionalidad Probar ChatBot de wolkvox Studio.
Para hacerlo:
- En la barra de herramientas del editor del flujo, haz clic en el botón negro con un triángulo blanco, correspondiente a Probar ChatBot.
- Se abrirá un panel lateral derecho llamado Test CHATBOT.
- En la parte inferior del panel encontrarás el campo para escribir mensajes de prueba. Escribe un mensaje inicial, por ejemplo, «Hola».
- Consulta las respuestas generadas por el flujo y verifica que coincidan con la lógica configurada. Continúa la conversación con diferentes solicitudes para comprobar el funcionamiento de las rutas, condiciones y componentes.

Por ejemplo, si adaptaste un IVR bancario para atención mediante chat, puedes probar consultas sobre saldos, información de productos o solicitudes que activen diferentes rutas del flujo.
Las respuestas aparecerán en el historial del panel Test CHATBOT, junto con los mensajes enviados durante la prueba.
Adicionalmente, puedes consultar la pestaña Debug Log, ubicada en la parte inferior del editor de wolkvox Studio, para revisar información sobre la ejecución del flujo.
Durante las pruebas, el lienzo permite observar el recorrido de la interacción por los componentes del diagrama.
Recomendación: prueba distintas entradas y situaciones, incluyendo respuestas esperadas, respuestas no reconocidas, condiciones alternativas y finalización de conversaciones. Esto permitirá identificar posibles ajustes antes de utilizar el flujo en una operación real.


Realizar ajustes adicionales con Agentic Flow
Si durante las pruebas identificas que una respuesta no corresponde al comportamiento esperado, puedes volver a utilizar Agentic Flow para solicitar correcciones.
Por ejemplo:
Modifica el mensaje de bienvenida del flujo para que se envíe únicamente en formato de texto. Conserva las rutas y las condiciones actuales.
También puedes solicitar que se ajusten las conexiones de una condición, se reemplace un componente o se modifique el mensaje enviado en una determinada etapa de la conversación.
Después de realizar nuevos cambios, verifica nuevamente la compilación y ejecuta las pruebas correspondientes.
Este proceso permite ajustar progresivamente el funcionamiento del routing point sin tener que reconstruir manualmente todo el diagrama.
Recomendaciones para utilizar Agentic Flow
Para obtener mejores resultados al configurar flujos con Agentic Flow, ten en cuenta las siguientes recomendaciones:
- Define claramente el objetivo: describe el comportamiento que necesitas obtener, el canal y el resultado esperado.
- Utiliza el modo Plan para tareas complejas: especialmente cuando necesitas modificar varios componentes, adaptar rutas o utilizar otro flujo como referencia.
- Identifica los routing points: incluye los identificadores de los flujos involucrados cuando la solicitud requiera consultar o reutilizar una configuración existente.
- Especifica qué debe conservarse: si estás adaptando un flujo, indica cuáles son las condiciones, validaciones, mensajes o rutas que no deben modificarse.
- Revisa cada resultado: consulta las tareas completadas, las respuestas del asistente y los cambios realizados en el diagrama.
- Verifica las diferencias entre canales: un flujo de voz y uno de chat pueden requerir componentes y conexiones diferentes, incluso cuando comparten la misma lógica de atención.
- Compila y prueba antes de utilizar el flujo: comprueba que no existan errores de compilación y que las conversaciones sigan el recorrido esperado.
Agentic Flow facilita la construcción y modificación de routing points mediante inteligencia artificial, permitiendo al administrador concentrarse en definir la lógica y el comportamiento de las conversaciones, mientras la herramienta ejecuta las modificaciones correspondientes en el diagrama de wolkvox Studio.