Connect tools & data

Připojení API

Proměňte libovolné rozhraní HTTP API na funkci, kterou může váš agent volat uprostřed konverzace: vložte příkaz cURL a průvodce vytvoří definici nástroje, parametry a ověřování.

Připojení API jsou vlastní funkce HTTP, které mohou vaši agenti během konverzace volat — vyhledat objednávku, vytvořit tiket, načíst stav účtu z vašeho vlastního backendu. Endpoint definujete jednou v části Připojení → API (/dashboard/api-connections); agenti, kteří mají připojení připojené, je pak mohou vyvolat, kdykoli to konverzace vyžaduje.

Existují dva způsoby, jak ho vytvořit: vložit něco, co průvodce dokáže analyzovat, nebo připojení nastavit ručně.

Rychlá cesta: vložení a analýza#

1. Klikněte na Nové připojení API

   Dialogové okno se otevře v průvodci. Do pole vložte ukázkový příkaz cURL, specifikaci OpenAPI/Swagger, export z Postmanu, rozhraní TypeScript nebo schéma Zod.

2. Klikněte na Analyzovat

   ThunderPhone z vašeho vloženého obsahu odvodí celé připojení — adresu URL, metodu, hlavičky a schéma parametrů odvozené z parametrů dotazu a těla požadavku, které našel. Hlavičky, které jste vložili (včetně autentizačních hlaviček), se přenesou do konfigurace endpointu.

3. Potvrďte zvýrazněná pole

   Odvozená konfigurace se otevře s odhadnutými poli zvýrazněnými ke kontrole. Upravte názvy, popisy a typy parametrů, aby agent rozuměl, kdy a jak funkci volat — popis je to, co model čte.

4. Ověřit a uložit

   Uložení nejprve spustí živý testovací požadavek na váš endpoint. Pokud požadavek selže, připojení se neuloží — opravte adresu URL, autentizační hlavičky nebo tělo a zkuste to znovu. Po úspěšném ověření se připojení uloží s označením Ověřeno.

Pokud průvodce ve vloženém obsahu nenajde adresu URL požadavku, upozorní vás na to — uveďte úplný endpoint http(s) a zkuste to znovu.

Ruční nastavení#

V průvodci klikněte na Nastavit ručně → (nebo se vraťte zpět přes Chcete, aby to AI odvodila? Vyzkoušejte průvodce →). Ruční konfigurátor obsahuje dva editory:

• Vizuální — formulářová pole pro zobrazovaný název, název funkce, požadavek URL, metodu (POST, GET, PUT, PATCH, DELETE), vlastní hlavičky a schéma parametrů (Přidat vlastnost pro každý argument, který může agent zadat).
• JSON — stejná definice jako nezpracovaný JSON pro vložení nebo přímé doladění specifikace nástroje.

Panel Testovací požadavek (volitelný) umožňuje před uložením odeslat nakonfigurovaný požadavek a zobrazí stav, odezvu a náhled odpovědi. Ověřit a uložit tento test vždy spustí a uloží pouze při úspěchu.

Správa připojení#

Každý řádek připojení zobrazuje stav ověření — Ověřeno, Netestováno nebo Chyba — název funkce a agenty, kteří jej používají. V nabídce akcí daného řádku můžete:

• Upravit — znovu otevřít konfiguraci.
• Klonovat — duplikovat jej jako výchozí bod (kopie začne jako Netestováno).
• Historie revizí — zobrazit dřívější verze a obnovit jednu z nich do editoru.
• Převést — zkopírovat nebo přesunout připojení do jiné organizace, do které patříte. Přesunutím se odsud odstraní; agenty, které jej používaly, může být nutné překonfigurovat.
• Smazat — trvalá akce; agenty používající připojení bude nutné překonfigurovat.

Připojení k agentovi#

Přidejte připojení k agentovi v části připojení API v konfigurátoru (Vytvoření agenta). Seznam zobrazuje, kteří agenti jednotlivá připojení používají, takže na první pohled uvidíte, čeho se změna týká.

Další kroky#