Skip to main content

​
Etiqueta como si escribieras descripciones de herramientas

Como las etiquetas de los bordes se convierten literalmente en descripciones de herramientas para el LLM, escríbelas como condiciones 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: léelo como un stack trace cuando el flow se comporte mal.

​
Usa herramientas asíncronas para todo lo que tarde más de ~2 segundos

Las llamadas a herramientas síncronas congelan la conversación. Marca los webhooks lentos como async y configura frases de relleno; el asistente se mantiene receptivo 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.