Descripciones que hacen que el agente elija la tool correcta

En este artículo

Un agente no ve tu código. Cuando un usuario pregunta algo, elige una tool leyendo las descripciones. Una descripción vaga significa la tool equivocada, o ninguna.

Lo que dice una buena descripción

1. Cuándo usarla. Las preguntas que responde, con las palabras de tus usuarios.
2. Qué devuelve. Los campos que importan y cómo leerlos.
3. Para qué no sirve. Qué otra tool llamar en su lugar.
4. Con qué encadenarla. Por ejemplo, el id de una factura que otra tool puede abrir.

Connect pide al menos 400 caracteres antes de habilitar una tool, porque las descripciones más cortas rara vez cubren las cuatro cosas.

Claude redacta el primer borrador

Claude lee la ruta, los parámetros y los nombres de los campos de respuesta de cada operación. Nunca tus datos, nunca tus claves. Redacta la descripción y tú la revisas antes de que se publique nada.

Prueba antes de habilitar

Una tool solo se publica después de una llamada correcta a tu API con una credencial de prueba. Si cambias la ruta o los parámetros, la prueba se borra y la tool se apaga hasta que la vuelvas a ejecutar.

• #claude
• #tools