La habilidad Workflow permite a los Administradores crear automatizaciones complejas usando componentes visuales como Execute Action, Function y Split Flow.
Los Workflows se ejecutan mediante un sistema independiente que funciona fuera del contexto del AI Agent. Esta separación garantiza un entorno de ejecución seguro y evita la exposición involuntaria de elementos confidenciales, como credenciales API, lógica JavaScript o valores de variables internas al AI Agent.
El AI Agent solo tiene acceso a:
- Variables enviadas explícitamente a un componente Start Flow.
- Variables de salida devueltas desde un componente End Flow.
El primer paso para usar un Workflow es crear una nueva Skill para un AI Agent.
Después de añadir un Workflow, podemos comenzar a editarlo.
Las siguientes secciones constituyen el Workflow:
Componente Interact with AI Agent
El componente Interact with AI Agent le permiten configurar cómo el AI Agent debe recuperar la información y enviarla de vuelta a los AI Agents.
Workflow: Componente Start Flow
El componente "Start Flow" es el punto de partida para definir el Workflow específico que un AI Agent puede usar durante una interacción. Se añade por defecto como habilidad de inicio del Workflow.
Le permite configurar cómo interactúa el AI Agent con sistemas externos, ya sea para recuperar datos, enviar actualizaciones o ejecutar operaciones predefinidas. De este modo, se garantiza que el AI Agent pueda ofrecer respuestas eficientes y adaptadas a las solicitudes de los usuarios.
El componente "Start Flow" tiene los siguientes parámetros:
- "Name": El nombre del Workflow. Puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 40 caracteres. Nota: Para mejores resultados, le recomendamos que use nombres sencillos y fáciles de entender.
- "Goal": La descripción del Workflow. Debe especificar el propósito del Workflow, como recuperar información, actualizar registros o ejecutar tareas predefinidas. Un objetivo bien definido garantiza que el AI Agent comprenda cómo usar el Workflow de manera efectiva para abordar las necesidades del usuario dentro de una conversación.
-
"AI Agent Input variables": Las variables de entrada definen los datos que necesita el Workflow para completar su tarea. Estas variables representan la información que el AI Agent recopila durante una conversación, como los datos facilitados por el usuario o los datos contextuales. Cada variable sirve como entrada al Workflow, asegurando que este cuente con todos los parámetros necesarios.
Workflow: Componente End Flow
El componente "End Flow" define las salidas del Workflow usado por el AI Agent, especificando qué variables se facilitarán al contexto del AI Agent.
Este componente garantiza que los datos recopilados o generados por el Workflow se transfieran correctamente al AI Agent para su posterior procesamiento o presentación. Al seleccionar las variables de salida relevantes, se determina qué información se usará para formar las respuestas del AI Agent, lo que permite interacciones dinámicas y contextualmente relevantes.
El componente de End Flow tiene los siguientes parámetros:
- "Name": El nombre del componente "End Flow". Puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 40 caracteres.
- "AI Agent Output variables": Las variables de salida representan los datos que se enviarán al AI Agent para su posterior procesamiento o para generar respuestas. Estas variables recopilan los resultados o conclusiones derivados del Workflow y son fundamentales para configurar las interacciones posteriores del AI Agent. Al definir estas variables de salida, se especifica qué datos influirán en las respuestas del AI Agent, lo que le permite ofrecer mejores respuestas basadas en los datos recopilados.
Para las "AI Agent Output variables", hay dos tipos de variables posibles para la salida:
- Variables de Workflow
- Variables de AI Agent Orchestration
Si selecciona las variables de Workflow (variables creadas durante el flujo de trabajo), deberá asignar su valor a una variable de AI Agent Orchestration.
Componentes generales
Workflow: Componente "Execute Action"
El componente "Execute action" le permite aprovechar Talkdesk Connections™ en un Workflow.
El Componente "Execute Action" tiene los siguientes parámetros:
- "Component name": El nombre del componente "Execute Action". El nombre solo puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 30 caracteres.
-
"Execute action": Seleccione una Talkdesk Connection predefinida para aprovechar los datos contenidos en un sistema de terceros.
- "Connection": La conexión que se va a aplicar. Primero debe crear una Talkdesk Connection y configurar la acción correspondiente para poder seleccionar una Connection de la lista desplegable.
- "Action": La acción que se llevará a cabo para cumplir las necesidades y los objetivos específicos. Primero debe crear una acción para poder seleccionarla en la lista desplegable.
- "Inputs": Defina un valor o variable para cada campo que desee incluir en la petición. Si la variable no existe en ninguna parte del flujo, se mostrará un error.
-
"Outputs": Defina un valor o variable para cada campo que almacene la respuesta a la petición. Si la variable de salida no existe, el Autopilot la creará.
Nota: Como se muestra en la imagen anterior, puede haber campos obligatorios, que están marcados con un asterisco rojo.
Workflow: Componente Function
El componente Function permite a los diseñadores de AI Agent acceder y gestionar datos mediante código JavaScript (por ejemplo, adaptar datos a un formato conversacional y especificar condiciones variables, entre otras funcionalidades).
El componente Function tiene los siguientes parámetros:
- "Component name": El nombre del componente Function. El nombre solo puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 30 caracteres.
-
"Function": Aquí puede definir el campo del editor de código para ejecutar el código JavaScript. En este componente, puede usar el código JavaScript estándar, así como los dos siguientes métodos que permiten a los diseñadores conversacionales gestionar las variables de Autopilot, concretamente:
- Context.getVariable(variable name): Consigue el valor de una variable. Este método permite conseguir los datos de las variables del sistema del AI Agent para que pueda usar esos valores en la ejecución lógica previamente definida.
- Context.setVariable(variable name, new value): Define el valor de una variable personalizada. Este método le permite configurar los datos de la variable del sistema de AI Agent para que pueda ejecutar la lógica que ha definido previamente y almacenar los datos transformados en una variable de AI Agent.
- El editor de código tiene 20 líneas por defecto y aumentará en altura si sigue editando debajo y desplazándose por el lateral.
- Hay un límite de 16 000 caracteres y otro para un tiempo de espera de ejecución de 2 segundos, lo que significa que si tiene un código que supera los 2 segundos de tiempo de ejecución, el código dejará de ejecutarse y el componente se moverá con la salida de error.
Workflow: Componente "Split Flow"
El componente "Split Flow" define las posibles ramificaciones que puede seguir un Workflow.
El componente "Split Flow" tiene los siguientes parámetros:
- "Component name": El nombre del componente "Split Flow". El nombre solo puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 40 caracteres.
- "If variable": Introduzca una variable para las validaciones, de modo que el flujo se pueda dividir en diferentes ramas. La variable debe tener un valor definido. Este valor puede provenir de una variable del sistema, rellenada en un componente Action, un componente Function o una salida de Execute action. En el campo "If variable", puede definir una lista de ramificaciones (es decir, validaciones o salidas) con su nombre (por ejemplo, > y =), tipo (Number o String) y un valor variable para la comparación de validación. Si el tipo es "Number", tiene que introducir un número válido.
- "Fallback exit": La Fallback exit es la ruta por defecto cuando no se cumple ninguna de las condiciones definidas. En el nodo del componente "Split Flow", puede ver que la salida por defecto se muestra junto con otras opciones de salida.
Workflow: Componente End Automation
El componente End Automation se usa para finalizar la sesión actual dentro de una AI Agent Orchestration.
Cuando se alcanza este componente, la AI Agent Orchestration devolverá uno de los dos estados posibles:
Opciones de estado de finalización
- Success: Indica que la sesión se ha completado como se esperaba.
- Escalation: Indica que la sesión no se pudo resolver y debe transferirse o marcarse para una gestión adicional.
Motivo de la escalada
Al usar el estado Escalation, los usuarios pueden facilitar información adicional pasando un valor junto con la escalada. Este valor puede ser:
- Una frase estática (por ejemplo, "El usuario solicitó un agente en vivo");
- Una variable (por ejemplo, {reason_for_escalation}); o
- Un objeto estructurado (por ejemplo, {"type": "billing_issue", "priority": "high"}).
Esta información adicional se puede usar en aplicaciones para consumidores (como Autopilot o Copilot) para gestionar mejor la escalada o redirigirla de forma adecuada.
El componente End Automation tiene los siguientes parámetros:
- "Name": El nombre del componente "End Automation". Puede contener letras, números (excepto como primer carácter) y guiones bajos, y puede tener una longitud máxima de 40 caracteres.
- "Studio exit": Una selección entre el estado "Success" o el estado "Escalation".
Workflow: Variables
La sección Workflow: Variables permite ver y controlar las variables que se usan en una Skill de Workflow y en todo el sistema del AI Agent. Se divide en dos pestañas principales:
1. Variables de Workflow
Esta pestaña muestra todas las variables del Workflow creadas dentro de la Skill del Workflow actual. Estas son variables definidas y usadas exclusivamente en lo que respecta al Workflow.
Cada variable en esta lista incluye:
- Variable name: Identificador usado en toda la lógica del flujo de trabajo.
- Description: Contexto para informar al AI Agent sobre el propósito de la variable.
- Possible values (opcional): Un conjunto de valores que ayuda al AI Agent a comprender mejor el tipo de información que se espera que recopile o con la que debe trabajar.
Los usuarios pueden:
- Crear nuevas variables directamente en esta pestaña.
- Editar las variables existentes
- Eliminar las variables que ya no se usan.
2. Variables de AI Agent Orchestration
Esta pestaña incluye todas las demás variables disponibles en el contexto más amplio de la AI Agent Orchestration. Combina:
- Variables del sistema facilitadas por la plataforma o las aplicaciones de consumo (por ejemplo, Autopilot o Copilot).
- Variables compartidas que se originan en otras Skills dentro del mismo sistema de AI Agent.
Nota: Estas variables son de solo lectura y no se pueden editar ni eliminar desde esta vista, pero son esenciales para comprender cómo fluyen los datos entre Skills y cómo funciona el sistema AI Agent en su conjunto.