Für KI-Agenten: Schritt-für-Schritt-Anleitung zur Einrichtung — /docs/agents.md, Dokumentationsindex — /llms.txt.

Für KI-Agenten

Wie man die Anbindung an einen KI-Agenten übergibt: ein fertiger Prompt für jedes Tool. Unten — maschinenlesbare Dokumentationsadressen und ein Skill, den der Agent mit einem einzigen Befehl installiert.

Senden Sie diesen Prompt an Ihren KI-Agenten. Er richtet das Tool nach der folgenden Anleitung ein und fragt Sie nach dem Schlüssel.

Verbinde eigenes Tool mit dem JoinGonka Gateway – der OpenAI- und Anthropic-kompatiblen API des Gonka-Netzwerks – gemäß der Anleitung https://gate.joingonka.ai/docs/agents.md. Den Schlüssel gebe ich selbst an: Speichere ihn nicht in Repository-Dateien und ändere keine globalen Umgebungsvariablen. Prüfe am Ende die Verbindung mit einer kurzen Anfrage und melde das Ergebnis.

Unten steht die Anleitung selbst. Der Agent ruft sie als Markdown unter /docs/agents.md ab.

• Den API-Schlüssel erstellt ein Mensch — im Kundenbereich auf gate.joingonka.ai. Registrieren Sie kein Konto und legen Sie keine Schlüssel selbst an: Bitten Sie den Nutzer um den Schlüssel.
• Halten Sie den Schlüssel in der Umgebungsvariable JOINGONKA_API_KEY Ihrer Terminal-Sitzung. Schreiben Sie ihn nicht in Dateien unter Git, committen Sie ihn nicht und geben Sie ihn nicht im Bericht aus.
• Ändern Sie nicht die globalen Variablen OPENAI_* und ANTHROPIC_* — weder im Shell-Profil noch systemweit: Andere Tools des Nutzers lesen sie. Schlüssel und Adresse werden in der Konfigurationsdatei des Tools selbst gespeichert — genau das macht der Installer.

• Basis-URL für OpenAI-API-Clients: https://gate.joingonka.ai/v1Kopieren
• Basis-URL für Anthropic-API-Clients, ohne /v1: https://gate.joingonka.aiKopieren
• Der Schlüssel wird im Header Authorization: Bearer jg-… oder x-api-key: jg-… übergeben
• Der Schlüssel für Modellanfragen beginnt mit jg-; der Verwaltungsschlüssel gm- lässt keine Modellzugriffe zu.
• Empfohlenes Modell: MiniMaxAI/MiniMax-M2.7Kopieren
• Liste der verfügbaren Modelle: GET https://gate.joingonka.ai/v1/models
• Pro Schlüssel — bis zu 120 Anfragen pro Minute, über dem Limit — Antwort 429 mit dem Header Retry-After. Limits und Timeouts — in der Antwort GET /v1/capabilities, Feld limits.

Finden Sie das Tool des Nutzers in der Tabelle am Ende des Abschnitts. Gibt es den Wert --tool — richten Sie es mit dem Installer ein, sonst — manuell nach dem Guide.

Über den Installer#

Ein Befehl ohne Rückfragen: Der Schlüssel kommt aus der Umgebungsvariable, das Modell aus dem Flag. Der Installer schreibt die Tool-Konfiguration, sichert eine Kopie der alten und prüft die Verbindung mit einer Anfrage an das Gateway.

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

Wenn das Tool bereits lief, starten Sie es neu: Die Konfiguration wird beim Start gelesen.

Manuell#

Öffnen Sie für ein Tool ohne Installer dessen Guide (Link in der Tabelle unten) und setzen Sie drei Werte:

• Basisadresse — https://gate.joingonka.ai/v1 für OpenAI-API-Clients oder https://gate.joingonka.ai für Anthropic-API-Clients;
• Schlüssel — im Feld API-Schlüssel in den Tool-Einstellungen;
• Modell — MiniMaxAI/MiniMax-M2.7 oder ein anderes aus GET /v1/models.

Tools und Guides#

Schlüsselprüfung — Abfrage des Guthabens: Sie verbraucht keine Tokens, der Schlüssel kommt aus JOINGONKA_API_KEY:

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

Prüfung von Adresse, Schlüssel und Modell — eine kurze Anfrage an das Modell:

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}'

Antwort 200 mit Modelltext — die Verbindung funktioniert. Der Installer führt eine solche Prüfung selbst durch: Danach genügt Exit-Code 0.

Der Fehler kommt im Feld error des Antwort-Bodys — mit Typ und Text der Ursache.

Alle Antwortcodes und Limits — im Abschnitt Fehler und Limits.

Teilen Sie dem Nutzer am Ende mit:

• welches Tool eingerichtet und welche Konfigurationsdatei geschrieben wurde (den Pfad gibt der Installer aus, die Kopie der alten liegt daneben);
• Basis-URL und Modell-ID;
• Ergebnis der Prüfung: Antwortcode und Antwort des Modells – oder warum die Prüfung nicht möglich war;
• was der Nutzer noch selbst tun muss: zum Beispiel das Tool neu starten oder das Guthaben aufladen.

Den Schlüssel nicht in den Bericht aufnehmen.

Die Anleitung lässt sich dem Agenten als Skill installieren – dann steht sie ihm jederzeit zur Verfügung, ganz ohne Prompt:

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