Para sa mga AI agent: step-by-step na gabay sa setup — /docs/agents.md, index ng dokumentasyon — /llms.txt.

Para sa mga AI agent

Paano ipagkatiwala ang integrasyon sa isang AI agent: handa nang prompt para sa anumang tool. Sa ibaba — mga machine-readable na address ng dokumentasyon at skill na ini-install ng agent sa isang command lang.

Ipadala ang prompt na ito sa iyong AI agent. Ise-set up nito ang tool ayon sa instruksyon sa ibaba, at hihingin sa iyo ang key.

Ikonekta ang sariling tool sa JoinGonka Gateway — ang API ng Gonka network na compatible sa OpenAI at Anthropic — ayon sa instruksyon sa https://gate.joingonka.ai/docs/agents.md. Ibibigay ko mismo ang key: huwag itong i-save sa mga file ng repository at huwag baguhin ang global environment variables. Sa dulo, iche-check ang koneksyon gamit ang maikling request at ipaalam ang resulta.

Nasa ibaba ang instruksyon mismo. Natatanggap ito ng agent bilang Markdown sa address na /docs/agents.md.

• Ang API key ay ginagawa ng tao — sa personal na cabinet sa gate.joingonka.ai. Huwag magrehistro ng account at huwag gumawa ng mga key nang mag-isa: hingin ang key sa user.
• Itago ang key sa environment variable na JOINGONKA_API_KEY ng iyong terminal session. Huwag itong isulat sa mga file na nasa ilalim ng git, huwag i-commit at huwag ilabas sa report.
• Huwag baguhin ang mga global variable na OPENAI_* at ANTHROPIC_* — kahit sa profile ng shell, kahit sa system: binabasa ito ng ibang mga tool ng user. Ang key at address ay isinusulat sa config ng tool mismo — ganoon ang ginagawa ng installer.

• Base URL para sa mga OpenAI API client: https://gate.joingonka.ai/v1Kopyahin
• Base URL para sa mga Anthropic API client, walang /v1: https://gate.joingonka.aiKopyahin
• Ipinapasa ang key sa header na Authorization: Bearer jg-… o x-api-key: jg-…
• Ang key para sa mga request sa mga modelo ay nagsisimula sa jg-; ang management key na gm- ay hindi nagpapapasok sa mga modelo.
• Inirerekomendang modelo: MiniMaxAI/MiniMax-M2.7Kopyahin
• Listahan ng available na modelo: GET https://gate.joingonka.ai/v1/models
• Kada key — hanggang 120 request kada minuto, lampas sa limit — sagot na 429 na may header na Retry-After. Mga limit at timeout — sa sagot na GET /v1/capabilities, field na limits.

Hanapin ang tool ng user sa talahanayan sa dulo ng seksyon. Kung may value na --tool — i-set up gamit ang installer, kung wala — manu-manong ayon sa guide.

Sa pamamagitan ng installer#

Isang command na walang tanong: key — mula sa environment variable, modelo — sa pamamagitan ng flag. Isusulat ng installer ang config ng tool, magse-save ng kopya ng dati at susuriin ang koneksyon gamit ang request sa gateway.

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

Kung ang tool ay tumatakbo, i-restart ito: binabasa ang config sa pagsisimula.

Manu-mano#

Para sa tool na walang installer, buksan ang guide nito (link sa talahanayan sa ibaba) at itakda ang tatlong value:

• base address — https://gate.joingonka.ai/v1 para sa mga OpenAI API client o https://gate.joingonka.ai para sa mga Anthropic API client;
• key — sa field ng API key sa settings ng tool;
• modelo — MiniMaxAI/MiniMax-M2.7 o iba pa mula sa GET /v1/models.

Mga tool at guide#

Pag-verify ng key — request sa balanse: hindi ito gumagastos ng token, ang key ay kinukuha mula sa JOINGONKA_API_KEY:

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

Pag-verify ng address, key at modelo — maikling request sa modelo:

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

Sagot na 200 na may teksto ng modelo — gumagana ang koneksyon. Ginagawa ng installer ang ganitong verification mismo: pagkatapos nito, sapat na ang exit code na 0.

Dumarating ang error sa field na error ng katawan ng sagot — may uri at teksto ng dahilan.

Lahat ng response code at limit — sa seksyong Mga Error at Limit.

Sa dulo, ipaalam sa user:

• aling tool ang na-set up at aling config file ang naisulat (ang path ay ipi-print ng installer, ang kopya ng dati ay katabi);
• base address at model ID;
• resulta ng pagsusuri: response code at sagot ng modelo — o bakit hindi ito masusuri;
• ano pa ang dapat gawin ng user mismo: halimbawa, i-restart ang tool o mag-load ng balanse.

Huwag isama ang key sa report.

Maaaring i-install ang instruksyon sa agent bilang skill — sa gayon, lagi itong nasa kamay nito kahit walang prompt:

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