Prompt y herramientas
Una herramienta no se usa, las variables quedan vacías, los cambios no surten efecto o la herramienta API da un error.
El agente usa por su cuenta herramientas como el calendario, la búsqueda web, la transferencia, la base de conocimiento o tu CRM cuando el prompt y la descripción de la herramienta lo sugieren. Qué usó y cuándo lo ves en el historial de llamadas, en Main Logs.
Una herramienta no se usa
| Posible causa | Solución |
|---|---|
| La herramienta no está activada | En la pestaña Herramientas, comprueba si aparece en Herramientas. Una herramienta que solo se menciona en el prompt no existe para el agente |
| El agente no sabe cuándo usarla | Rellena la descripción de la herramienta: Contexto para la IA en la transferencia, ¿Cuándo debe activarse la búsqueda? en la búsqueda web, Descripción (para la IA) en la herramienta CRM. Indícalo también en el prompt |
| Faltan datos que la herramienta necesita | Con la herramienta CRM, el agente pregunta primero todos los parámetros obligatorios. Comprueba si quien llama los ha dado |
| Transferencia en la prueba de audio | En el navegador no hay línea telefónica; una transferencia solo se puede probar con una llamada real |
Cómo comprobarlo: en la prueba, di exactamente la frase que debe activar la herramienta, por ejemplo «Quiero una cita el martes». Después debe aparecer una entrada de la herramienta en Main Logs.
Una herramienta se usa en el momento equivocado
| Posible causa | Solución |
|---|---|
| Dos herramientas tienen descripciones parecidas | Delimítalas con claridad, por ejemplo «Transfiere solo las urgencias; el resto de consultas, regístralas como llamada de vuelta.» |
| La descripción es demasiado general | Indica situaciones concretas en lugar de «cuando haga falta» |
Las variables quedan vacías
| Posible causa | Solución |
|---|---|
| El nombre del marcador no coincide | {{Customer_name}} y {{customer_name}} son variables distintas. Escribe el nombre exactamente como en el webhook, en context o en la columna de la campaña |
| Espacios o caracteres especiales en el marcador | {{ customer_name }} nunca se sustituye. Escribe {{customer_name}} |
| El Incoming Webhook no entregó el valor | Comprueba en Estadísticas del Webhook si tuvo éxito y define un Valor de respaldo |
| En las campañas falta la columna en el CSV | Al subir el archivo, el panel avisa de qué marcadores no tienen columna |
Un marcador sin valor se elimina antes de la conversación. Así que el agente nunca lee en voz alta el nombre de la variable; la frase solo suena incompleta.
Un cambio no surte efecto
| Posible causa | Solución |
|---|---|
| No se ha guardado | Guarda el cambio. La prueba de audio guarda automáticamente antes de empezar |
| La conversación ya estaba en curso | Los cambios se aplican a partir de la siguiente llamada |
| Has editado otro agente | Comprueba en Número de teléfono qué agente está asignado al número |
| Una plantilla ha sobrescrito el prompt | Sobrescribir prompt sustituye el texto anterior. Vuelve a aplicar tus cambios después |
La herramienta CRM da un error
| Posible causa | Solución |
|---|---|
| Tu sistema no responde con un estado 2xx | Comprueba en Main Logs la salida de la herramienta y en el registro de tu sistema la solicitud |
| Tiempo de espera agotado | Tu sistema responde más despacio que el tiempo de espera. Auméntalo en Ajustes avanzados o acelera tu sistema |
| JSON no válido en el cuerpo | Revisa la Vista previa del cuerpo de solicitud en la herramienta. Los marcadores dentro de cadenas van entre comillas: "name": "{{name}}" |
| Cabecera incorrecta o ausente | Comprueba la clave y la grafía en la sección Headers |
Quien llama oye silencio mientras se ejecuta una herramienta
Define un Texto de espera, por ejemplo «Un momento, lo estoy anotando.» El agente lo dice mientras la herramienta trabaja. En la búsqueda web, una búsqueda tarda entre dos y cinco segundos aproximadamente.
Más ayuda
Envíanos el momento de la llamada, el nombre de la herramienta y una captura de pantalla de Main Logs, consulta Informar de un problema.
¿Te ha sido útil esta página?