Tools

Cada tool tiene un nombre, una descripción que el modelo lee para decidir cuándo usarla, una ruta con sus parámetros y la parte de la respuesta que recibe el modelo. Abre una tool desde el paso Tools para editarla.

Campos#

Parámetros#

Cada parámetro tiene un nombre, dónde va (path o query), un tipo (string, number, integer, boolean o array), si es obligatorio, los valores permitidos y una descripción de hasta 1.000 caracteres. Los parámetros de ruta siempre son obligatorios. Un array en la query se puede enviar como ids=a&ids=b o, con la opción de lista separada por comas, como ids=a,b.

Campos de la respuesta#

Lista los campos que necesita el modelo, una ruta con puntos por línea. Así las respuestas son cortas y el asistente no recibe datos que no necesita.

statusestimated_deliveryevents[].descriptionevents[].location

data[].id recorre el array data. [].id es para una respuesta que es un array. Las respuestas más largas se cortan en el Máximo de caracteres con un aviso que pide al modelo filtrar o paginar.

Qué impide habilitar una tool#

La página de la tool muestra lo que falta. Una tool no se puede habilitar si:

• Su descripción tiene menos de 400 caracteres.
• Un parámetro no tiene descripción, o dos parámetros se llaman igual.
• El nombre de un parámetro parece una credencial, por ejemplo password, token, apikey o authorization.
• Un hueco de la ruta no tiene parámetro, o un parámetro de ruta no se usa o no es obligatorio.
• No tiene una prueba correcta de su versión actual.

Redactar descripciones con Claude#

Una buena descripción dice cuándo usar la tool, qué devuelve, cómo leerlo y qué otra tool usar en su lugar. Claude redacta un primer borrador por ti.

• Redactar descripciones con Claude, en el paso Tools, procesa las tools cuya descripción viene de la importación o tiene menos de 400 caracteres, en lotes de 5. Se salta las descripciones que editaste a mano.
• Reescribir con Claude, en el editor de una tool, reescribe esa, aunque la hayas editado.

El límite es de 300 descripciones por integración al día. Revisa cada una: la lista de tools las marca como "Escrita por Claude, revísala".

Probar una tool#

1. Guarda una credencial de prueba en el paso Autenticación.
2. Guarda tus cambios. La prueba usa la versión guardada.
3. Rellena los parámetros y pulsa Ejecutar prueba.

Connect llama a tu API y muestra la respuesta solo en tu navegador. Guarda la hora, el estado HTTP y el resultado, nunca la respuesta. Una prueba correcta es obligatoria para habilitar la tool.

La prueba se borra cuando cambias la ruta o los parámetros, el modo de autenticación o dónde va la key, o cuando una importación cambia la tool. Editar el título, la descripción, los campos de la respuesta o el límite la conserva.

Crear una tool a mano#

En el paso Tools, en Nueva tool, indica un nombre, un título y una ruta. Cada {hueco} de la ruta se convierte en un parámetro obligatorio. Después escribe la descripción, pruébala y habilítala. Las importaciones nunca cambian las tools que creas a mano.

Cómo se ejecuta una llamada#

Cada llamada envía accept: application/json y user-agent: GrostifyConnect/1.0, más la credencial del usuario. Si tu API repite la credencial en la respuesta, Connect la sustituye por [redacted]. Las credenciales de menos de 8 caracteres no se sustituyen, así que asegúrate de que tu API no las repita.