Skilly, MCP a API

Referencia API

Táto stránka ukazuje všetky HTTP endpointy, ktoré môže Váš účet na tejto inštancii volať, vrátane endpointov nainštalovaných pluginov. Nič v zozname nie je písané ručne: Chetty ho číta z ciest, ktoré práve obsluhuje. Keď správca nainštaluje, aktualizuje alebo vypne plugin, zoznam sa prispôsobí, a endpoint, ktorý Váš účet volať nesmie, sa v ňom nikdy neobjaví.

Čo referencia ukazuje

Endpointy sú zoskupené podľa vlastníka: najprv Jadro Chettyho, potom každý plugin pod svojím názvom s popisom, ktorý plugin uvádza.
Pri každom endpointe vidíte metódu, cestu a jednu vetu, ktorú endpoint sám uvádza o tom, kedy ho použiť.
Hľadanie nad zoznamom nájde endpointy podľa slov aj podľa významu. Je to rovnaké hľadanie, aké používa Chetty, keď v konverzácii hľadá endpoint.

Zhrnutia a popisy polí pochádzajú priamo z endpointov, preto sú v angličtine.

Ako čítať endpoint

Rozbaľte endpoint a uvidíte, čo prijíma:

Parametre cesty, Parametre dopytu a Telo požiadavky ukazujú polia, ktoré endpoint overuje, každé s typom a údajom, či je povinné.
Štítok označí endpoint pluginu, ktorý smú volať len správcovia, a druh odpovede, ak nejde o bežný JSON.
Štítok tiež povie, keď endpoint nie je dostupný s osobným API tokenom alebo pre agenta. Ide o akcie, na ktoré musíte byť prihlásení vo webovej aplikácii.

Endpoint jadra si oprávnenia správcu kontroluje sám, takže účtu bez roly správcu môže stále odpovedať 403. Rozbalený endpoint to uvádza.

Použite príklad

Každý endpoint, ktorý môžete volať zo skriptu, má príkaz curl a rovnaké volanie pre nástroj ElowenApi, zostavené z polí samotného endpointu. Príklady vypĺňajú len povinné polia; každú hodnotu v lomených zátvorkách, napríklad <id>, nahraďte vlastnou.

Príkaz curl používa premenné ELOWEN_URL a ELOWEN_TOKEN z návodu Odošlite prvú požiadavku na API agenta. Token vytvoríte podľa návodu Vytvorenie a správa osobného API tokenu. Každá cesta smeruje na rovnakého hostiteľa pod /api.

Volanie z agenta alebo nástroja

V konverzácii volá Chetty endpointy nástrojom ElowenApi. Nástroj prehľadáva a popisuje rovnaký katalóg a príklad ukazuje argumenty, ktoré posiela.
Z MCP klienta prijíma nástroj elowen_request rovnakú metódu, cestu a telo; pozrite Použitie Chettyho ako MCP servera.
Z terminálovej aplikácie prijíma elowen api metódu, cestu a voliteľné telo vo formáte JSON; pozrite Spúšťajte CLI zo skriptov.
Z vlastného klienta čítajte katalóg, z ktorého táto stránka vychádza: sám je endpointom jadra Chettyho. Vyhľadajte v zozname api-catalog.

Autori pluginov, ktorí chcú, aby ich plugin použil pripojenie iného pluginu, napríklad prihlásenie do Microsoft 365 z Microsoft Teams, postupujú podľa návodu pre autorov pluginov Connecting plugins.

Endpointy

Zoznam nižšie sa pre Váš účet načíta pri každom otvorení stránky.