Superglue CLI : Laissez les agents IA exécuter des appels API sans outils pré-construits

Superglue CLI est une interface en ligne de commande qui inclut une référence structurée de compétences enseignant aux agents d'IA comment utiliser chaque commande sg, gérer l'authentification, construire des outils et déboguer les échecs. L'idée centrale : au lieu de créer des outils codés en dur pour chaque intégration d'API, vous dirigez l'agent vers n'importe quelle API, et il peut raisonner sur cette API au moment de l'exécution en lisant la spécification, en planifiant les appels et en les exécutant.

Installation et Configuration

Installez le CLI globalement via npm :

npm install -g @superglue/cli

Exécutez la configuration interactive :

sg init

Cela demande votre clé API (disponible sur app.superglue.cloud/admin), votre point de terminaison et vos préférences de sortie. Pour les environnements non interactifs comme CI ou les agents d'IA, définissez les variables d'environnement :

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

Vérifiez avec sg system list — si vous voyez des erreurs d'authentification, vérifiez votre clé API et votre point de terminaison.

Installation de la Compétence

La compétence donne à votre agent d'IA une connaissance complète du CLI — commandes, modèles d'authentification, schémas d'outils, débogage et déploiement. Installez-la une fois et l'agent y fait référence automatiquement.

Installation universelle pour tous les agents :

npx skills add superglue-ai/cli

Ciblez des agents spécifiques avec -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

Pour Claude Code, installez depuis le marché Anthropic :

/plugin install superglue@claude-plugins-official

Ou chargez depuis une installation locale :

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

Pour Cursor, copiez la compétence dans votre projet ou répertoire global :

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

Ce que la Compétence Fournit

• Toutes les commandes CLI avec drapeaux, options et modèles d'utilisation
• Modèles d'authentification — espaces réservés pour identifiants, flux OAuth, formats d'en-têtes
• Schéma de configuration d'outil — configurations d'étapes, sélecteurs de données, transformations, pagination
• Flux de débogage — erreurs courantes, --include-step-results, sg system call pour l'isolation
• Modèles de déploiement — SDK, API REST, webhooks (via references/integration.md)
• Références spécialisées pour bases de données, serveurs de fichiers et transformations (chargées à la demande)

Ajout de Contexte Spécifique au Projet

Ajoutez une section au fichier de configuration d'IA de votre projet (CLAUDE.md, AGENTS.md ou .cursorrules) pour que l'agent sache utiliser la compétence et découvrir votre configuration dynamiquement. Incluez des instructions comme :

## Utilisation de Superglue
Lorsque vous travaillez avec des outils superglue — via le CLI, le SDK ou l'API REST :
1. Invoquez la compétence superglue et lisez le fichier SKILL.md avant d'exécuter toute commande sg
2. Lisez les fichiers de référence pertinents pour la tâche (intégration, bases de données, serveurs de fichiers, transformations)
3. Assurez-vous que le CLI est configuré (sg init a été exécuté ou les variables d'env sont définies)
4. Exécutez sg system list et sg tool list pour découvrir la configuration actuelle avant de construire ou modifier quoi que ce soit
5. Ne codez jamais en dur les ID de système ou d'outil — découvrez-les toujours dynamiquement

Meilleures Pratiques

Toujours tester les systèmes avant de construire des outils. Demandez à l'agent d'exécuter sg system call pour vérifier l'authentification et voir la forme réelle de la réponse avant de construire une configuration d'outil :

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

Utilisez --include-step-results lors du débogage pour afficher la réponse brute de l'API à chaque étape — identifie si le problème est l'authentification, le point de terminaison ou une transformation :

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

Ne collez jamais de secrets dans le chat. Utilisez --sensitive-credentials lors de la création de systèmes via le CLI pour que les secrets soient demandés de manière sécurisée.

Cette approche aborde le plafond des "outils prédéfinis" où les équipes construisent des agents mais les utilisateurs décrivent des besoins spécifiques comme "extraire ces trois objets de Salesforce et les pousser vers nCino lorsque la condition X est vraie". Au lieu de traduire chaque demande en un outil codé en dur, l'agent peut lire la spécification de l'API et gérer des opérations en plusieurs étapes avec une logique par utilisateur.