Plugin Chatbot

Plugin Chatbot umiestni chatbota Elowen na web tretej strany. Každý chatbot je neinteraktívny účet Elowen viazaný na práve jeden spravovaný Projekt a návštevníci k nemu hovoria cez widget na webe zákazníka. Plugin sám model nikdy nevolá: každá prijatá správa návštevníka spustí skutočný tah Elowen, ktorého vlastníkom je účet chatbota.

Aktuálnu verziu pluginu nájdete v registri. Súčasný balík, ktorý načítava prehliadač, vyžaduje plugin UI API 62 a shared API 14. Predtým, než plugin nainštalujete, nainštalujte vydanie jadra, ktoré vyžaduje jeho manifest.

Chatboty môže inštalovať, nastavovať a spravovať iba administrátor. Nainštalujte plugin v Nastavenia → Pluginy → Dostupné pluginy a potom otvorte Chatboti v hlavnej navigácii. Stránka má päť sekcií: Chatboti, Konverzácie, Hodnotenia, Štatistiky a Spoločné nastavenia.

Dostupnosť počas reštartu démona

Widget na webe zostane počas reštartu Elowen dostupný, ak je nastavená samostatná služba. Existujúci návštevníci môžu pri čakaní správy vidieť oznámenie o zaneprázdnení; noví návštevníci počkajú, kým Elowen nebude pripravený. Odpoveď prerušená reštartom sa automaticky neopakuje.

Vytvorte chatbota

Na stránke Chatboti založte chatbota z nového alebo existujúceho účtu. Účet vznikne ako neinteraktívny účet chatbota: nemôže sa prihlásiť a nemôže byť administrátorom. Pri zakladaní účtu vyberte práve jeden aktívny spravovaný Projekt; jadro uloží účet aj jeho členstvo v Projekte naraz. Existujúce účty chatbota dostanú zvolené členstvo skôr, než sa uložia oprávnenia. Zmazaním Projektu sa chatbot vypne, ale jeho účet ani história konverzácií sa nemaže. Do iného Projektu sa automaticky nepresunie. Priraďte mu práve jeden aktívny spravovaný Projekt; chatbot v ňom pracuje a vlastní prepis. Správanie a znalosti pochádzajú len zo súboru AGENTS.md tohto Projektu.

Chatbot nikomu neodpovedá, kým neplatia tri veci: aspoň jedna povolená doména, práve jeden aktívny spravovaný Projekt a účet chatbota, ktorý nie je administrátorský. Plugin všetky tri podmienky znova overí pred každou prijatou správou.

Povolené domény a kód na vloženie

Každá požiadavka musí zodpovedať povolenému pôvodu. Každú doménu zadajte ako schému a hostiteľa bez cesty, napríklad https://www.example.cz. Bez uvedenej domény chatbot nikomu neodpovedá. Po zapnutí chatbota sú povolené len pôvody https; obyčajné http sa prijíma len pre hostiteľa spätnej slučky, ako je localhost, pre miestne testovacie stránky.

Stránka zobrazuje kód na vloženie na web zákazníka. Verejné ID v kóde chatbota označuje a nie je tajné.

Limity

Každý chatbot začína na bezpečnom predvolenom profile. V detaile chatbota otvorte Limity a potom rozbaľte Limity pre dennú útratu, mesačnú útratu a uchovávanie konverzácií, prípadne Rozšírené pre zostávajúce stropy. Každá hodnota si zachová svoj posuvník aj uloženú jednotku.

Novo zaregistrovaný chatbot dostane celý predvolený profil, takže chýbajúce čísla z neho nerobia koncept. Denná a mesačná útrata pochádzajú zo súhrnu využitia Elowen podľa pôvodu, nie z oddeleného merača. Token návštevníka je jediná právomoc, ktorú anonymný návštevník má; keď vyprší, widget si vyžiada nový a konverzácia pokračuje. Platnosť tokenu sa nastavuje v nastaveniach pluginu ako Platnosť tokenu návštevníka, 1 až 365 dní, predvolene 30.

Stránka návštevníka

