Skilly, MCP a API

Odešlete první požadavek na API agenta

Pošlete jednu zprávu agentovi z terminálu a získejte hotovou odpověď ve formátu JSON.

Než začnete

Potřebujete osobní API token a adresu, na které Chetty otevíráte. Token vytvoříte v Účet → API tokeny, pokud ho ještě nemáte; viz Vytvoření a správa osobního API tokenu.

Příklady používají https://elowen.example.com. Nahraďte ji vlastní adresou. Každý požadavek míří na stejného hostitele, pod /api.

Uložte adresu a token do dvou proměnných shellu:

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

Ověřte, že token funguje. Odpověď uvádí Váš účet:

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

Chybějící, neznámý, smazaný nebo propadlý token odpoví 401 {"error":"unauthorized"}. Totéž se stane, když tokenu vytvoříte novou hodnotu: stará hodnota přestane platit od té chvíle.

Odešlete požadavek

Zprávu posílejte na POST /api/v1/agent/runs. Volání spustí jeden běžný tah agenta a odpoví, až je tah 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 jen message. Přidejte conversationId pro pokračování v konverzaci, model pro volbu modelu (Zvolte model přes API) a "stream": true pro sledování tahu (Streamujte odpověď agenta). Reference API uvádí každé pole s jeho typem a významem, načtené přímo ze schématu požadavku.

Přečtěte odpověď

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

conversationId uvádí konverzaci, kterou běh použil. Pošlete ji znovu a budete v konverzaci pokračovat.
reply je hotová odpověď.
usage.tokens počítá tokeny, které tah spotřeboval.

usage.costUsd je null, když běh nikdo neocenil: poskytovatel nehlásil žádnou cenu a Chetty pro model žádnou nemá, ani katalogovou, ani nastavenou pro daný model. Cena, kterou Chetty má, je odhad a cena hlášená poskytovatelem má přednost, včetně hlášené $0.

Když volání čeká příliš dlouho

Volání čeká až dvě minuty. Delší tah odpoví 202 s názvem konverzace a bez odpovědi:

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

Tah běží dál a jeho odpověď se uloží do dané konverzace. U dlouhé práce tah streamujte, místo abyste čekali: Streamujte odpověď agenta.

Ověřte, že to fungovalo

Otevřete konverzaci ve webové aplikaci. Váš běh je v historii konverzací jako každý jiný, s odpovědí, kterou API vrátilo. Jeho tokeny a náklady se objeví u tokenu, který ho spustil.

Co dalšího API umí, najdete v API agenta; jak zabránit skriptu, aby utrácel bez omezení, v Omezte, co může API token spustit.