Pour les agents IA : guide de configuration étape par étape — /docs/agents.md, index de la documentation — /llms.txt.

Pour les agents IA

Comment confier l'intégration à un agent IA : un prompt prêt à l'emploi pour n'importe quel outil. Ci-dessous — les adresses lisibles par machine de la documentation et une skill que l'agent installe en une seule commande.

Envoyez ce prompt à votre agent IA. Il configurera l'outil selon le mode d'emploi ci-dessous et vous demandera la clé.

Connecte votre outil à JoinGonka Gateway — l'API de la réseau Gonka compatible OpenAI et Anthropic — en suivant les instructions https://gate.joingonka.ai/docs/agents.md. Je te donnerai la clé moi-même : ne l'enregistre pas dans les fichiers du dépôt et ne modifie pas les variables d'environnement globales. À la fin, teste la connexion par une courte requête et indique le résultat.

Voici le mode d'emploi. L'agent le reçoit au format Markdown à l'adresse /docs/agents.md.

• La clé API est créée par un humain — dans l'espace personnel sur gate.joingonka.ai. Ne créez ni compte ni clé vous-même : demandez la clé à l'utilisateur.
• Gardez la clé dans la variable d'environnement JOINGONKA_API_KEY de votre session de terminal. Ne l'écrivez pas dans des fichiers suivis par git, ne la committez pas et ne l'affichez pas dans le rapport.
• Ne modifiez pas les variables globales OPENAI_* et ANTHROPIC_* — ni dans le profil du shell, ni au niveau système : d'autres outils de l'utilisateur les lisent. La clé et l'adresse s'écrivent dans la config de l'outil lui-même — c'est ce que fait l'installateur.

• URL de base pour les clients OpenAI API : https://gate.joingonka.ai/v1Copier
• URL de base pour les clients Anthropic API, sans /v1 : https://gate.joingonka.aiCopier
• La clé se transmet dans l'en-tête Authorization: Bearer jg-… ou x-api-key: jg-…
• La clé pour interroger les modèles commence par jg- ; la clé d'administration gm- ne donne pas accès aux modèles.
• Modèle recommandé : MiniMaxAI/MiniMax-M2.7Copier
• Liste des modèles disponibles : GET https://gate.joingonka.ai/v1/models
• Par clé — jusqu'à 120 requêtes par minute ; au-delà de la limite, la réponse est 429 avec l'en-tête Retry-After. Limites et délais d'attente — dans la réponse GET /v1/capabilities, champ limits.

Trouvez l'outil de l'utilisateur dans le tableau en fin de section. Si la valeur --tool existe — configurez avec l'installateur, sinon — manuellement selon le guide.

Via l'installateur#

Une seule commande, sans questions : la clé vient de la variable d'environnement, le modèle est passé en flag. L'installateur écrira la config de l'outil, conservera une copie de l'ancienne et vérifiera la connexion par une requête à la passerelle.

JOINGONKA_API_KEY=<key> npx -y @joingonka/setup --tool <id> --model MiniMaxAI/MiniMax-M2.7 --non-interactive

Si l'outil était lancé, redémarrez-le : la config est lue au démarrage.

Manuellement#

Pour un outil sans installateur, ouvrez son guide (lien dans le tableau ci-dessous) et renseignez trois valeurs :

• adresse de base — https://gate.joingonka.ai/v1 pour les clients OpenAI API ou https://gate.joingonka.ai pour les clients Anthropic API ;
• clé — dans le champ de clé API des réglages de l'outil ;
• modèle — MiniMaxAI/MiniMax-M2.7 ou un autre parmi GET /v1/models.

Outils et guides#

Vérification de la clé — requête de solde : elle ne consomme pas de tokens, la clé est lue depuis JOINGONKA_API_KEY :

curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

Vérification de l'adresse, de la clé et du modèle — une courte requête au modèle :

curl -s https://gate.joingonka.ai/v1/chat/completions \
  -H "Authorization: Bearer $JOINGONKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

Une réponse 200 avec du texte du modèle — la connexion fonctionne. L'installateur fait lui-même cette vérification : après lui, un code de sortie 0 suffit.

L'erreur arrive dans le champ error du corps de la réponse — avec le type et le texte de la cause.

Tous les codes de réponse et limites — dans la section Erreurs et limites.

À la fin, signalez à l'utilisateur :

• quel outil a été configuré et quel fichier de config a été écrit (le chemin est affiché par l'installateur, la copie de l'ancien est à côté) ;
• l'adresse de base et l'identifiant du modèle ;
• le résultat de la vérification : le code de réponse et la réponse du modèle — ou pourquoi la vérification n'a pas pu être effectuée ;
• ce qu'il reste à faire à l'utilisateur lui-même : par exemple, redémarrer l'outil ou recharger son solde.

N'incluez pas la clé dans le rapport.

Les instructions peuvent être installées comme compétence (skill) pour votre agent — elles seront alors toujours à portée de main, sans prompt :

npx skills add https://gate.joingonka.ai