Для ИИ-агентов: пошаговая инструкция по настройке — /docs/agents.md, индекс документации — /llms.txt.

Для ИИ-агентов

Как поручить подключение ИИ-агенту: готовый промпт для любого инструмента. Ниже — машинные адреса документации и навык, который агент ставит одной командой.

Отправьте этот промпт своему ИИ-агенту. Он настроит инструмент по инструкции ниже, а ключ попросит у вас.

Подключи свой инструмент к JoinGonka Gateway — OpenAI- и Anthropic-совместимому API сети Gonka — по инструкции 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