2️⃣ Použijte Integrace

Chcete-li propojit své integrace API s tokem dialogu AI agenta, musíte ve svém nástroji pro tvorbu toků dialogů použít moduly integrace. K integraci dochází v okamžiku, kdy je tento modul dosažen v toku dialogu (kde jste modul integrace umístili a připojili).

Druhy integrace: Blokující vs Asynchronní

Existují dvě hlavní kategorie integračních modulů, a výběr správného závisí na rychlosti odezvy vašeho API a typu bota, který jste vytvořili.

Modul integrace API

Tento modul čeká na odpověď, než bude pokračovat.

• Ideální pro: Chatboty, Emailové boty nebo rychlá API

• Dialog se zde pozastaví, dokud není přijata odpověď nebo nedojde k vypršení času.

• Poté tok pokračuje buď skrz úspěšný, nebo neúspěšný výstupní port.

Modul pro integraci API (Async + Await)

Tato metoda je neblokující. Odděluje odeslání požadavku a kontrolu výsledku do dvou samostatných modulů, které musíte použít a propojit.

1. Integrace API (Async) — odešle požadavek a okamžitě přejde k dalšímu propojenému modulu ve vašem dialogovém toku bez čekání na odpověď (mapované $context ještě nejsou vytvořeny).

2. Integrace API (Await) — později kontroluje, zda odpověď dorazila. Pokud ne, čeká určitou dobu a poté pokračuje prostřednictvím příslušného výstupního portu.

• Obvykle se používá pouze pro Voiceboty.

• To vám umožní pokračovat v konverzaci, zatímco integrační proces běží na pozadí (mezitím bot pokládá další otázky nebo informuje uživatele, že pracujeme na požadavku).

• Modul Await čeká na odpověď, když tok dialogu dosáhne tohoto modulu. Pokud výsledek stále není připraven, pozastaví se na definovanou dobu a následně pokračuje cestou Čeká se na odpověď, pokud odpověď není stále přijata. Můžete smyčku toku dialogu vrátit zpět na tento modul k opakovanému pokusu nebo zvolit záložní dialog.

Jak používat integrační moduly

Použití základního modulu „Integrace API“

1. V části modulu Pokročilé přetáhněte modul Integrace API do vašeho toku.

2. Kliknutím na modul otevřete panel nastavení.

3. Z rozbalovací nabídky vyberte koncový bod, který chcete použít.

4. Volitelně přidejte vlastní dynamické výstupní porty (pokud jste je definovali v managementu integrace API).

5. Připojte výstupy Úspěch a Selhání (a případné vlastní porty), abyste definovali, co se stane následně.

Použití Async verze

Krok 1: Integrace API (Async)

• Umístěte modul Integrace API (Async) do vašeho toku.

• Vyberte koncový bod, který chcete volat.

• Propojte další kroky — to se děje okamžitě.

• Poznámka: Jakýkoli vstupní $context potřebný pro integraci musí v tuto chvíli existovat - bot je potřebuje pro odeslání požadavku.

Krok 2: Integrace API (Await)

• Využijte modul Await dále ve vašem toku, kde chcete zkontrolovat, zda odpověď dorazila a předpokládá se, že uplynulo dostatečné množství času na její přijetí.

• Nastavte časový limit modulu timeout (jak dlouho by měl bot čekat na odpověď, pokud ještě nebyla doručena). Všimněte si, že časový limit nastavený pro tento koncový bod v managementu API integrace je stále v platnosti (aby se předešlo nekonečným smyčkám), takže se ujistěte, že časový limit modulu není delší než časový limit koncového bodu.

• Připojit:

  • Úspěch → odpověď je připravena, mapované kontexty lze použít.

  • Čekání na odpověď → odpověď nebyla doručena včas (můžete to zkusit znovu, ale ujistěte se, že nevytváříte nekonečnou smyčku — použijte modul Počítadlo k odklonu opakovaných vypršení časového limitu).

  • Chyba → došlo k chybě.

• Poznámka: Mezi Async a Await moduly musí existovat červená šipka nebo jiný typ pauzy. Bot zpracovává všechny moduly propojené zelenými šipkami současně, takže bez čekání neměl by čas na přijetí odpovědi.