Chování

Co jsou akce

Akce je něco, co asistent umí během konverzace UDĚLAT, nad rámec odpovídání ze znalostní báze.

Vlastní akce je HTTPS požadavek, který si nadefinujete: název, popis, URL a volitelné vstupy. Když se návštěvník zeptá na něco, co akce umí zodpovědět (stav objednávky, dostupnost zboží, termín doručení), asistent doplní vstupy, zavolá váš endpoint a JSON odpověď zapracuje do své odpovědi.

Předpřipravená akce je vestavěná schopnost, kterou spravuje Breezaro. Nenastavujete žádné URL, jen ji zapnete. Prvními jsou Zavolat operátora a Vyhledávání v produktech.

Krok za krokem

Vytvořte první vlastní akci

Pět kroků od prázdného formuláře k funkční akci. Připravte si URL endpointu svého API.

Vytvořte akci
V dashboardu otevřete Vlastní akce a zvolte Nová akce. Pojmenujte ji Stav objednávky a popište: Vyhledá objednávku podle čísla a vrátí stav doručení.
Nasměrujte ji na endpoint
Zvolte metodu GET a vložte URL svého endpointu. HTTPS je povinné a hostname nesmí obsahovat zástupný symbol. Pomocí {{variable}} vložíte vstup kamkoli do cesty nebo query.
Přidejte vstup
Přidejte vstup orderId s krátkým popisem (Číslo objednávky zákazníka). Asistent jeho hodnotu vyčte z konverzace a pošle ji jako query parametr.
Otestujte
Spusťte vestavěný test se vzorovým orderId. Uvidíte přesnou odpověď, kterou by asistent dostal. Akci nelze zapnout, dokud test neprojde.
Zapněte ji
Přepněte přepínač. Od té chvíle asistent při dotazu na objednávku zavolá vaši akci a odpoví aktuálními daty.

Editor vlastní akce v Breezaro s metodou, adresou, vstupy a tajnými hlavičkami — Editor akce: metoda, adresa, vstupy a šifrované tajné hlavičky

Nastavení

Import z cURL

Pokud už máte funkční curl příkaz (z dokumentace vašeho API nebo z nástroje jako Postman), vložte ho v editoru akce do Import z cURL. Metoda, URL, hlavičky i tělo se předvyplní.

Chování

Předpřipravené akce

Hotové akce, které zapínáte pro každého asistenta zvlášť.

Zavolat operátora: když návštěvník požádá o člověka, zasekne se nebo je frustrovaný, asistent eskaluje okamžitě bez doplňujících otázek, upozorní váš tým (e-mail, push notifikace a notifikace v dashboardu s důvodem, a se jménem návštěvníka, pokud ho už uvedl) a pozastaví odpovědi AI v dané konverzaci. Návštěvník může dál psát; vše se ukládá a čeká na vás v inboxu.

Pauza končí ve chvíli, kdy operátor konverzaci převezme (nebo asistenta obnoví). Opakované žádosti ve stejné konverzaci jsou omezené, aby se váš inbox nezahltil.

Vyhledávání v produktech: aktivuje se automaticky, jakmile má asistent připojený katalog produktů. Asistent ve vašich produktech vyhledává a doporučuje je s aktuálními cenami a dostupností. Spravujete v Zdroje → Produkty.

Šablony

Začněte se šablonou

Rychlejší cesta k funkční akci: v galerii vyberete šablonu a editor se rovnou předvyplní.

Galerie předpřipravených akcí obsahuje i celé šablony, nejen přepínače. První je Stav objednávky (WooCommerce): volbou „Použít šablonu“ otevřete editor vlastní akce s už vyplněným názvem, popisem, požadavkem, vstupy i navrhovanými poli odpovědi.

Vzniklá akce patří vám: jde o běžnou vlastní akci, kterou můžete upravovat, testovat i smazat stejně jako kteroukoli jinou, a počítá se do vašeho limitu akcí.

Chování

Co uvidí AI

Spustíte testovací volání a pak asistentovi přesně určíte, které části odpovědi smí vidět.

Po úspěšném testu se odpověď zobrazí jako strom se zaškrtávacími políčky. Zaškrtnete pole, která smí asistent použít ve svých odpovědích; vše nezaškrtnuté se k modelu nikdy nedostane, ať endpoint vrátí cokoli.

Strom výběru polí odpovědi v testovacím kroku — Výběr polí: vyberte, která pole odpovědi smí asistent použít

Soukromí

Ověření vlastnictví

Volitelné pravidlo, které zabrání tomu, aby si přes stejnou akci jeden návštěvník přečetl data jiného návštěvníka.

Vyberete vstup a pole odpovědi, které se musí shodovat, například e-mail návštěvníka proti fakturačnímu e-mailu objednávky. Akce odpoví, jen když se shodují, přesně jako to ve výchozím nastavení dělá šablona Stav objednávky (WooCommerce). Ověření může kombinovat jednu nebo více podmínek a vyžadovat, aby platily všechny, nebo aby stačila jedna.

Při neshodě vidí asistent stejný výsledek jako u skutečně neexistujícího záznamu, takže nepozná špatné číslo objednávky od cizí objednávky. Opakované neúspěšné pokusy ve stejné konverzaci se omezují, takže se hádání nevyplatí.

Soukromí

Limity a bezpečnost

Vlastní akce jsou záměrně omezené, aby špatně nastavený endpoint nemohl poškodit asistenta ani návštěvníky.

Pouze HTTPS, pouze GET a POST. Požadavky na privátní či interní síťové adresy jsou blokované.
Odpověď musí být JSON, do 16 KB a do 10 sekund; cokoli jiného je odmítnuto.
Tajné hlavičky jsou šifrované a po uložení se už nikdy nezobrazí.
Asistent smí v jedné odpovědi zavolat nejvýše dvě akce.
Akci lze zapnout až po úspěšném testu.
Akce jsou dostupné od tarifu Pro výše (a během zkušební doby).
Každé volání akce se účtuje jako jedna odpověď navíc podle kreditové sazby zvoleného modelu (model za 1 kredit přičte 1 kredit, model za 3 kredity přičte 3).