Chatbot vie opísať aktuálnu stránku návštevníka a konať na nej v rámci povolených domén. V detaile chatbota otvorte Akcie na stránke. Smie odosielať formuláre rozhoduje o tom, či chatbot môže formuláre odosielať vôbec. Odoslanie v predvolenom stave potvrdzuje návštevník.

Odosielať formuláre bez potvrdenia zapína administrátor, len pre tohto chatbota, a v predvolenom stave je táto voľba vypnutá. Po zapnutí asistent odosiela formuláre priamo, bez potvrdzovacieho dialógu návštevníkovi. Text stránky alebo správa návštevníka môžu asistenta naviesť na odoslanie formulára, ktorý návštevník odoslať nechcel. Limity akcií v tahu, kontroly aktuálnej stránky a cieľa, ochrana citlivých polí, kontroly zastavenia aj náhľad ukazovateľa platia ďalej. Akcie sa ďalej zaznamenávajú vrátane toho, či bolo potrebné potvrdenie, a vrátane svojho konečného výsledku.

Chatbot nevie nahliadnuť do obsahu iframe ani do uzavretých shadow rootov. Jeho účet nepoužíva osobnú pamäť zdieľanú medzi návštevníkmi.

Nabídky v odpovedi

Odpoveď môže niesť krátku ponuku volieb, jeden ďalší krok, odkazy alebo karty. Voľba odošle chatbotovi odpoveď ako ďalšiu správu návštevníka. Odkazy a karty môžu otvoriť len stránky v povolených doménach chatbota a karta môže niesť jedno tlačidlo, ktoré odošle odpoveď alebo takúto stránku otvorí. Odpoveď má najviac šesť volieb, tri odkazy a štyri karty. Druhá ponuka v tom istom tahu nahradí prvú.

Obrázky a súbory

Návštevníci môžu k správe priložiť jeden obrázok ovládacím prvkom Priložiť obrázok. Obrázok musí byť súbor PNG, JPEG, GIF alebo WebP do 10 MB a server kontroluje jeho obsah, nie iba názov.

Odpoveď môže zobraziť až štyri obrázky a až štyri súbory. Zdieľaný obrázok sa zobrazí pod správou a otvorí sa v prehliadači obrázkov na stránke. Zdieľaný súbor sa zobrazí pod správou s odkazom na stiahnutie. Zdieľané súbory môžu mať až 25 MB.

Diktovanie hlasom

Návštevníci môžu správu nadiktovať namiesto písania. Diktovanie je vypnuté pri každom chatbotovi, aj pri tých založených pred jeho vznikom, kým ho nezapnete. Otvorte detail chatbota, rozbaľte skupinu Diktovanie a zapnite Povoliť diktovanie. Prepínač sa ukladá automaticky ako ostatné nastavenia chatbota. Vypnutím sa nové požiadavky na diktovanie okamžite zastavia.

Kým ho zapnete, skontrolujte tieto predpoklady:

• Hlas je v inštancii zapnutý, s poskytovateľom a modelom diktovania nastaveným v Nastavenia → Hlas.
• Plugin Chatbot je účtu chatbota výslovne pridelený v Používatelia.
• Účet chatbota má prístup k hlasu: otvorte Používatelia, vyberte tento účet a zapnite Hlas. Diktovanie návštevníkov túto právomoc vyžaduje aj pri účtoch chatbota; pridelenie chatovacieho modelu ju nenahrádza. Chýbajúci prístup k hlasu vysvetľuje skupina Diktovanie spolu s Otvoriť nastavenia účtu, ktoré otvorí zoznam používateľov.

Ako návštevníci diktujú

