Dla agentów AI: instrukcja konfiguracji krok po kroku — /docs/agents.md, indeks dokumentacji — /llms.txt.

Dla agentów AI

Jak przekazać integrację agentowi AI: gotowy prompt dla dowolnego narzędzia. Poniżej — maszynowo czytelne adresy dokumentacji i skill, który agent instaluje jednym poleceniem.

Wyślij ten prompt swojemu agentowi AI. Skonfiguruje narzędzie według poniższej instrukcji, a o klucz poprosi Ciebie.

Podłącz własne narzędzie do JoinGonka Gateway — API sieci Gonka zgodnego z OpenAI i Anthropic — według instrukcji https://gate.joingonka.ai/docs/agents.md. Klucz podam sam: nie zapisuj go w plikach repozytorium i nie zmieniaj globalnych zmiennych środowiskowych. Na koniec sprawdź połączenie krótkim zapytaniem i poinformuj o wyniku.

Poniżej znajduje się sama instrukcja. Agent otrzymuje ją w formacie Markdown pod adresem /docs/agents.md.

• Klucz API tworzy człowiek — w panelu klienta na gate.joingonka.ai. Nie zakładaj konta ani nie twórz kluczy samodzielnie: poproś użytkownika o klucz.
• Trzymaj klucz w zmiennej środowiskowej JOINGONKA_API_KEY swojej sesji terminala. Nie zapisuj go w plikach objętych git, nie commituj i nie wypisuj w raporcie.
• Nie zmieniaj globalnych zmiennych OPENAI_* i ANTHROPIC_* — ani w profilu powłoki, ani w systemie: czytają je inne narzędzia użytkownika. Klucz i adres są zapisywane w konfiguracji samego narzędzia — tak robi instalator.

• Adres bazowy dla klientów OpenAI API: https://gate.joingonka.ai/v1Kopiuj
• Adres bazowy dla klientów Anthropic API, bez /v1: https://gate.joingonka.aiKopiuj
• Klucz przekazywany jest w nagłówku Authorization: Bearer jg-… lub x-api-key: jg-…
• Klucz do zapytań do modeli zaczyna się od jg-; klucz zarządzania gm- nie wpuszcza do modeli.
• Zalecany model: MiniMaxAI/MiniMax-M2.7Kopiuj
• Lista dostępnych modeli: GET https://gate.joingonka.ai/v1/models
• Na klucz — do 120 zapytań na minutę, powyżej limitu — odpowiedź 429 z nagłówkiem Retry-After. Limity i limity czasu — w odpowiedzi GET /v1/capabilities, pole limits.

Znajdź narzędzie użytkownika w tabeli na końcu sekcji. Jest wartość --tool — konfiguruj instalatorem, nie ma — ręcznie według przewodnika.

Przez instalator#

Jedna komenda bez pytań: klucz — ze zmiennej środowiskowej, model — flagą. Instalator zapisze konfigurację narzędzia, zachowa kopię poprzedniej i sprawdzi połączenie zapytaniem do bramy.

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

Jeśli narzędzie było uruchomione, zrestartuj je: konfiguracja jest czytana przy starcie.

Ręcznie#

Dla narzędzia bez instalatora otwórz jego przewodnik (link w tabeli poniżej) i ustaw trzy wartości:

• adres bazowy — https://gate.joingonka.ai/v1 dla klientów OpenAI API lub https://gate.joingonka.ai dla klientów Anthropic API;
• klucz — w polu klucza API w ustawieniach narzędzia;
• model — MiniMaxAI/MiniMax-M2.7 lub inny z GET /v1/models.

Narzędzia i przewodniki#

Weryfikacja klucza — zapytanie o saldo: nie zużywa tokenów, klucz pobierany z JOINGONKA_API_KEY:

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

Weryfikacja adresu, klucza i modelu — krótkie zapytanie do modelu:

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

Odpowiedź 200 z tekstem modelu — połączenie działa. Instalator sam wykonuje taką weryfikację: po nim wystarczy kod wyjścia 0.

Błąd przychodzi w polu error treści odpowiedzi — z typem i tekstem przyczyny.

Wszystkie kody odpowiedzi i limity — w sekcji Błędy i limity.

Na koniec poinformuj użytkownika:

• które narzędzie zostało skonfigurowane i jaki plik konfiguracji zapisano (ścieżkę wyświetla instalator, kopia poprzedniej — obok);
• adres bazowy i identyfikator modelu;
• wynik weryfikacji: kod odpowiedzi i odpowiedź modelu — albo dlaczego nie udało się zweryfikować;
• co użytkownik musi zrobić sam: na przykład zrestartować narzędzie lub doładować saldo.

Nie umieszczaj klucza w raporcie.

Instrukcję można zainstalować agentowi jako umiejętność (skill) — wtedy będzie miał ją pod ręką, nawet bez promptu:

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