Superglue CLI: Permite que los Agentes de IA Ejecuten Llamadas API Sin Herramientas Preconstruidas

Superglue CLI es una interfaz de línea de comandos que incluye una referencia de habilidades estructurada que enseña a los agentes de IA cómo usar cada comando sg, manejar autenticación, construir herramientas y depurar fallos. La idea central: en lugar de construir herramientas codificadas para cada integración de API, apuntas al agente a cualquier API, y puede razonar sobre esa API en tiempo de ejecución leyendo la especificación, planificando llamadas y ejecutándolas.

Instalación y Configuración

Instala la CLI globalmente mediante npm:

npm install -g @superglue/cli

Ejecuta la configuración interactiva:

sg init

Esto solicita tu clave de API (disponible en app.superglue.cloud/admin), endpoint y preferencias de salida. Para entornos no interactivos como CI o agentes de IA, establece variables de entorno:

export SUPERGLUE_API_KEY="your-api-key"
export SUPERGLUE_API_ENDPOINT="https://api.superglue.cloud"

Verifica con sg system list — si ves errores de autenticación, revisa tu clave de API y endpoint.

Instalando la Habilidad

La habilidad le da a tu agente de IA conocimiento completo de la CLI — comandos, patrones de autenticación, esquemas de herramientas, depuración y despliegue. Instálala una vez y el agente la referencia automáticamente.

Instalación universal para todos los agentes:

npx skills add superglue-ai/cli

Dirige a agentes específicos con -g -a <agent>:

npx skills add superglue-ai/cli -g -a claude-code
npx skills add superglue-ai/cli -g -a codex
npx skills add superglue-ai/cli -g -a cursor

Para Claude Code, instala desde el mercado de Anthropic:

/plugin install superglue@claude-plugins-official

O carga desde la instalación local:

claude --plugin-dir $(npm root -g)/@superglue/cli

Para Cursor, copia la habilidad a tu proyecto o directorio global:

cp -r $(npm root -g)/@superglue/cli/skills/superglue .cursor/skills/superglue
# O globalmente
cp -r $(npm root -g)/@superglue/cli/skills/superglue ~/.cursor/skills/superglue

Lo que Proporciona la Habilidad

• Todos los comandos de la CLI con banderas, opciones y patrones de uso
• Patrones de autenticación — marcadores de credenciales, flujos OAuth, formatos de cabecera
• Esquema de configuración de herramientas — configuraciones de pasos, selectores de datos, transformaciones, paginación
• Flujos de trabajo de depuración — errores comunes, --include-step-results, sg system call para aislamiento
• Patrones de despliegue — SDK, API REST, webhooks (vía references/integration.md)
• Referencias especializadas para bases de datos, servidores de archivos y transformaciones (cargadas bajo demanda)

Añadiendo Contexto Específico del Proyecto

Añade una sección al archivo de configuración de IA de tu proyecto (CLAUDE.md, AGENTS.md, o .cursorrules) para que el agente sepa usar la habilidad y descubra tu configuración dinámicamente. Incluye instrucciones como:

## Usando Superglue
Cuando trabajes con herramientas de superglue — vía la CLI, SDK, o API REST:
1. Invoca la habilidad de superglue y lee el archivo SKILL.md antes de ejecutar cualquier comando sg
2. Lee los archivos de referencia relevantes para la tarea (integración, bases de datos, servidores de archivos, transformaciones)
3. Asegúrate de que la CLI esté configurada (sg init se ha ejecutado o las variables de entorno están establecidas)
4. Ejecuta sg system list y sg tool list para descubrir la configuración actual antes de construir o modificar nada
5. Nunca codifiques IDs de sistema o IDs de herramienta — siempre descúbrelos dinámicamente

Mejores Prácticas

Siempre prueba los sistemas antes de construir herramientas. Haz que el agente ejecute sg system call para verificar la autenticación y ver la forma real de la respuesta antes de construir una configuración de herramienta:

sg system call --system-id stripe \
  --url "https://api.stripe.com/v1/customers?limit=2" \
  --headers '{"Authorization":"Bearer <>"}'

Usa --include-step-results cuando depures para mostrar la respuesta cruda de la API de cada paso — identifica si el problema es autenticación, el endpoint, o una transformación:

sg tool run --draft <id> --payload '{}' --include-step-results

Nunca pegues secretos en el chat. Usa --sensitive-credentials cuando crees sistemas vía la CLI para que los secretos se soliciten de forma segura.

Este enfoque aborda el límite de la "herramienta predefinida" donde los equipos construyen agentes pero los usuarios describen necesidades específicas como "extrae estos tres objetos de Salesforce y envíalos a nCino cuando la condición X sea verdadera". En lugar de traducir cada solicitud en una herramienta codificada, el agente puede leer la especificación de la API y manejar operaciones de múltiples pasos con lógica por usuario.