• Podržte Odoslať asi tretinu sekundy a hovorte. Prepis sa objavuje počas reči, za textom, ktorý už v poli správy je. Uvoľnite tlačidlo, skontrolujte dokončený text a potom Odoslať stlačte sami.
• Keď je Odoslať zamerané, podržte Space alebo Enter a diktujte; uvoľnením klávesy diktovanie dokončíte. Krátke stlačenie klávesy správu odošle. Escape diktovanie zruší a vráti koncept z času pred jeho začiatkom. Diktovanie používa existujúci stavový riadok a nemá osobitné tlačidlá. Na webe, ktorý svojim stránkam zakazuje prístup k mikrofónu, widget diktovanie vôbec neponúka a Odoslať iba odosiela.
• Krátke kliknutie na Odoslať správu ako doteraz odošle a mikrofón nespustí.
• Diktovanie sa zastaví na nastavenej dĺžke volania v inštancii. Potvrdený text zostane v koncepte.
• Počas písania odpovede diktovanie dostupné nie je.
• Keď sa nič nerozpozná, widget to oznámi a koncept ponechá. Keď prepis zlyhá, zobrazí chybu a ponechá pôvodný koncept, potvrdený nadiktovaný text aj priložený obrázok. Nedokončený text sa odstráni.
• Prepis sa nikdy neodošle automaticky.

Cena a limity

• Živé diktovanie hradí vlastný účet chatbota a započítava sa do jeho denných a mesačných limitov útraty nastavených v časti Limity. Zvuk sa počas nahrávania prenáša nastavenému poskytovateľovi, vrátane prestávok v reči.
• Pre každého chatbota beží vždy len jedno diktovanie. Návštevník, ktorý diktuje, keď beží iné diktovanie, dostane chybu a môže to skúsiť znova.
• Limity sa kontrolujú pred začiatkom diktovania. Útrata sa vopred nerezervuje, takže diktovanie aj textové odpovede, ktoré už bežia, môžu útratu preniesť cez limit.
• Vypnutie diktovania okamžite zastaví nové požiadavky. Práca už odoslaná poskytovateľovi sa napriek tomu naúčtuje.
• Elowen zvuk ani prepis neukladá. Zvuk ide poskytovateľovi prepisu, ktorého vaša inštancia používa. Prepis, ktorý návštevník odošle, sa stane bežnou správou v konverzácii.
• Počas reštartu Elowen diktovanie zlyhá s chybou a neopakuje sa. Keď bude Elowen znova dostupný, môže návštevník diktovať ďalej.

Váš web

• Stránka musí byť dostupná cez https, alebo z localhost pre miestne testy. Prehliadač návštevníka si pre váš web vyžiada oprávnenie na mikrofón. Ak je oprávnenie zamietnuté alebo mikrofón chýba, widget to oznámi a písanie funguje ďalej.
• Ak vaša stránka posiela Content-Security-Policy, povoľte v connect-src pôvody HTTP a WebSocket hooku a do script-src pridajte blob:. Worklet mikrofónu sa načítava z adresy blob a samotné worker-src blob: nestačí.
• Ak widget zobrazujete v iframe na inom webe, iframe potrebuje allow="microphone".
• Diktovanie bolo testované v prehliadačoch založených na Chrome. Safari a iOS zatiaľ overené nie sú, preto ich pred spoliehaním na diktovanie pre týchto návštevníkov otestujte.

Zastavenie odpovede

Stlačte ovládací prvok na zastavenie vo widgete, čím zastavíte odpoveď aj čakajúce akcie na stránke. Kým je zobrazené Zastavujem…, počkajte na dokončenie tahu, než odošlete ďalšiu správu. Zatvorením widgetu alebo karty sa odpoveď nezastaví. Ak sa spojenie preruší, použite Pripojiť znova; už prijatý text zostane vidieť. Administrátori vidia v Konverzácie stavy Zastavuje sa a Zastavené.

Vzhľad

V detaile chatbota otvorte Vzhľad a upravte názov panela, uvítanie, avatara, rýchle tlačidlá, farby, svetlý alebo tmavý režim, veľkosť, umiestnenie, efekty a zvuky. V ponuke s farebnými vzorkami vyberte pomenovanú šablónu. Potvrdením náhrady sa ručné úpravy odstránia a vzhľad sa prepojí so zvolenou šablónou, pričom názov chatbota zostane. Zrušením sa zachová existujúca šablóna aj úpravy. Každé upravené pole možno obnoviť samostatne a živý náhľad zobrazuje aktuálny koncept.

