Plugin Chatbot

Plugin Chatbot umístí chatbota Elowen na web třetí strany. Každý chatbot je neinteraktivní účet Elowen vázaný na právě jeden spravovaný Projekt a návštěvníci k němu mluví přes widget na webu zákazníka. Plugin sám model nikdy nevolá: každá přijatá zpráva návštěvníka spustí skutečný tah Elowen, jehož vlastníkem je účet chatbota.

Aktuální verzi pluginu najdete v registru. Současný balíček, který načítá prohlížeč, vyžaduje plugin UI API 62 a shared API 14. Než plugin nainstalujete, nainstalujte vydání jádra, které vyžaduje jeho manifest.

Chatboty může instalovat, nastavovat a spravovat jen administrátor. Nainstalujte plugin v Nastavení → Pluginy → Dostupné pluginy a potom otevřete Chatboti v hlavní navigaci. Stránka má pět sekcí: Chatboti, Konverzace, Hodnocení, Statistiky a Společné nastavení.

Dostupnost během restartu démona

Widget na webu zůstane během restartu Elowen dostupný, pokud je nastavená samostatná služba. Stávající návštěvníci mohou při čekání zprávy vidět oznámení o zaneprázdnění; noví návštěvníci počkají, dokud Elowen nebude připraven. Odpověď přerušená restartem se automaticky neopakuje.

Vytvořte chatbota

Na stránce Chatboti založte chatbota z nového nebo existujícího účtu. Účet vznikne jako neinteraktivní účet chatbota: nemůže se přihlásit a nemůže být administrátorem. Při zakládání účtu vyberte právě jeden aktivní spravovaný Projekt; jádro uloží účet i jeho členství v Projektu najednou. Existující účty chatbota dostanou zvolené členství dřív, než se uloží oprávnění. Smazáním Projektu se chatbot vypne, ale jeho účet ani historie konverzací se nemaže. Do jiného Projektu se automaticky nepřesune. Přiřaďte mu právě jeden aktivní spravovaný Projekt; chatbot v něm pracuje a vlastní přepis. Chování a znalosti pocházejí jen ze souboru AGENTS.md tohoto Projektu.

Chatbot nikomu neodpovídá, dokud neplatí tři věci: aspoň jedna povolená doména, právě jeden aktivní spravovaný Projekt a účet chatbota, který není administrátorský. Plugin všechny tři podmínky znovu ověří před každou přijatou zprávou.

Povolené domény a kód pro vložení

Každý požadavek musí odpovídat povolenému původu. Každou doménu zadejte jako schéma a hostitele bez cesty, například https://www.example.cz. Bez uvedené domény chatbot nikomu neodpovídá. Po zapnutí chatbota jsou povolené jen původy https; obyčejné http se přijímá jen pro hostitele zpětné smyčky, jako je localhost, pro místní testovací stránky.

Stránka ukazuje kód pro vložení na web zákazníka. Veřejné ID v kódu chatbota označuje a není tajné.

Limity

Každý chatbot začíná na bezpečném výchozím profilu. V detailu chatbota otevřete Limity a potom rozbalte Limity pro denní útratu, měsíční útratu a uchování konverzací, případně Rozšířené pro zbývající stropy. Každá hodnota si zachová svůj posuvník i uloženou jednotku.

Nově zaregistrovaný chatbot dostane celý výchozí profil, takže chybějící čísla z něj nedělají koncept. Denní a měsíční útrata pocházejí ze souhrnu využití Elowen podle původu, ne z odděleného měřiče. Token návštěvníka je jediná pravomoc, kterou anonymní návštěvník má; když vyprší, widget si vyžádá nový a konverzace pokračuje. Platnost tokenu se nastavuje v nastavení pluginu jako Platnost tokenu návštěvníka, 1 až 365 dní, výchozí 30.

Stránka návštěvníka

Chatbot umí popsat aktuální stránku návštěvníka a jednat na ní v rámci povolených domén. V detailu chatbota otevřete Akce na stránce. Smí odesílat formuláře rozhoduje o tom, zda chatbot může formuláře odesílat vůbec. Odeslání ve výchozím stavu potvrzuje návštěvník.

Odesílat formuláře bez potvrzení zapíná administrátor, jen pro tohoto chatbota, a ve výchozím stavu je tato volba vypnutá. Po zapnutí asistent odesílá formuláře přímo, bez potvrzovacího dialogu návštěvníkovi. Text stránky nebo zpráva návštěvníka mohou asistenta navést k odeslání formuláře, který návštěvník odeslat nechtěl. Limity akcí v tahu, kontroly aktuální stránky a cíle, ochrana citlivých polí, kontroly zastavení i náhled ukazatele platí dál. Akce se dál zaznamenávají včetně toho, zda bylo potřeba potvrzení, a včetně svého konečného výsledku.

Chatbot neumí nahlédnout do obsahu iframe ani do uzavřených shadow rootů. Jeho účet nepoužívá osobní paměť sdílenou mezi návštěvníky.

Nabídky v odpovědi

