Для ШІ-агентів: покрокова інструкція з налаштування — /docs/agents.md, індекс документації — /llms.txt.

Для ШІ-агентів

Як доручити підключення ШІ-агенту: готовий промпт для будь-якого інструмента. Нижче — машинні адреси документації та навичка, яку агент встановлює однією командою.

Надішліть цей промпт своєму ШІ-агенту. Він налаштує інструмент за інструкцією нижче, а ключ попросить у вас.

Підключи свій інструмент до JoinGonka Gateway — API мережі Gonka, сумісного з OpenAI та Anthropic — за інструкцією https://gate.joingonka.ai/docs/agents.md. Ключ я дам сам: не зберігай його у файлах репозиторію і не змінюй глобальні змінні середовища. Наприкінці перевір підключення коротким запитом і повідом результат.

Нижче — сама інструкція. Агент отримує її у вигляді Markdown за адресою /docs/agents.md.

• Ключ API створює людина — в особистому кабінеті на gate.joingonka.ai. Не реєструйте акаунт і не створюйте ключі самі: попросіть ключ у користувача.
• Тримайте ключ у змінній середовища JOINGONKA_API_KEY своєї сесії термінала. Не записуйте його у файли під git, не комітьте і не виводьте у звіті.
• Не змінюйте глобальні змінні OPENAI_* і ANTHROPIC_* — ні в профілі оболонки, ні в системі: їх читають інші інструменти користувача. Ключ і адреса записуються в конфіг самого інструмента — так робить інсталятор.

• Базова адреса для клієнтів OpenAI API: https://gate.joingonka.ai/v1Копіювати
• Базова адреса для клієнтів Anthropic API, без /v1: https://gate.joingonka.aiКопіювати
• Ключ передається в заголовку Authorization: Bearer jg-… або x-api-key: jg-…
• Ключ для запитів до моделей починається з jg-; ключ керування gm- до моделей не пускає.
• Рекомендована модель: MiniMaxAI/MiniMax-M2.7Копіювати
• Список доступних моделей: GET https://gate.joingonka.ai/v1/models
• На ключ — до 120 запитів за хвилину, понад ліміт — відповідь 429 із заголовком Retry-After. Ліміти й таймаути — у відповіді GET /v1/capabilities, поле limits.

Знайдіть інструмент користувача в таблиці в кінці розділу. Є значення --tool — налаштовуйте інсталятором, немає — вручну за гайдом.

Через інсталятор#

Одна команда без запитань: ключ — зі змінної середовища, модель — прапорцем. Інсталятор запише конфіг інструмента, збереже копію попереднього й перевірить підключення запитом до шлюзу.

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

Якщо інструмент було запущено, перезапустіть його: конфіг читається при старті.

Вручну#

Для інструмента без інсталятора відкрийте його гайд (посилання в таблиці нижче) і задайте три значення:

• базова адреса — https://gate.joingonka.ai/v1 для клієнтів OpenAI API або https://gate.joingonka.ai для клієнтів Anthropic API;
• ключ — у полі API-ключа в налаштуваннях інструмента;
• модель — MiniMaxAI/MiniMax-M2.7 або іншу з GET /v1/models.

Інструменти та гайди#

Перевірка ключа — запит балансу: він не витрачає токени, ключ береться з JOINGONKA_API_KEY:

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

Перевірка адреси, ключа й моделі — короткий запит до моделі:

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

Відповідь 200 із текстом моделі — підключення працює. Інсталятор робить таку перевірку сам: після нього достатньо коду виходу 0.

Помилка приходить у полі error тіла відповіді — з типом і текстом причини.

Усі коди відповідей і ліміти — в розділі Помилки та ліміти.

Наприкінці повідомте користувача:

• який інструмент налаштовано і який файл конфіга записано (шлях друкує інсталятор, копія попереднього — поруч);
• базова адреса та ідентифікатор моделі;
• результат перевірки: код відповіді та відповідь моделі — або чому перевірити не вдалося;
• що користувач має зробити сам: наприклад, перезапустити інструмент або поповнити баланс.

Ключ у звіт не додавайте.

Інструкцію можна встановити агенту як навичку (skill) — тоді вона буде в нього під рукою й без промпту:

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