Nodos disponibles
Cada nodo representa una acción o decisión dentro del workflow. La clave para construir flujos mantenibles es que cada nodo tenga una responsabilidad clara.
Inicio
Marca visualmente el punto inicial del canvas. No ejecuta lógica, no responde y no transforma datos. Sirve para ordenar el flujo.
El bot responde
Es el nodo principal para conversar con el usuario o generar una respuesta usando IA.
Se usa para:
- Saludar y explicar opciones.
- Pedir información.
- Responder con datos de documentos o recursos.
- Ejecutar herramientas configuradas.
- Generar una salida estructurada para pasos posteriores.
Configuraciones importantes:
- Prompt: instrucciones del paso.
- Documentos y recursos: contexto RAG disponible para ese nodo.
- Herramientas: acciones que el agente puede ejecutar.
- Modo de ejecución:
- Ejecutar y continuar: responde internamente y pasa al siguiente nodo.
- Esperar respuesta: responde al usuario y espera un nuevo mensaje antes de continuar.
- Responder y terminar: responde y finaliza el workflow.
- Datos requeridos: lista de campos que el nodo debe recolectar antes de avanzar.
- Condición para avanzar: criterio que el mismo modelo evalúa antes de pasar al siguiente paso.
- Salida esperada: estructura que otros nodos pueden usar después.
Mensaje fijo
Devuelve un texto definido por el usuario sin usar IA. Es útil para respuestas cerradas, confirmaciones, avisos legales, mensajes de fallback o cierres del flujo donde no querés que el modelo reformule nada.
Se usa para:
- Confirmar recepción de una solicitud.
- Mostrar un mensaje estándar después de una rama.
- Cerrar el workflow con un texto exacto.
- Evitar consumo de IA cuando la respuesta no necesita interpretación.
El mensaje puede incluir contexto del flujo con placeholders, por ejemplo valores generados por nodos anteriores. Como no llama a un modelo, no consulta documentos, no usa herramientas y no completa datos faltantes.
Elegir camino
Es un nodo condicional basado en reglas. No conversa con el usuario. Evalúa datos existentes y elige una salida.
Se usa para:
- Separar caminos por respuestas exactas.
- Decidir según el output de un nodo anterior.
- Validar si existe un dato.
- Enviar a una rama de éxito, error o fallback.
Modos comunes:
- Sí / No: una expresión con salida verdadera o falsa.
- Mensaje contiene: útil para reglas simples sobre el texto del usuario.
- Múltiples opciones: varias condiciones con una salida default.
- Avanzado: expresión personalizada para casos técnicos.
Usalo cuando la decisión puede definirse con una regla clara. Si necesitás interpretar intención conversacional, usá Router conversacional.
Router conversacional
Clasifica la intención del usuario con IA y manda la conversación a la rama adecuada. A diferencia de “Elegir camino”, está pensado para lenguaje natural.
Se usa para:
- Separar consultas como “alquiler”, “venta”, “compra” u “otro”.
- Permitir que el usuario cambie de intención durante una conversación.
- Resolver frases ambiguas que no coinciden con una palabra exacta.
Cada rama puede tener:
- Etiqueta: nombre visible de la salida.
- Descripción: cuándo debe elegirse esa rama.
- Ejemplos: frases típicas que ayudan a clasificar.
Siempre conectá la salida default cuando pueda haber mensajes fuera de las opciones principales.
Ajustar lo que pasó antes
Transforma o selecciona información del paso anterior antes de enviarla al siguiente nodo.
Variantes:
- Pasar tal cual: no modifica la salida.
- Solo el texto de la respuesta: toma la parte textual.
- Usar la lista de ítems: útil cuando un nodo anterior devuelve una lista.
- Avanzado: permite código para transformar datos específicos.
Usalo para limpiar outputs, preparar datos para un condicional o adaptar la respuesta antes de llamar otro paso.
Filtros de contenido
Aplica reglas de seguridad o moderación al flujo. Sirve para controlar temas o estilos que el bot no debe aceptar o generar.
Ejemplos:
- Evitar insultos.
- Evitar datos personales sensibles.
- Restringir el flujo a temas del negocio.
- Bloquear contenido adulto.
Nota
Es un recordatorio visual dentro del canvas. No se ejecuta y no afecta el flujo.
Usala para documentar decisiones internas, aclarar por qué existe una rama o dejar instrucciones para el equipo.
Sub-agente
Crea un agente especializado que puede ser invocado como herramienta por un agente principal.
Se usa cuando una parte del trabajo requiere instrucciones, documentos o herramientas propias. Por ejemplo: un sub-agente inmobiliario, uno de soporte técnico o uno de cotizaciones.
Derivar a humano
Deriva la conversación para que una persona la revise o continúe.
Configuraciones:
- Mensaje o instrucción para el operador.
- Notificar por Email.
- Notificar por WhatsApp.
- Operador asignado opcional.
Usalo cuando la IA detecta que necesita intervención humana o cuando el proceso comercial requiere contacto manual.
Aprobación humana
Pausa el workflow hasta que una persona apruebe o rechace.
Tiene dos salidas:
- Aprobado
- Rechazado
Se usa para validar cotizaciones, respuestas sensibles, descuentos, derivaciones importantes o cualquier paso que requiera control humano antes de continuar.
Llamar workflow
Ejecuta otro workflow y usa su resultado como salida del nodo actual.
Se usa para reutilizar flujos comunes, por ejemplo:
- Captura de datos personales.
- Calificación de leads.
- Validación de disponibilidad.
- Resumen final.
Llamar agente
Invoca otro agente y toma su respuesta como salida del nodo. Es útil cuando ya existe un agente especializado y querés reutilizarlo dentro de un flujo más grande.
Recomendaciones de diseño
- Un nodo debe hacer una cosa clara.
- Para decisiones por reglas, usá Elegir camino.
- Para decisiones por intención del usuario, usá Router conversacional.
- Para pedir datos, usá El bot responde con datos requeridos.
- Para respuestas exactas sin IA, usá Mensaje fijo.
- Para cortar el flujo con una respuesta final, usá Responder y terminar.
- Para evitar caminos muertos, conectá siempre las salidas default.