Odpověď může nést krátkou nabídku voleb, jeden další krok, odkazy nebo karty. Volba odešle chatbotovi odpověď jako další zprávu návštěvníka. Odkazy a karty mohou otevřít jen stránky v povolených doménách chatbota a karta může nést jedno tlačítko, které odešle odpověď nebo takovou stránku otevře. Odpověď má nejvýš šest voleb, tři odkazy a čtyři karty. Druhá nabídka v témže tahu nahradí první.

Obrázky a soubory

Návštěvníci mohou ke zprávě přiložit jeden obrázek ovládacím prvkem Přiložit obrázek. Obrázek musí být soubor PNG, JPEG, GIF nebo WebP do 10 MB a server kontroluje jeho obsah, ne jen název.

Odpověď může zobrazit až čtyři obrázky a až čtyři soubory. Sdílený obrázek se zobrazí pod zprávou a otevře se v prohlížeči obrázků na stránce. Sdílený soubor se zobrazí pod zprávou s odkazem ke stažení. Sdílené soubory mohou mít až 25 MB.

Diktování hlasem

Návštěvníci mohou zprávu nadiktovat místo psaní. Diktování je vypnuté u každého chatbota, i u těch založených před jeho vznikem, dokud ho nezapnete. Otevřete detail chatbota, rozbalte skupinu Diktování a zapněte Povolit diktování. Přepínač se ukládá automaticky jako ostatní nastavení chatbota. Vypnutím se nové požadavky na diktování okamžitě zastaví.

Než ho zapnete, zkontrolujte tyto předpoklady:

• Hlas je v instanci zapnutý, s poskytovatelem a modelem diktování nastaveným v Nastavení → Hlas.
• Plugin Chatbot je účtu chatbota výslovně přidělen v Uživatelé.
• Účet chatbota má přístup k hlasu: otevřete Uživatelé, vyberte tento účet a zapněte Hlas. Diktování návštěvníků tuto pravomoc vyžaduje i u účtů chatbota; přidělení chatovacího modelu ji nenahrazuje. Chybějící přístup k hlasu vysvětluje skupina Diktování spolu s Otevřít nastavení účtu, které otevře seznam uživatelů.

Jak návštěvníci diktují

• Podržte Odeslat asi třetinu sekundy a mluvte. Přepis se objevuje během řeči, za textem, který už v poli zprávy je. Uvolněte tlačítko, zkontrolujte dokončený text a potom Odeslat stiskněte sami.
• Když je Odeslat zaměřené, podržte Space nebo Enter a diktujte; uvolněním klávesy diktování dokončíte. Krátké stisknutí klávesy zprávu odešle. Escape diktování zruší a vrátí koncept z doby před jeho začátkem. Diktování používá stávající stavový řádek a nemá zvláštní tlačítka. Na webu, který svým stránkám zakazuje přístup k mikrofonu, widget diktování vůbec nenabízí a Odeslat jen odesílá.
• Krátké kliknutí na Odeslat zprávu jako dřív odešle a mikrofon nespustí.
• Diktování se zastaví na nastavené délce volání v instanci. Potvrzený text zůstane v konceptu.
• Během psaní odpovědi diktování dostupné není.
• Když se nic nerozpozná, widget to oznámí a koncept ponechá. Když přepis selže, ukáže chybu a ponechá původní koncept, potvrzený nadiktovaný text i přiložený obrázek. Nedokončený text se odstraní.
• Přepis se nikdy neodešle automaticky.

Cena a limity

• Živé diktování hradí vlastní účet chatbota a započítává se do jeho denních a měsíčních limitů útraty nastavených v části Limity. Zvuk se během nahrávání přenáší nastavenému poskytovateli, včetně přestávek v řeči.
• Pro každého chatbota běží vždy jen jedno diktování. Návštěvník, který diktuje, když běží jiné diktování, dostane chybu a může to zkusit znovu.
• Limity se kontrolují před začátkem diktování. Útrata se předem nerezervuje, takže diktování i textové odpovědi, které už běží, mohou útratu přenést přes limit.
• Vypnutí diktování okamžitě zastaví nové požadavky. Práce už odeslaná poskytovateli se přesto naúčtuje.
• Elowen zvuk ani přepis neukládá. Zvuk jde poskytovateli přepisu, kterého vaše instance používá. Přepis, který návštěvník odešle, se stane běžnou zprávou v konverzaci.
• Během restartu Elowen diktování selže s chybou a neopakuje se. Až bude Elowen znovu dostupný, může návštěvník diktovat dál.

Váš web

• Stránka musí být dostupná přes https, nebo z localhost pro místní testy. Prohlížeč návštěvníka si pro váš web vyžádá oprávnění k mikrofonu. Pokud je oprávnění zamítnuté nebo mikrofon chybí, widget to oznámí a psaní funguje dál.
• Pokud vaše stránka posílá Content-Security-Policy, povolte v connect-src původy HTTP a WebSocket hooku a do script-src přidejte blob:. Worklet mikrofonu se načítá z adresy blob a samotné worker-src blob: nestačí.
• Pokud widget zobrazujete v iframe na jiném webu, iframe potřebuje allow="microphone".
• Diktování bylo testováno v prohlížečích založených na Chromiu. Safari a iOS zatím ověřené nejsou, proto je před spoléháním na diktování pro tyto návštěvníky otestujte.

