Salud de las herramientas
Revisa cómo se comportaron las herramientas de tus agentes en conversaciones y llamadas reales: ejecuciones, fallas, resultados vacíos, bloqueos, errores frecuentes y ejemplos.
GET
Tool health
Este reporte responde una pregunta concreta: ¿las herramientas de mis agentes siguen funcionando? No mira cómo está configurada cada herramienta, sino qué pasó de verdad cuando el agente la usó con leads reales. Sirve para detectar a tiempo una integración que dejó de responder, como una credencial vencida o una búsqueda que nunca encuentra nada, antes de que lo noten tus clientes.
Devuelve una fila por herramienta, tarea y canal, con las herramientas con problemas primero.
Antes de empezar
- Las llaves MCP necesitan
workflows:ready tambiénleads:read, porque los ejemplos incluyen datos de leads. Las llaves REST de acceso completo no necesitan nada más. toolsno cuenta los leads de prueba, los leads sandbox ni las conversaciones del Playground. Agregainclude_test=truepara verlos por separado, entest_tools.- Es solo de lectura: consultarlo no ejecuta ninguna herramienta.
- Los errores devuelven un código estable en
error, por ejemploinvalid_days. Asocia cada código a tus propios textos.
Qué consultar
Pruebas antes de salir en live
Coninclude_test=true, la respuesta agrega test_tools: las mismas filas, con los mismos campos y el mismo orden, armadas solo con conversaciones del Playground y leads de prueba y sandbox. tools sigue contando solo leads reales, así que las pruebas nunca se mezclan con el tráfico real. Sin el parámetro, o con false, test_tools no viene en la respuesta.
Úsalo para revisar las herramientas de una tarea mientras la pruebas en el Playground, antes de que lleguen leads reales. Los demás parámetros se aplican a ambas listas. Las ejecuciones de Probar Workflow Tool no se cuentan, porque no ocurren en una conversación.
Qué significa cada número
Cómo interpretar los resultados
Límites
- Hasta 100 filas en
toolsy 100 entest_tools. Si hay más coincidencias en cualquiera de las dos listas,truncatedviene entrue. - Cada consulta lee primero la actividad más reciente. Con
include_test=true, la actividad de prueba se lee en la misma consulta. Si el período tuvo más actividad de herramientas de la que cabe en una consulta,truncatedviene entrueywindow.scanned_fromindica desde qué momento parten los conteos. Acota conworkflow_id,tool_name,channelo menosdays. argsyresultse cortan en 600 caracteres. Las llaves de API, tokens, contraseñas y firmas aparecen enmascarados. Los datos del lead, como nombres y teléfonos, no se eliminan: trata los ejemplos como datos de leads.
Autorizaciones
Parámetros de consulta
Respuesta
Tool rows, sorted by problem rate ((failed + empty) / (calls - blocked)) and then by calls, highest first.
Última modificación el 2 de octubre de 2026
Tool health