Pripojenia API

Premeňte akékoľvek HTTP API na funkciu, ktorú môže váš agent volať uprostred konverzácie: vložte príkaz cURL a sprievodca vytvorí definíciu nástroja, parametre a autentifikáciu.

Pripojenia API sú vlastné funkcie HTTP, ktoré môžu vaši agenti volať počas konverzácie — vyhľadať objednávku, vytvoriť ticket, načítať stav účtu z vášho vlastného backendu. Endpoint definujete raz v časti Pripojenia → API (/dashboard/api-connections); agenti s pripojeným pripojením ho potom môžu vyvolať vždy, keď si to konverzácia vyžaduje.

Môžete ho vytvoriť dvoma spôsobmi: vložiť niečo, čo sprievodca dokáže analyzovať, alebo pripojenie nastaviť manuálne.

Rýchly postup: vloženie a analýza#

1. Kliknite na Nové pripojenie API

   Dialógové okno sa otvorí v sprievodcovi. Do poľa vložte ukážkový príkaz cURL, špecifikáciu OpenAPI/Swagger, export z Postmanu, rozhranie TypeScript alebo schému Zod.

2. Kliknite na Analyzovať

   ThunderPhone z vášho vloženého obsahu odvodí celé pripojenie — URL, metódu, hlavičky a schému parametrov odvodenú z parametrov dopytu a tela požiadavky, ktoré našiel. Hlavičky, ktoré ste vložili (vrátane autorizačných hlavičiek), sa prenesú do konfigurácie endpointu.

3. Potvrďte zvýraznené polia

   Odvodená konfigurácia sa otvorí s predpokladanými poľami zvýraznenými na kontrolu. Upravte názvy, popisy a typy parametrov, aby agent rozumel, kedy a ako má funkciu volať — popis je to, čo číta model.

4. Overiť a uložiť

   Uloženie najprv spustí reálnu testovaciu požiadavku na váš endpoint. Ak požiadavka zlyhá, pripojenie sa neuloží — opravte URL, autorizačné hlavičky alebo telo a skúste to znova. Po úspechu sa pripojenie uloží s odznakom Overené.

Ak sprievodca vo vloženom obsahu nenájde URL požiadavky, upozorní vás na to — uveďte úplný endpoint http(s) a skúste to znova.

Manuálne nastavenie#

V sprievodcovi kliknite na Nastaviť manuálne → (alebo sa vráťte kliknutím na Chcete, aby to AI odvodila? Vyskúšajte sprievodcu →). Manuálny nástroj má dva editory:

• Vizuálny — polia formulára pre zobrazovaný názov, názov funkcie, požiadavkovú URL, metódu (POST, GET, PUT, PATCH, DELETE), vlastné hlavičky a schému parametrov (Pridať vlastnosť pre každý argument, ktorý môže agent zadať).
• JSON — rovnaká definícia ako nespracovaný JSON na vloženie alebo priame doladenie špecifikácie nástroja.

Panel Testovacia požiadavka (voliteľný) vám umožní odoslať nakonfigurovanú požiadavku pred uložením a zobrazí stav, latenciu a náhľad odpovede. Overiť a uložiť vždy spustí tento test a uloží len pri úspechu.

Správa pripojení#

Každý riadok pripojenia zobrazuje stav overenia — Overené, Neotestované alebo Chyba — názov funkcie a agentov, ktorí ho používajú. V ponuke akcií riadku môžete:

• Upraviť — znova otvoriť konfiguráciu.
• Klonovať — duplikovať ho ako východiskový bod (kópia má na začiatku stav Neotestované).
• História revízií — zobraziť staršie verzie a jednu z nich obnoviť v editore.
• Preniesť — skopírovať alebo presunúť pripojenie do inej organizácie, ktorej ste členom. Presunom ho odtiaľto odstránite; agentov, ktorí ho používali, možno bude nutné prekonfigurovať.
• Odstrániť — trvalé odstránenie; agentov používajúcich pripojenie bude nutné prekonfigurovať.

Pripojte ho k agentovi#

Pridajte pripojenie k agentovi v sekcii Pripojenia API nástroja na vytváranie agentov (Vytvorenie agenta). Zoznam zobrazuje, ktorí agenti používajú jednotlivé pripojenia, takže na prvý pohľad zistíte, čo zmena ovplyvní.

Ďalšie kroky#