Pripojenia API

Pripojenia API sú vlastné funkcie HTTP, ktoré môžu vaši agenti volať počas konverzácie — vyhľadať objednávku, vytvoriť tiket, načítať stav účtu z vášho vlastného backendu. Koncový bod 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 spôsob: vložiť a analyzovať

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 koncového bodu.

3. Potvrďte zvýraznené polia

   Odvodená konfigurácia sa otvorí s odhadnutý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 číta model.

4. Overiť a uložiť

   Uloženie najprv spustí živú testovaciu požiadavku na váš koncový bod. Ak požiadavka zlyhá, pripojenie sa neuloží — opravte URL, autorizačné hlavičky alebo telo a skúste to znova. Pri úspechu sa pripojenie uloží s označením Overené.

Ak sprievodca vo vašom vloženom obsahu nenájde URL požiadavky, oznámi to — uveďte úplný koncový bod http(s) a skúste to znova.

Manuálne nastavenie

V sprievodcovi kliknite na Nastaviť manuálne → (alebo sa vráťte späť cez Chcete, aby to AI odvodila? Vyskúšať sprievodcu →). Manuálny editor má dva režimy:

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

Panel Otestovať požiadavku (voliteľný) vám umožňuje odoslať nakonfigurovanú požiadavku pred uložením a zobrazuje stav, latenciu a ukážku odpovede. Overiť a uložiť vždy spustí tento test a uloží iba pri úspechu.

Správa pripojení

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

• Upraviť — znova otvoriť konfiguráciu.
• Klonovať — duplikovať ho ako východiskový bod (kópia bude na začiatku Netestovaná).
• História revízií — zobraziť staršie verzie a obnoviť jednu z nich v editore.
• Preniesť — skopírovať alebo presunúť pripojenie do inej organizácie, ktorej ste členom. Presunutím sa odtiaľto odstráni; agenti, ktorí ho používali, môžu vyžadovať novú konfiguráciu.
• Odstrániť — natrvalo; agentov používajúcich pripojenie bude potrebné znova nakonfigurovať.

Pripojte ho k agentovi

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

Ďalšie kroky