Cuando el agente actúa como si tu tool no existiera

El síntoma es siempre el mismo: el tool está registrado, el handler funciona, pero el agente nunca lo invoca. Tipos de problema:

• Lo invoca de menos (recall bajo): debería usarlo y no lo hace.
• Lo invoca de más (precision bajo): lo invoca cuando no toca.
• Lo invoca con argumentos malos: se rompe y queda mal.

Tu trabajo en este step: leer un schema que está siendo ignorado, y elegir la causa raíz más probable.

Las tres dimensiones donde un tool puede fallar

1. El nombre. ¿Comunica la intención? lookup_crewmate vs find_data.
2. La descripción. ¿Dice cuándo SÍ, cuándo NO, qué garantiza?
3. Los parámetros. ¿Son los mínimos? ¿Están tipados? ¿Tienen description?

Cuando un tool falla en una de estas, ya es candidato a ser ignorado. Cuando falla en las tres, es prácticamente invisible para el agente.

Mirá el spec a la derecha y elegí la causa más probable.

En producción, este es el debugging del 80% de los MCPs que "no funcionan": no es código roto, es mal documentado para el LLM.