Saltar al contenido principal

Skill de Claude

El skill de Convolution Labs le permite a Claude operar tu cuenta directamente desde una sesión de terminal — creando y editando agentes, publicándolos, ejecutándolos y armando pipelines de datos — llamando a la misma API REST pública documentada en este sitio. No hace nada que no pudieras hacer vos mismo con curl; simplemente conoce las rutas, la forma de los requests y las reglas de la plataforma (como qué recursos son de solo lectura) para que no tengas que buscarlas.

Instalación​

curl -sL https://<host>/api/v1/skill | tar xz -C ~/.claude/skills

Reemplazá <host> por el dominio de tu despliegue de Convolution Labs. Esto descarga un tarball servido directamente por la plataforma y lo extrae en el directorio de skills de Claude.

:::note La descarga siempre coincide con tu despliegue El skill no es un paquete versionado por separado — lo sirve el mismo despliegue en ejecución que la API que envuelve. Volver a correr el comando de instalación después de una actualización de la plataforma vuelve a descargar lo que sea que el skill sea hoy, así que nunca puede desincronizarse de la API que describe. Si en algún momento no estás seguro de si tu copia local está actualizada, volvé a correr el comando; no hay una versión que rastrear. :::

Configurá tu API key​

  1. En el dashboard, andá a Settings → API keys y creá una clave. Otorgale los scopes que quieras que use el skill — read, write, run — el skill respeta los scopes que tenga tu clave y te va a mostrar un error claro si intenta algo que la clave no tiene permitido.

  2. Exportala en tu shell:

    export CONVOLUTION_API_KEY=cl_xxxxxxxxxxxxxxxx

El skill lee esta variable de entorno para autenticarse. Nunca te va a pedir que pegues la clave en un prompt, y no te la va a mostrar de vuelta si se la pedís.

Qué puede y qué no puede hacer​

El skill puede hacer todo lo que puede hacer la API REST: listar, crear, actualizar, eliminar y publicar agentes; ejecutar agentes y hacer polling de los resultados; listar fuentes de datos, destinos y conexiones; crear y actualizar conexiones; disparar sincronizaciones.

No puede crear fuentes de datos, destinos de datos ni claves LLM — la API en sí no expone esas operaciones, a propósito. Una fuente o un destino requieren una cadena de conexión a una base de datos, y permitir que una API key (o un agente actuando a través de una) introduzca una credencial nueva o apunte una sincronización a un destino arbitrario sería una forma de sacar datos por una conexión que nadie revisó. Creá tus fuentes y destinos primero en la interfaz web (Dashboard → Data); una vez que existen, el skill puede listarlos por id y nombre y conectarlos en tu nombre.

Ejemplos concretos​

Crear y ejecutar un agente:

Creá un agente llamado "Weekly digest" que resuma papers nuevos de arXiv,
y después ejecutalo con input {"topic": "reinforcement learning"}.

El skill crea el agente vía POST /api/v1/agents, lo ejecuta vía POST /api/v1/agents/{id}/run, y después hace polling a GET /api/v1/runs/{runId} hasta que termina.

Armar un pipeline:

Listá mis fuentes de datos y destinos, y después creá una conexión de
"Production Postgres" a "Warehouse" sincronizando la tabla orders cada
hora.

El skill lista ambos vía GET /api/v1/data/sources y GET /api/v1/data/destinations, resuelve los nombres que le diste a ids, y crea la conexión vía POST /api/v1/data/connections — no puede crear la fuente ni el destino en sí, así que esto solo funciona si ambos ya existen en el dashboard.

Revisar un agente que lleva rato corriendo:

¿Sigue corriendo la última ejecución de mi agente "Research assistant", y
qué encontró hasta ahora?

El skill busca las ejecuciones recientes vía GET /api/v1/agents/{id}/runs, chequea el status, y te cuenta.

Límites que también aplican al skill​

El skill se autentica con tu API key, así que está sujeto a las mismas reglas documentadas en la referencia de la API REST: los scopes que tenga tu clave, el mismo comportamiento de 404 tanto para "no existe" como para "no es tuyo", y los mismos límites de tasa (600 lecturas/hora, 60 escrituras+ejecuciones/hora combinadas, por clave). Si el skill choca con un rate_limited o un insufficient_credits, te lo va a decir en vez de reintentar en silencio.

Ver también​

  • Referencia de la API REST — cada ruta, la forma de sus requests y respuestas, y los códigos de error que puede usar el skill (y vos también, directamente).
  • Ejecutar un agente por API — un recorrido más acotado del ciclo de ejecución/polling, útil si llamás a la API vos mismo en vez de a través del skill.