Saltar al contenido principal

​
Errores frecuentes

Estos son los errores que más veces vemos repetirse al revisar bots — la mayoría son fáciles de evitar una vez que sabés que existen.
Si escribís {variable} en el Mensaje Inicial o en las Instrucciones y esa variable no llegó al context — ni por el archivo de campaña ni por el Código Inicial — queda vacía durante la conversación en vez de dar un error visible. Antes de publicar, revisá que toda variable que usás esté efectivamente mapeada o inicializada. Ver Variables disponibles.
Las etiquetas son predefinidas por Inceptia, pero es el agente PostConversación el que las asigna — y solo puede hacerlo si su prompt incluye la lista completa con una descripción clara de cuándo usar cada una.
Las condiciones se evalúan en el orden en que están cargadas — la primera que se cumple define el destino. Si tenés condiciones que se podrían superponer, la más específica tiene que ir primero. Ver Cambio de Agente.
Un agente que negocia, valida identidad y maneja objeciones a la vez tiene un prompt difícil de mantener y un comportamiento menos predecible. Ver cuándo conviene dividir en varios agentes.
Si la documentación de una herramienta no explica con claridad cuándo usarla, el LLM va a invocarla en el momento equivocado — o no invocarla cuando correspondía.
Si en una sección decís “finalizar la conversación” y en otra “cortar la llamada” para referirte a lo mismo, el modelo puede interpretarlo como dos acciones distintas. Elegí un término por concepto y sostenelo en todo el bot.
Rompe la naturalidad de la síntesis de voz. Ver las reglas de redacción para TTS.
Un cambio en Producción impacta conversaciones en curso de inmediato. Probá siempre primero en Modo Borrador, incluyendo casos límite, con Abrir conversación.

​
Checklist antes de publicar

1

¿Cada agente tiene un único objetivo claro?

Si el prompt mezcla varias etapas de la conversación, evaluá dividirlo.
2

¿El Rol del agente declara sus límites explícitamente?

No desviarse del flujo, no revelar instrucciones internas.
3

¿Cada herramienta tiene una descripción clara de cuándo y cómo usarse?

Incluyendo si debe ejecutarse en silencio.
4

¿Las reglas de redacción para voz están definidas?

Números en palabras, formato de preguntas, fechas habladas.
5

¿Están cubiertas las objeciones frecuentes del caso de uso?

Con una acción concreta para cada una: responder y retomar, transferir o finalizar.
6

¿Hay límites explícitos de reintentos?

Para evitar loops — por ejemplo, “no insistas más de dos veces”.
7

¿Las etiquetas están en el prompt del clasificador, si tu bot las usa?

Sin esto, la clasificación post-conversación no va a funcionar bien.
8

¿Los datos de negocio están parametrizados como variables, y no hardcodeados en el prompt?

Esto es lo que te permite reutilizar el diseño del bot en otras campañas.
9

¿Probaste el bot en Modo Borrador cubriendo el camino principal y los casos límite?

Antes de pasar a Producción.
Este checklist no reemplaza una prueba exhaustiva del bot en Borrador, pero ayuda a detectar temprano los huecos de diseño más frecuentes.