Fallos de herramientas
Solucione herramientas que nunca se llaman, devuelven errores, agotan el tiempo, envían valores equivocados o se ejecutan dos veces.
Qué conseguirá
Averiguará si una herramienta falla en su servicio o en cómo la usa el agente.
Empiece por la prueba
En la página de la herramienta, use Save changes y después Run test con valores de ejemplo. Si la prueba falla, el agente fallará igual, así que arregle eso primero. Consulte Pruebe y diagnostique herramientas.
Síntomas
| Síntoma | Causa probable | Solución |
|---|---|---|
| El agente nunca usa la herramienta | No está asociada, o la descripción es vaga | Actívela en la pestaña Tools del agente; reescriba la descripción de la herramienta para decir exactamente cuándo usarla |
| «Missing required parameter(s): …» | El agente no recogió un valor obligatorio | Describa el parámetro con claridad; dígale al agente en Instructions que lo pida primero |
| «Parameter 'x' must be a integer.» | Tipo equivocado | Corrija el tipo del parámetro o su descripción |
| «The service rejected the request (401 or 403).» | Autenticación incorrecta o ausente | Revise la credencial en Authentication |
| «The service rejected the request (404).» | URL o valor de ruta equivocados | Revise la URL y los parámetros de la ruta |
| «The service did not answer within 5s.» | Servicio lento | Aumente Timeout (hasta 30 s) o use Run in the background |
| «The service returned 5xx» | Su servicio está fallando | Arréglelo; GET, PUT y DELETE se reintentan, POST y PATCH nunca |
| «Not an allowed address» | URL privada o interna | Use una dirección https pública |
| El agente dice un bloque JSON sin procesar | Read this from the response está vacío | Elija el campo que debe leer el agente |
| Una acción ocurrió dos veces | Quien llamó lo pidió dos veces, o el agente reintentó | Haga que el punto de conexión sea seguro de repetir; POST nunca se reintenta automáticamente |
| Funciona en la prueba, no en una llamada | El agente aportó valores distintos | Lea los resultados de la herramienta en la transcripción de la llamada en History |
Herramientas de aplicaciones conectadas
Las herramientas creadas a partir de integraciones (Calendly, Google Calendar, etc.) fallan por otro conjunto de motivos, como una conexión caducada. Consulte Errores de integraciones.
Prueba
Haga una llamada que deba activar la herramienta, ábrala después en History y mire el resultado de la herramienta bajo la transcripción.
Resultado esperado
El resultado de la herramienta en History muestra la respuesta del servicio, y el agente la dice.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.