Zastavení odpovědi

Stiskněte ovládací prvek pro zastavení ve widgetu, čímž zastavíte odpověď i čekající akce na stránce. Dokud je zobrazené Zastavuji…, počkejte na dokončení tahu, než pošlete další zprávu. Zavřením widgetu nebo karty se odpověď nezastaví. Pokud se spojení přeruší, použijte Připojit znovu; už přijatý text zůstane vidět. Administrátoři vidí v Konverzace stavy Zastavuje se a Zastaveno.

Vzhled

V detailu chatbota otevřete Vzhled a upravte název panelu, uvítání, avatar, rychlá tlačítka, barvy, světlý nebo tmavý režim, velikost, umístění, efekty a zvuky. V nabídce s barevnými vzorky vyberte pojmenovanou šablonu. Potvrzením náhrady se ruční úpravy odstraní a vzhled se propojí se zvolenou šablonou, přičemž název chatbota zůstane. Zrušením se zachová stávající šablona i úpravy. Každé upravené pole lze obnovit samostatně a živý náhled ukazuje aktuální koncept.

Skupina bubliny na stránce přidává ozdobnou tečku s její barvou, pozvánku, která se zobrazí po zpoždění 2 až 60 sekund, poskočení nebo zavrtění s vlastním zpožděním 3 až 120 sekund, pulzující kruh a odznak nepřečtených odpovědí.

Upravitelné skupiny jsou při první návštěvě sbalené a v tomto prohlížeči si pamatují otevřený nebo zavřený stav, zvlášť pro každého chatbota a každou obrazovku nastavení. Údaje jen pro čtení a čerpání zůstávají vidět. Nastavení se ukládají automaticky; chyby zůstávají vidět s možností opakování.

Společné nastavení na stránce Chatboti i v detailu pluginu upravuje stejnou platnost tokenu návštěvníka pro celou instanci, a to přes konfigurační editor hostitele. Domény, limity, vzhled a povolení odesílat formuláře zůstávají nastavením jednotlivých chatbotů. Balíček, který načítá prohlížeč, vyžaduje UI API 62, hodnotu upravuje přes konfigurační editor hostitele, posílá strukturované požadavky JSON a používá dosazování textu hostitele.

Konverzace, hodnocení a statistiky

• Konverzace ukazují konverzace jednoho chatbota, vždy jednu po druhé. Konverzace se objeví, jakmile je přijata první zpráva návštěvníka. Přehled lze zúžit na jednoho návštěvníka; návštěvníci se nabízejí podle poslední IP adresy a ID návštěvníka. Každá konverzace uchovává poslední IP adresu návštěvníka, což jsou osobní údaje: s konverzací se maže podle doby uchování, při smazání operátorem nebo s účtem chatbota.
• Hodnocení ukazuje, jak návštěvníci hodnotili dokončené odpovědi: pomohlo, nebo nepomohlo, s volitelným komentářem.
• Statistiky ukazují za každý den UTC, kolik tahů chatbot přijal, kolik jich odpověděl a kolik selhalo, a k tomu útratu účtu chatbota za stejné období.

Konverzace lze smazat hromadně; konverzace, na které se právě odpovídá, zůstanou zachované. Smazáním účtu chatbota se odstraní i jeho registrace, tokeny, návštěvníci a historie tahů.

Nástroje a oprávnění

Nástroje pluginu dosáhnou jen na účet, který není administrátorský a má pro ně oprávnění jádra, ChatbotPageAction a ChatbotOffer; Společné nastavení je uvádí jako Požadované nástroje. Chatbot, jehož účet oprávnění nemá, návštěvníkům dál odpovídá, ale model chybějící nástroj nikdy nevidí, takže bez ChatbotPageAction na stránku nedosáhne. Oprávnění se přidělují po účtech na obrazovce Uživatelé, která spravuje i pozdější změny; stránka Chatboti jednou uvádí, které nástroje každý účet chatbota potřebuje.

Ani model se na stránce Chatboti neupravuje. Odpověď chatbota pochází z jeho vlastního účtu, takže řádek v detailu uvádí model, který se pro tento účet vyhodnotil, a které pravidlo o tom rozhodlo: vlastní uložená volba účtu, výchozí model instance nebo model vynucený seznamem povolených modelů účtu. Změňte ho na tomto účtu.

Citlivé údaje

Rodná čísla a adresy se zatím nezpracovávají. Není rozhodnuté, kde by se takové údaje zpracovávaly a jak dlouho by se uchovávaly, proto chatbot tento režim odmítá, místo aby si uložil nastavení, které nedokáže dodržet.

Zapnutí a vypnutí

Zapnutí a vypnutí jsou výslovné akce s potvrzením. Zapnutím chatbot přijímá návštěvníky z povolených domén a každá zpráva čerpá z jeho vlastního účtu. Vypnutím přestane návštěvníky přijímat okamžitě; zaznamenané konverzace zůstanou v přepisu.