Floo IA - Asistente inteligente

Floo IA es el asistente de inteligencia artificial integrado en la plataforma. Utiliza modelos de lenguaje (GPT-4, GPT-4o) para ayudar en la creacion, optimizacion y depuracion de workflows.

Capacidades

a) Generacion de workflows por descripcion

Describe en lenguaje natural lo que necesitas y Floo IA genera el workflow completo con nodos y conexiones.

Ejemplo:

"Cuando reciba un pedido por webhook, verificar el stock llamando a mi API,
si hay stock enviar email de confirmacion, si no hay notificar por Slack"

Floo IA genera automaticamente:

• Nodo Webhook como trigger
• Nodo HTTP para consultar la API de stock
• Nodo Decision para evaluar la respuesta
• Nodo SendMail en la rama true
• Nodo Slack en la rama false
• Conexiones entre todos los nodos

b) Sugerencia de nodos

Al describir una tarea, Floo IA sugiere los nodos mas apropiados. Por ejemplo, si escribes “enviar datos a una base de datos PostgreSQL”, sugiere el nodo sqlQueryPostgres con la configuracion relevante.

Si el servicio de IA no esta disponible, el sistema usa busqueda local por palabras clave como respaldo.

c) Optimizacion de workflows existentes

Floo IA analiza un workflow existente y sugiere mejoras:

• Nodos redundantes que pueden eliminarse
• Oportunidades de paralelizacion
• Mejoras en la estructura de decisiones
• Uso mas eficiente de iteradores

d) Analisis de errores

Cuando un nodo falla, Floo IA analiza el error en contexto y sugiere:

• Causa probable del error
• Solucion recomendada
• Configuracion correcta del nodo
• Tambien ofrece sugerencias rapidas sin consumir tokens de IA

e) Chat conversacional

Un chat integrado donde puedes hacer preguntas sobre:

• Como configurar un nodo especifico
• Que modulo usar para una tarea
• Como resolver un problema en tu workflow
• Buscar modulos por funcionalidad

f) Edicion de workflows desde el chat (Modo Edicion)

El Modo Edicion permite modificar un workflow abierto en el editor directamente desde el panel de chat, describiendo los cambios en lenguaje natural. Floo IA aplica los cambios sobre el grafo existente sin reemplazarlo desde cero.

Nota

Esta funcion es experimental y debe habilitarse explicitamente con la variable de entorno VITE_AI_WORKFLOW_EDIT=true. Si la variable no esta presente o es false, el panel de chat funciona en modo solo lectura como siempre.

Como activarlo

Agrega la siguiente variable al archivo de entorno del frontend:

VITE_AI_WORKFLOW_EDIT=true

Como usarlo

1. Abre un workflow en el editor.
2. Abre el panel de chat de Floo IA.
3. Activa el toggle Modo Edicion (icono de lapiz en el header del panel).
4. Opcionalmente, selecciona un nodo en el editor para darle contexto al asistente.
5. Describe el cambio que quieres aplicar en lenguaje natural.
6. El asistente propone el cambio con un resumen de lo que modificara.
7. Pulsa Aplicar al editor para ver los cambios reflejados en el grafo.
8. Cuando estes conforme, guarda el workflow con Ctrl+S como de costumbre.

Ejemplos de instrucciones validas

"Agrega un nodo sendMail despues del decision cuando la condicion es true"
"Conecta el router al nodo webresponse con un 404 cuando el metodo no sea POST"
"Cambia el campo subject del sendMail_1 a 'Pedido aprobado'"
"Elimina el nodo http_2 y reconecta el decision directamente al end"

Comportamiento del editor al aplicar cambios

• Los nodos nuevos aparecen con un borde verde animado durante 3 segundos.
• Los nodos modificados aparecen con un borde azul durante 3 segundos.
• El estado anterior se guarda en un historial local (hasta 10 estados). Puedes deshacer el ultimo cambio IA pulsando Deshacer ultimo cambio en el panel del chat.
• Los cambios no se persisten hasta que el usuario guarda manualmente el workflow.

Nodo seleccionado como contexto

Si seleccionas un nodo en el editor antes de escribir la instruccion, el asistente lo usa como referencia. Esto permite instrucciones como “cambia el metodo HTTP de este nodo a POST” sin tener que especificar el ID del nodo.

Consumo de tokens

Cada edicion consume tokens equivalentes a una generacion de workflow, ya que el modelo procesa el grafo completo mas la instruccion. Consulta los limites de tu plan en Limites de IA.

Endpoints de la API de IA

Endpoint	Metodo	Descripcion
/api/ai/generate-workflow	POST	Generar workflow desde descripcion
/api/ai/edit-workflow	POST	Editar workflow existente desde instruccion en lenguaje natural
/api/ai/suggest-nodes	POST	Sugerir nodos para una tarea
/api/ai/analyze-error	POST	Analizar error de un nodo
/api/ai/chat	POST	Chat con el asistente
/api/ai/optimize-workflow	POST	Optimizar workflow existente
/api/ai/modules	GET	Listar todos los modulos disponibles
/api/ai/modules/search/:query	GET	Buscar modulos
/api/ai/categories	GET	Listar categorias de modulos
/api/ai/token-estimate	POST	Estimar tokens antes de ejecutar
/api/ai/usage/stats	GET	Estadisticas de uso mensual
/api/ai/usage/limits	GET	Limites del plan vs uso actual

Consumo de tokens

• Cada operacion de IA consume tokens del modelo configurado
• El sistema estima tokens antes de ejecutar para evitar excesos
• El uso se rastrea por cliente y por tipo de operacion
• Los limites dependen del plan contratado (consultables en /api/ai/usage/limits)