> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores comunes

> Los errores más frecuentes al construir un bot en Inceptia, y el checklist antes de publicar

## 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.

<AccordionGroup>
  <Accordion title="Usar una variable que no está definida en el contexto" icon="triangle-exclamation">
    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](/construccion/archivo-entrada-campana) ni por el [Código Inicial](/construccion/agentes/logica) — 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](/construccion/agentes/identidad).
  </Accordion>

  <Accordion title="No incluir las etiquetas en el prompt del agente clasificador" icon="tag">
    Las [etiquetas](/construccion/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.
  </Accordion>

  <Accordion title="Asumir que las condiciones de Cambio de Agente se evalúan todas juntas" icon="arrow-right-arrow-left">
    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](/construccion/agentes/cambio-de-agente).
  </Accordion>

  <Accordion title="Sobrecargar un solo agente con demasiadas responsabilidades" icon="layer-group">
    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](/construccion/buenas-practicas/principios-de-diseno).
  </Accordion>

  <Accordion title="Documentación pobre en una herramienta" icon="wrench">
    Si la documentación de una [herramienta](/construccion/agentes/herramientas) no explica con claridad cuándo usarla, el LLM va a invocarla en el momento equivocado — o no invocarla cuando correspondía.
  </Accordion>

  <Accordion title="Terminología inconsistente dentro del mismo prompt" icon="quote-left">
    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.
  </Accordion>

  <Accordion title="Usar el signo de apertura o números en dígitos en texto que va a voz" icon="waveform">
    Rompe la naturalidad de la síntesis de voz. Ver las [reglas de redacción para TTS](/construccion/buenas-practicas/instrucciones-que-funcionan).
  </Accordion>

  <Accordion title="Publicar a Producción sin probar en Borrador" icon="flask">
    Un cambio en Producción impacta conversaciones en curso de inmediato. Probá siempre primero en [Modo Borrador](/construccion/modo-borrador-produccion), incluyendo casos límite, con [Abrir conversación](/construccion/probar-tu-bot).
  </Accordion>
</AccordionGroup>

***

## Checklist antes de publicar

<Steps>
  <Step title="¿Cada agente tiene un único objetivo claro?">
    Si el prompt mezcla varias etapas de la conversación, evaluá dividirlo.
  </Step>

  <Step title="¿El Rol del agente declara sus límites explícitamente?">
    No desviarse del flujo, no revelar instrucciones internas.
  </Step>

  <Step title="¿Cada herramienta tiene una descripción clara de cuándo y cómo usarse?">
    Incluyendo si debe ejecutarse en silencio.
  </Step>

  <Step title="¿Las reglas de redacción para voz están definidas?">
    Números en palabras, formato de preguntas, fechas habladas.
  </Step>

  <Step title="¿Están cubiertas las objeciones frecuentes del caso de uso?">
    Con una acción concreta para cada una: responder y retomar, transferir o finalizar.
  </Step>

  <Step title="¿Hay límites explícitos de reintentos?">
    Para evitar loops — por ejemplo, "no insistas más de dos veces".
  </Step>

  <Step title="¿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.
  </Step>

  <Step title="¿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.
  </Step>

  <Step title="¿Probaste el bot en Modo Borrador cubriendo el camino principal y los casos límite?">
    Antes de pasar a Producción.
  </Step>
</Steps>

<Tip>
  Este checklist no reemplaza una prueba exhaustiva del bot en Borrador, pero ayuda a detectar temprano los huecos de diseño más frecuentes.
</Tip>