Buenas prácticas
Patrones y reglas que hacen los flows más confiables, fáciles de mantener y eficientes en costos.
Referencia
- Nombra los nodos
- Dale nombres descriptivos a cada nodo (no «Nodo 3» sino «Obtener cliente por ID»). El historial de ejecuciones se vuelve legible.
- Un nodo = una responsabilidad
- Cada nodo hace una sola cosa. Un nodo que hace 5 cosas es difícil de depurar.
- Gate antes de API costosa
- Si tienes una condition antes de una llamada a API o IA, el flujo no consume si la condición no se cumple.
- KV para estado de sesión
- No uses variables globales del canvas para estado por usuario. Usa KV Store con scope usuario+canal.
- max_tokens en agentes
- Limita el output del agente IA a ≤1024 tokens para canales de mensajería. Evita respuestas que excedan el límite de WhatsApp/Telegram.
- Pausar antes de editar
- Siempre pausa el flow antes de cambiar nodos o conexiones en producción.
- Exportar antes de cambios grandes
- Exporta una plantilla del flow como backup antes de refactorizaciones.
- Sin nodos huérfanos
- Todo nodo debe estar conectado al grafo principal. Un nodo huérfano bloquea la ejecución.
- Probar en dev primero
- Usa un canal de desarrollo (número de prueba de Meta o bot de Telegram separado) antes de activar en el canal de producción.
Siguiente paso
Aprende a gestionar las conversaciones en el Inbox.