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

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

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:read` y también `leads:read`, porque los ejemplos incluyen datos de leads. Las llaves REST de acceso completo no necesitan nada más.
* No cuenta los leads de prueba, los leads sandbox ni las conversaciones del Playground.
* Es solo de lectura: consultarlo no ejecuta ninguna herramienta.
* Los errores devuelven un código estable en `error`, por ejemplo `invalid_days`. Asocia cada código a tus propios textos.

## Qué consultar

| Parámetro | Detalle |
| - | - |
| `days` | De 1 a 14. Por defecto, 7. Se cuenta en bloques de 24 horas hacia atrás desde el momento de la consulta. `window.since` indica el inicio, en UTC. |
| `workflow_id` | Solo una tarea (`workflow` en la API). Una tarea de otra cuenta devuelve la lista `tools` vacía, no un error. |
| `tool_name` | Solo una herramienta, por su nombre exacto. Hasta 120 caracteres. |
| `channel` | `whatsapp`, `unsupervised-whatsapp` (línea personal de WhatsApp), `instagram`, `messenger`, `webchat`, `sms`, `imessage`, `email` o `call` (llamadas telefónicas). |
| `only_problems` | `true` deja solo las herramientas en que las ejecuciones fallidas y vacías suman al menos la mitad de las que llegaron a la integración, con un mínimo de 3. |

## Qué significa cada número

| Campo | Qué cuenta |
| - | - |
| `calls` | Todas las veces que el agente usó la herramienta: `ok + failed + empty + blocked`. Una herramienta usada durante una llamada se cuenta una sola vez. |
| `ok` | La herramienta devolvió una respuesta útil. |
| `failed` | La herramienta devolvió un error, incluida una respuesta HTTP 4xx o 5xx de tu sistema. |
| `empty` | La herramienta respondió, pero su lista de resultados (`items`, `data` o `results`) venía vacía y ninguna otra lista traía elementos. |
| `blocked` | Nexor detuvo la herramienta antes de que llegara a la integración. Por ejemplo, porque no está habilitada en la etapa actual del lead o porque es una acción de una sola vez que ya se ejecutó. |
| `failure_rate`, `empty_rate` | `failed` y `empty` divididos por las ejecuciones que llegaron a la integración (`calls - blocked`), de 0 a 1. Los bloqueos quedan fuera porque la integración nunca se ejecutó. |
| `last_call_at`, `last_ok_at`, `last_failure_at` | El uso, el éxito y la falla más recientes dentro del período, en UTC. `null` si no hubo. |
| `kind` | `custom` es una de tus herramientas HTTP propias, que llama a un sistema fuera de Nexor. `builtin` es una herramienta de Nexor. |
| `top_errors` | Hasta 3 de los mensajes de error más frecuentes, con cuántas veces apareció cada uno. Los IDs, correos y teléfonos se reemplazan por marcadores para que los errores iguales queden agrupados. |
| `samples` | Hasta 3 ejecuciones reales: primero las fallidas y vacías, después una exitosa si la hay y, al final, las bloqueadas. `args` es lo que envió el agente y `result`, lo que recibió de vuelta. |

## Cómo interpretar los resultados

| Lo que ves | Lo que suele significar | Qué hacer |
| - | - | - |
| Muchos `empty` en una herramienta `custom` | El agente llegó a tu sistema, pero la búsqueda no encontró nada. Los parámetros que envía no calzan con cómo tu sistema guarda los datos: un nombre donde se espera un código, tildes, el formato de una fecha o un teléfono, o un filtro demasiado estricto. | Compara los `args` de `samples` con un registro que sepas que existe. Ajusta la descripción de los parámetros de la herramienta o la búsqueda de tu endpoint. |
| `failed` con 401 o 403 en `top_errors` | Tu sistema rechazó la credencial. Lo más probable es que haya vencido o que alguien la haya cambiado. | Actualiza la credencial configurada en la herramienta. |
| `failed` con otro 4xx | La solicitud no tiene la forma que espera tu endpoint. | Revisa la URL y los parámetros de la herramienta contra tu API. |
| `failed` con 5xx o tiempos de espera agotados | Tu sistema falló o se demoró demasiado en responder. | Revisa los logs de tu sistema en los horarios de `samples`. |
| `blocked` | No es una falla de la integración. El agente intentó usar una herramienta que no está habilitada en la etapa actual del lead, o repitió una acción de una sola vez. | Si el agente necesita la herramienta en esa etapa, cambia su **Restricción de herramientas por etapa** en los [ajustes del agente](/docs/es/guides/agents/settings). Si no, revisa las instrucciones que lo llevan a intentarlo. |
| `last_ok_at` anterior a `last_failure_at` | La herramienta funcionaba y empezó a fallar. | Busca un cambio en tu sistema cerca de la primera falla. |
| La misma herramienta funciona en un canal y falla o viene vacía en otro | Un canal se está comportando distinto. | Repórtalo al soporte de Nexor con ambas filas y los horarios de los ejemplos. |

## Límites

* Hasta 100 filas. Si hay más coincidencias, `truncated` viene en `true`.
* Cada consulta lee primero la actividad más reciente. Si el período tuvo más actividad de herramientas de la que cabe en una consulta, `truncated` viene en `true` y `window.scanned_from` indica desde qué momento parten los conteos. Acota con `workflow_id`, `tool_name`, `channel` o menos `days`.
* `args` y `result` se 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.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.