Skupina bubliny na stránke pridáva ozdobnú bodku s jej farbou, pozvánku, ktorá sa zobrazí po oneskorení 2 až 60 sekúnd, poskočenie alebo zavŕtenie s vlastným oneskorením 3 až 120 sekúnd, pulzujúci kruh a odznak neprečítaných odpovedí.

Upraviteľné skupiny sú pri prvej návšteve zbalené a v tomto prehliadači si pamätajú otvorený alebo zatvorený stav, osobitne pre každého chatbota a každú obrazovku nastavení. Údaje len na čítanie a čerpanie zostávajú vidieť. Nastavenia sa ukladajú automaticky; chyby zostávajú vidieť s možnosťou opakovania.

Spoločné nastavenia na stránke Chatboti aj v detaile pluginu upravujú rovnakú platnosť tokenu návštevníka pre celú inštanciu, a to cez konfiguračný editor hostiteľa. Domény, limity, vzhľad a povolenie odosielať formuláre zostávajú nastavením jednotlivých chatbotov. Balík, ktorý načítava prehliadač, vyžaduje UI API 62, hodnotu upravuje cez konfiguračný editor hostiteľa, posiela štruktúrované požiadavky JSON a používa dosadzovanie textu hostiteľa.

Konverzácie, hodnotenia a štatistiky

• Konverzácie zobrazujú konverzácie jedného chatbota, vždy jednu po druhej. Konverzácia sa objaví, keď je prijatá prvá správa návštevníka. Prehľad možno zúžiť na jedného návštevníka; návštevníci sa ponúkajú podľa poslednej IP adresy a ID návštevníka. Každá konverzácia uchováva poslednú IP adresu návštevníka, čo sú osobné údaje: s konverzáciou sa maže podľa doby uchovávania, pri zmazaní operátorom alebo s účtom chatbota.
• Hodnotenia zobrazujú, ako návštevníci hodnotili dokončené odpovede: pomohlo, alebo nepomohlo, s voliteľným komentárom.
• Štatistiky zobrazujú za každý deň UTC, koľko tahov chatbot prijal, koľko z nich odpovedal a koľko zlyhalo, a k tomu útratu účtu chatbota za rovnaké obdobie.

Konverzácie možno zmazať hromadne; konverzácie, na ktoré sa práve odpovedá, zostanú zachované. Zmazaním účtu chatbota sa odstráni aj jeho registrácia, tokeny, návštevníci a história tahov.

Nástroje a oprávnenia

Nástroje pluginu dosiahnu len na účet, ktorý nie je administrátorský a má pre ne oprávnenia jadra, ChatbotPageAction a ChatbotOffer; Spoločné nastavenia ich uvádzajú ako Požadované nástroje. Chatbot, ktorého účet oprávnenie nemá, návštevníkom ďalej odpovedá, ale model chýbajúci nástroj nikdy nevidí, takže bez ChatbotPageAction na stránku nedosiahne. Oprávnenia sa prideľujú po účtoch na obrazovke Používatelia, ktorá spravuje aj neskoršie zmeny; stránka Chatboti raz uvádza, ktoré nástroje každý účet chatbota potrebuje.

Ani model sa na stránke Chatboti neupravuje. Odpoveď chatbota pochádza z jeho vlastného účtu, preto riadok v detaile uvádza model, ktorý sa pre tento účet vyhodnotil, a ktoré pravidlo o tom rozhodlo: vlastná uložená voľba účtu, predvolený model inštancie alebo model vynútený zoznamom povolených modelov účtu. Zmeňte ho na tomto účte.

Citlivé údaje

Rodné čísla a adresy sa zatiaľ nespracúvajú. Nie je rozhodnuté, kde by sa takéto údaje spracúvali a ako dlho by sa uchovávali, preto chatbot tento režim odmieta, namiesto toho aby si uložil nastavenie, ktoré nedokáže dodržať.

Zapnutie a vypnutie

Zapnutie a vypnutie sú výslovné akcie s potvrdením. Zapnutím chatbot prijíma návštevníkov z povolených domén a každá správa čerpá z jeho vlastného účtu. Vypnutím prestane návštevníkov prijímať okamžite; zaznamenané konverzácie zostanú v prepise.