Skilly, MCP a API

Reference API

Tato stránka ukazuje všechny HTTP endpointy, které může Váš účet na této instanci volat, včetně endpointů nainstalovaných pluginů. Nic v seznamu není psané ručně: Chetty ho čte z cest, které právě obsluhuje. Když správce nainstaluje, aktualizuje nebo vypne plugin, seznam se přizpůsobí, a endpoint, který Váš účet volat nesmí, se v něm nikdy neobjeví.

Co reference ukazuje

Endpointy jsou seskupené podle vlastníka: nejdřív Jádro Chettyho, potom každý plugin pod svým názvem s popisem, který plugin uvádí.
U každého endpointu vidíte metodu, cestu a jednu větu, kterou endpoint sám uvádí o tom, kdy ho použít.
Hledání nad seznamem najde endpointy podle slov i podle významu. Je to stejné hledání, jaké používá Chetty, když v konverzaci hledá endpoint.

Shrnutí a popisy polí pocházejí přímo z endpointů, proto jsou anglicky.

Jak číst endpoint

Rozbalte endpoint a uvidíte, co přijímá:

Parametry cesty, Parametry dotazu a Tělo požadavku ukazují pole, která endpoint ověřuje, každé s typem a údajem, zda je povinné.
Štítek označí endpoint pluginu, který smějí volat jen správci, a druh odpovědi, pokud nejde o běžný JSON.
Štítek také řekne, když endpoint není dostupný s osobním API tokenem nebo pro agenta. Jde o akce, ke kterým musíte být přihlášeni ve webové aplikaci.

Endpoint jádra si oprávnění správce kontroluje sám, takže účtu bez role správce může stále odpovědět 403. Rozbalený endpoint to uvádí.

Použijte příklad

Každý endpoint, který můžete volat ze skriptu, má příkaz curl a stejné volání pro nástroj ElowenApi, sestavené z polí samotného endpointu. Příklady vyplňují jen povinná pole; každou hodnotu ve špičatých závorkách, například <id>, nahraďte vlastní.

Příkaz curl používá proměnné ELOWEN_URL a ELOWEN_TOKEN z návodu Odešlete první požadavek na API agenta. Token vytvoříte podle návodu Vytvoření a správa osobního API tokenu. Každá cesta míří na stejného hostitele pod /api.

Volání z agenta nebo nástroje

V konverzaci volá Chetty endpointy nástrojem ElowenApi. Nástroj prohledává a popisuje stejný katalog a příklad ukazuje argumenty, které posílá.
Z MCP klienta přijímá nástroj elowen_request stejnou metodu, cestu a tělo; viz Použití Chettyho jako MCP serveru.
Z terminálové aplikace přijímá elowen api metodu, cestu a volitelné tělo ve formátu JSON; viz Spouštějte CLI ze skriptů.
Z vlastního klienta čtěte katalog, ze kterého tato stránka vychází: sám je endpointem jádra Chettyho. Vyhledejte v seznamu api-catalog.

Autoři pluginů, kteří chtějí, aby jejich plugin použil připojení jiného pluginu, například přihlášení k Microsoft 365 z Microsoft Teams, postupují podle návodu pro autory pluginů Connecting plugins.

Endpointy

Seznam níže se pro Váš účet načte při každém otevření stránky.