Pruebe y diagnostique herramientas
Pruebe una herramienta con valores de ejemplo, lea el resultado y corrija parámetros no válidos, tiempos de espera agotados y API que fallan.
Qué conseguirá
Confirmará que una herramienta funciona antes de que un agente dependa de ella.
Paso a paso: probar una herramienta
- Abra la herramienta desde Tools.
- Use primero Save changes. La página de pruebas dice «Save first, the test uses the saved version.»
- En Test, escriba un valor para cada parámetro (los obligatorios llevan
*). - Pulse Run test. El resultado dice Succeeded o Failed, muestra cuánto tardó en milisegundos y muestra lo que devolvió su punto de conexión (tras aplicar Read this from the response) o el error.
Si el resultado tarda más de 300 ms, la página avisa: «Over 300 ms, so the caller hears silence while it runs.» Entonces considere Run in the background o un punto de conexión más rápido.
Lea los registros
En la pestaña Logs del agente, la vista de herramientas enumera con qué frecuencia se ejecutó cada herramienta asociada. La pestaña API Usage de la página Settings muestra el uso de herramientas y de acciones en todo el espacio de trabajo con la actividad reciente.
Qué se le dice al agente cuando una herramienta falla
| Qué ocurrió | El mensaje |
|---|---|
| Faltaba un parámetro obligatorio | «Missing required parameter(s): order_id» |
| Un valor tenía el tipo equivocado o no era una opción permitida | «Parameter 'x' must be a integer.» o «…must be one of: …» |
| La URL es privada o interna | Un mensaje de que no es una dirección permitida |
| El servicio tardó demasiado | «The service did not answer within 5s.» |
| El servicio devolvió 4xx | «The service rejected the request (404).» No se reintenta. |
| El servicio devolvió 5xx | «The service returned 502.» Se reintenta solo en GET, PUT y DELETE. |
| El servicio redirigió | «The service redirected the request, which is not followed.» |
Solución de problemas
- 404 o 401 en la prueba. Revise la URL, los parámetros de la ruta y la autenticación.
- Siempre se agota el tiempo. Aumente Timeout (hasta 30 s) solo si quien llama puede esperar, o use Run in the background.
- La prueba funciona, pero el agente nunca la llama. Mejore la descripción y el system prompt.
- Un POST se ejecutó una vez, pero esperaba un reintento. POST y PATCH nunca se reintentan, por diseño.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.