Skip to main content
Připojení API jsou vlastní funkce HTTP, které mohou vaši agenti volat během konverzace — vyhledat objednávku, vytvořit tiket nebo 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é, ho pak mohou vyvolat, kdykoli to konverzace vyžaduje. Existují dva způsoby, jak ho vytvořit: vložit něco, co může průvodce analyzovat, nebo připojení nastavit ručně.

Rychlý postup: vložit a analyzovat

1

Klikněte na Nové připojení API

Dialog 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é nalezl. Hlavičky, které jste vložili (včetně autorizač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 provede testovací požadavek na váš endpoint. Pokud požadavek selže, připojení se neuloží — opravte adresu URL, autorizační hlavičky nebo tělo a zkuste to znovu. Po úspěchu se připojení uloží s odznakem 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 pro návrat na Chcete, aby to AI odvodila? Vyzkoušejte průvodce →). Editor ručního nastavení má dva editory:
  • Vizuální — formulářová pole pro zobrazovaný název, název funkce, požadovanou 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 poskytnout).
  • JSON — stejná definice jako nezpracovaný JSON pro vložení nebo přímé doladění specifikace nástroje.
Panel Testovací požadavek (volitelný) vám umožní odeslat nakonfigurovaný požadavek před uložením a zobrazí stav, latenci a náhled odpovědi. Ověřit a uložit vždy spustí tento test a uloží pouze při úspěchu.
Parametrům dávejte srozumitelné popisy („E-mailová adresa zákazníka, např. jane@example.com“). Agent vybírá argumenty z těchto popisů v reálném čase během hovoru.

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ří ho používají. V nabídce akcí řádku můžete:
  • Upravit — znovu otevřít konfiguraci.
  • Klonovat — duplikovat ho jako výchozí bod (kopie začíná 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, jejímž jste členem. Přesunutím se odsud odstraní; agenti, kteří ho používali, mohou vyžadovat novou konfiguraci.
  • Odstranit — trvalé; agenty používající připojení bude nutné znovu nakonfigurovat.

Připojte ho k agentovi

Přidejte připojení k agentovi v sekci připojení API v editoru (Vytvoření agenta). Seznam zobrazuje, kteří agenti používají jednotlivá připojení, takže na první pohled uvidíte, co změna ovlivní.

Další kroky

Integrace nástrojů přes API

Vytvářejte a spravujte stejná připojení programově.

Připojení aplikací

Předpřipravená připojení ke službám Google, Slack, HubSpot, Salesforce a Cal.com.

Přidání serveru MCP

Zpřístupněte svým agentům celý server nástrojů.

Referenční dokumentace API integrací

Každé pole zdroje integrace.