🧭 Nodo Secuencial en el Estudio de Agentes IA: Construye Flujos Estructurados
El Nodo Secuencial te permite ejecutar varias acciones en un orden fijo, paso a paso, dentro de un solo nodo — ideal para recopilar datos y ejecutar operaciones predecibles sin depender de la interpretación de la IA en cada paso.
📋 Contenido de este Tutorial
🧭 ¿Qué es el Nodo Secuencial?
✨ Beneficios Clave
🧩 Tipos de Pasos Dentro del Nodo Secuencial
🔧 Variables: Cómo Fluyen los Datos Entre Pasos
🛠️ Cómo Configurar el Nodo Secuencial
❓ Preguntas Frecuentes
🧭 ¿Qué es el Nodo Secuencial?
El Nodo Secuencial es un componente central del Estudio de Agentes IA que ejecuta pasos predefinidos en un orden fijo, de arriba hacia abajo, sin tomar decisiones dinámicas en el camino. Cada paso debe completarse antes de que comience el siguiente.
Se activa cuando recibe una entrada desde un disparador o desde otro nodo del flujo. Antes de usarlo, asegúrate de que un disparador esté configurado para iniciar el agente.
✨ Beneficios Clave
Ejecuta pasos en un orden claro y predecible.
Garantiza resultados consistentes y repetibles.
Simplifica el diseño del flujo agrupando varios pasos en un solo nodo.
Permite una recolección de datos limpia y estructurada.
Reduce la complejidad frente a manejar varios nodos separados.
🧩 Tipos de Pasos Dentro del Nodo Secuencial
Dentro de un Nodo Secuencial puedes combinar tres tipos de pasos: herramientas de captura de información, acciones y llamadas a API, y generación de contenido con IA.
Captura de Información:
Correo Electrónico: captura y valida el formato de un correo, guardándolo como variable para usarlo más adelante.
Número de Teléfono: recolecta un número de teléfono con validación, normalmente exigiendo el código de país.
Texto Libre: permite que el usuario escriba una respuesta abierta, con control sobre la longitud mínima y máxima.
Selección Única: presenta un conjunto de opciones predefinidas como botones para que el usuario elija una.
Acciones y Llamadas a API:
Llamada a API: envía una solicitud a un sistema externo y recibe una respuesta, sin ningún tipo de interpretación por parte de la IA — los datos se envían y se reciben tal cual.
Acciones: ejecuta operaciones predefinidas dentro de CRMHUB, convirtiendo los datos recolectados en cambios reales del sistema (actualizaciones, disparos de automatizaciones, etc.).
Generación de Contenido con IA:
Generación de Texto: produce contenido escrito con IA a partir de un prompt.
Generación de Imágenes: crea imágenes con IA a partir de un prompt definido.
Generación de Video: crea videos con IA, con configuración de resolución y proporción de aspecto.
Generación de Audio (Texto a Voz): convierte texto en audio hablado usando modelos de texto a voz.
🔧 Variables: Cómo Fluyen los Datos Entre Pasos
Cada paso de procesamiento crea automáticamente una variable de tiempo de ejecución que almacena su resultado. Estas variables pueden usarse en los pasos posteriores, permitiendo que la información fluya a lo largo de toda la secuencia.
Ejemplo: si el Paso 1 captura el correo [email protected], el mensaje del Paso 2 puede referenciar esa variable de correo para confirmar: "¡Gracias! Te contactaremos a tu correo en breve."
Para usar una variable de un paso anterior: guarda el paso que captura la información (esto crea la variable automáticamente), haz clic dentro de un campo del paso siguiente (prompt, cuerpo de la API, etc.), haz clic en el ícono de llaves para abrir el selector de variables, y elige la variable deseada.
Las llamadas a API dentro del Nodo Secuencial también generan una variable con su respuesta, que puede reutilizarse en pasos posteriores.
🛠️ Cómo Configurar el Nodo Secuencial
Paso 1: Agrega el Nodo Secuencial. Desde el panel de nodos del Estudio de Agentes IA, agrega el Nodo Secuencial y conéctalo a un disparador o a un nodo anterior.
Paso 2: Agrega pasos de procesamiento. Haz clic en "Agregar un paso de procesamiento" para comenzar a construir tu secuencia. Puedes agregar pasos con el botón correspondiente o arrastrándolos, hacer clic en cada uno para configurarlo, y pasar el cursor sobre un paso para eliminarlo.
Paso 3: Configura cada paso. Define el prompt o pregunta, las reglas de validación y el comportamiento de cada paso individual.
Paso 4: Ordena los pasos. Asegúrate de que los pasos estén en el orden correcto, ya que la ejecución depende estrictamente de ese orden.
Paso 5: Usa variables entre pasos. Inserta las variables generadas por pasos anteriores en los prompts, mensajes o campos de API de los pasos siguientes, usando el ícono de llaves.
Paso 6: Agrega Acciones o Llamadas a API. Cuando necesites hacer algo con los datos recolectados o generados (guardarlos, enviarlos a otro sistema, disparar procesos), agrega un paso de Acciones o de Llamada a API y configura los campos requeridos: para Acciones, elige la operación a realizar; para Llamadas a API, ingresa el endpoint, los encabezados y el cuerpo de la solicitud.
Paso 7: Conecta el nodo siguiente. Enlaza el Nodo Secuencial con el siguiente paso de tu flujo (un Enrutador, un Nodo de Agente IA, un mensaje de confirmación, etc.).
❓ Preguntas Frecuentes
¿Cuándo debo usar el Nodo Secuencial en vez del Nodo de Agente IA? Usa el Nodo Secuencial cuando necesites un flujo estructurado y predecible. Usa el Nodo de Agente IA cuando la interacción requiera decisiones dinámicas o una conversación.
¿Por qué mi llamada a API no "razona" ni se adapta como una respuesta de IA? Las llamadas a API dentro de un Nodo Secuencial se ejecutan directamente, sin ninguna interpretación: solo envían una solicitud y devuelven una respuesta. Si necesitas razonamiento o procesamiento contextual, esa lógica debe manejarse con un Nodo de Agente IA.
¿Qué pasa si no uso variables en mis pasos? Sin variables, el flujo se vuelve estático y siempre produce el mismo resultado. Las variables son las que permiten que la entrada del usuario y las salidas de cada paso influyan en las acciones posteriores.
¿Puedo reordenar los pasos después de agregarlos? Los Nodos Secuenciales están diseñados para ejecutarse en el orden en que se agregan los pasos, así que lo mejor es planificar la secuencia antes de construirla para evitar tener que rehacer el trabajo.