Skilly, MCP a API

Odošlite prvú požiadavku na API agenta

Pošlite jednu správu agentovi z terminálu a získajte hotovú odpoveď vo formáte JSON.

Skôr než začnete

Potrebujete osobný API token a adresu, na ktorej Chetty otvárate. Token vytvoríte v Účet → API tokeny, ak ho ešte nemáte; pozrite si Vytvorenie a správa osobného API tokenu.

Príklady používajú https://elowen.example.com. Nahraďte ju vlastnou adresou. Každá požiadavka mieri na toho istého hostiteľa, pod /api.

Uložte adresu a token do dvoch premenných shellu:

export ELOWEN_URL=https://elowen.example.com
export ELOWEN_TOKEN=elw_…   # the token you copied

Overte, že token funguje. Odpoveď uvádza Váš účet:

curl -sS "$ELOWEN_URL/api/auth/me" -H "Authorization: Bearer $ELOWEN_TOKEN"

Chýbajúci, neznámy, zmazaný alebo prepadnutý token odpovie 401 {"error":"unauthorized"}. To isté sa stane, keď tokenu vytvoríte novú hodnotu: stará hodnota prestane platiť od tej chvíle.

Odošlite požiadavku

Správu posielajte na POST /api/v1/agent/runs. Volanie spustí jeden bežný ťah agenta a odpovie, až je ťah hotový.

curl -sS "$ELOWEN_URL/api/v1/agent/runs" \
  -H "Authorization: Bearer $ELOWEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Summarize the failed builds from yesterday"}'

Povinné je len message. Pridajte conversationId na pokračovanie v konverzácii, model na voľbu modelu (Zvoľte model cez API) a "stream": true na sledovanie ťahu (Streamujte odpoveď agenta). Referencia API uvádza každé pole s jeho typom a významom, načítané priamo zo schémy požiadavky.

Prečítajte odpoveď

{ "conversationId": "brain-12-…", "reply": "Two builds failed…", "usage": { "tokens": 1840, "costUsd": 0.012 } }

conversationId uvádza konverzáciu, ktorú beh použil. Pošlite ju znova a budete v konverzácii pokračovať.
reply je hotová odpoveď.
usage.tokens počíta tokeny, ktoré ťah spotreboval.

usage.costUsd je null, keď beh nikto neocenil: poskytovateľ nehlásil žiadnu cenu a Chetty pre model žiadnu nemá, ani katalógovú, ani nastavenú pre daný model. Cena, ktorú Chetty má, je odhad a cena hlásená poskytovateľom má prednosť, vrátane hlásenej $0.

Keď volanie čaká príliš dlho

Volanie čaká až dve minúty. Dlhší ťah odpovie 202 s názvom konverzácie a bez odpovede:

{ "conversationId": "…", "reply": null, "usage": null }

Ťah beží ďalej a jeho odpoveď sa uloží do danej konverzácie. Pri dlhej práci ťah streamujte, namiesto toho, aby ste čakali: Streamujte odpoveď agenta.

Overte, že to fungovalo

Otvorte konverzáciu vo webovej aplikácii. Váš beh je v histórii konverzácií ako každý iný, s odpoveďou, ktorú API vrátilo. Jeho tokeny a náklady sa zobrazia pri tokene, ktorý ho spustil.

Čo ďalšie API vie, nájdete v API agenta; ako obmedziť výdavky skriptu, v Obmedzte, čo môže API token spustiť.