Skip to main content
Patrones prácticos para crear flows confiables en producción: etiquetar bordes, estructurar agentes, validar datos y probar antes de publicar.

​
Escribe etiquetas de borde claras

Escribe las etiquetas de los bordes como condiciones claras desde la perspectiva de quien llama:
  • ✅ caller confirms they are an existing customer
  • ✅ caller wants to cancel or reschedule
  • ❌ yes, path A, continue
Haz que las etiquetas hermanas sean mutuamente excluyentes y cubran los casos realistas. Si dos etiquetas se superponen, el enrutamiento se convierte en un lanzamiento de moneda.

​
Mantén los agentes pequeños y con un solo propósito

Un agente = una tarea (calificar, responder preguntas de facturación, reservar). Las instrucciones breves y enfocadas por agente superan a un mega-agente con un muro de texto. Los traspasos son baratos: úsalos.

​
Valida los datos con nodos collect, no con prompts

Los correos electrónicos y números de teléfono transcritos a partir de voz son ruidosos. Los nodos collect confirman y validan (“¿Eso fue m-e-y-e-r?”) y solo continúan si tienen éxito. Nombra siempre la variable con claridad (callback_phone, no var1): esos nombres aparecen en los webhooks y en los detalles de la llamada.

​
Diseña las rutas de fallo

  • Dale a los nodos collect un borde failed que lleve a algo sensato (una transferencia a una persona o una despedida cortés).
  • Configura el fallback de la transferencia cálida de forma deliberada: continue para traspasos opcionales, cold_transfer cuando quien llama debe comunicarse con alguien.
  • Termina cada rama con un nodo end con una despedida adecuada.

​
Prueba con llamadas web y observa los eventos

Ejecuta llamadas de prueba desde el navegador después de cada cambio. En la vista de detalle de la llamada, el registro de eventos muestra las transiciones de nodos, las llamadas a herramientas, los resultados de recopilación y los resultados de las transferencias. Úsalo para localizar rápidamente el paso que no se comporta como esperabas.

​
Usa herramientas asíncronas para solicitudes lentas

Para webhooks lentos, activa Run asynchronously y configura frases de relleno; la conversación puede continuar mientras se ejecuta la solicitud. Consulta el nodo de herramienta.

​
Empieza por el prompt y evoluciona hacia el flow

Prototipa el comportamiento primero con un simple prompt del sistema. Cuando la llamada desarrolle fases distintas o necesite una captura de datos garantizada, traslada esa estructura a un flow: los nodos de agente con instrucciones vacías heredan el prompt del sistema, así que la migración es incremental.