El modelo lee tu descripción. Eso es todo lo que tiene.

Lo más anti-intuitivo de tool use es esto: el modelo no entiende tu tool por su nombre o su código. Lo entiende por la descripción que vos escribiste. Y solo por eso.

Si la descripción dice "Busca un crewmate", el modelo tiene que adivinar:

• ¿Busca por alias? ¿por nombre? ¿por puesto?
• ¿Devuelve uno o muchos?
• ¿Es lectura solamente o también modifica?
• ¿Qué pasa si no encuentra?

El modelo se equivoca en una de estas adivinanzas y el tool queda mal usado o ignorado. La métrica que importa es precision + recall:

• Recall. ¿el modelo invoca el tool cuando debería? (Si no, está alucinando respuestas que deberían venir de tool.)
• Precision. ¿el modelo evita invocar el tool cuando NO debería? (Si no, está llamando funciones de más, gastando dinero y latencia.)

Las dos suben cuando la descripción es específica y delimitada: dice cuándo SÍ, cuándo NO, y qué garantiza.

Cuando una description dice algo que el modelo no podría inferir solo del nombre, está agregando valor. Cuando dice lo mismo que ya dice el nombre, está ocupando espacio.

Elegí la opción correcta a la derecha.