ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Connect tools & data

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.

Panel tiež zobrazuje veľkosť odpovede v znakoch a približný počet tokenov. Váš hlasový agent si výsledok nástroja znova prečíta pri každom kole hovoru, preto odpoveď dlhšia ako 20 000 znakov zobrazí upozornenie so spôsobmi, ako ju zmenšiť, a odpoveď dlhšia ako 100 000 znakov je označená, pretože agent vidí iba jej začiatok. Pozrite si Nástroj vracia príliš veľa údajov.

Hodnoty hlavičiek sú iba na zápis. Po uložení sa zašifrujú a už sa nikdy nezobrazia, ani v ovládacom paneli, ani v API. Keď upravujete pripojenie, uložená hlavička zobrazuje svoj názov s bodkami namiesto hodnoty a poznámku Uložené: ponechajte ju bez zmeny, ak chcete zachovať uloženú hodnotu, alebo zadajte novú hodnotu, ak ju chcete nahradiť. Testovacie požiadavky a živé hovory používajú uloženú hodnotu. Klonovať skopíruje uložené hodnoty do nového pripojenia.

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í.

Názvy funkcií musia byť jedinečné iba v rámci jedného agenta. Dve pripojenia môžu mať rovnaký názov, napríklad save_information pre každého z dvoch agentov, ktorí ukladajú údaje na rôzne miesta, no jeden agent nemôže mať obe: uloženie agenta s dvoma nástrojmi s rovnakým názvom bude odmietnuté, rovnako ako premenovanie pripojenia na názov, ktorý už používa iný nástroj jedného z jeho agentov.

Ďalšie kroky