Přejít na hlavní obsah

Kontrolní seznam před spuštěním

Tento kontrolní seznam použijte, než ChattyBox zpřístupníte zákazníkům. Zachytí běžné mezery v nastavení, kvůli kterým chatbot vypadá nainstalovaný, ale není připravený.

Při zavádění podpory spojte tento kontrolní seznam s průvodcem chatbotem AI pro zákaznickou podporu, aby odpovědi založené na veřejném obsahu měly jasnou eskalační cestu pro dotazy týkající se účtu, citlivé nebo nevyřešené otázky.

Připravenost obsahu​

  • Je vybrán veřejný obsah dostupný pro crawl, který smíte indexovat a z něhož má chatbot odpovídat.
  • Soukromé stránky, administrace, pokladna, účty, koncepty a stagingový obsah jsou vyloučeny vědomým výběrem zdrojů. Nespoléhejte pouze na robots.txt — crawler jeho pokyny nevynucuje.
  • Zvolili jste správný vstup: sitemapu, ruční URL, pouze domovskou stránku nebo crawl. Crawl nejprve použije nalezené běžné sitemap a pak případně odkazy; neúplnou sitemapu odkazy nedoplňuje.
  • Jsou zahrnuty důležité stránky o produktu, cenách, zásadách, podpoře, nejčastějších dotazech, onboardingu a řešení problémů.
  • Vícejazyčné weby obsahují jazykové verze, ze kterých očekáváte odpovědi widgetu.

Ověření scrapování​

  • Úloha skončila; porovnali jste počty uložených a vybraných stránek i skutečný seznam v Znalosti → Stránky. Samotný stav Completed nedokazuje úplné pokrytí.
  • Počet indexovaných stránek odpovídá očekávání pro váš plán a rozsah spuštění.
  • U stránek Partially indexed jste zkontrolovali chybějící text nad limitem 512 KiB; dlouhé stránky jste podle potřeby rozdělili.
  • Dokončilo se samostatné generování embeddingů a otestovali jste vyhledávání reprezentativními otázkami.
  • Nedávno upravené nebo migrované stránky byly znovu scrapovány.
  • U chybějících stránek jste ověřili autentizaci, ochranu proti botům, neúspěšná nebo nebezpečná přesměrování, filtry zdrojů a obsah dostupný pouze přes JavaScript. Důležitý text je v načteném HTML a nevyžaduje vykreslení JavaScriptu.
  • Zastaralé uložené stránky jste odstranili z Znalosti → Stránky, nejen ze sitemap, a upravili jste zdroj v části Znalosti → Import a aktualizace, aby se znovu neobjevily.

Využití a vlastnictví​

  • Vlastník projektu má přístup k řídicímu panelu a může chatbot spravovat; veřejné klíče ani členství v organizaci samy o sobě oprávnění k řídicímu panelu neposkytují.
  • V části Účet a fakturace (/settings/account) je pro testování a provoz po spuštění dostatečný limit zpráv sdílený mezi chatboty vlastníka.
  • Zkontrolovali jste limity uložených stránek a samostatný měsíční rozpočet na obnovu stránek. Ruční přestavby indexu také spotřebovávají kapacitu obnovy.
  • Plán obnovy odpovídá tarifu: Free nejvýše jednou týdně, placené tarify nejvýše jednou denně. Ruční opakování scrapování podléhá stejné čekací době, i když předchozí úloha selhala.
  • V Pro/Business je PAYG vypnuté, omezené limitem pro každou funkci, nebo záměrně bez limitu; PAYG neodstraňuje čekací dobu crawleru ani jeho měsíční rozpočet na obnovu.
  • Pokud používáte zámek konfigurace, znáte jeho nevratná omezení a oddělený postup se zabezpečeným deployment tokenem.

Kvalita odpovědí​

  • Položili jste skutečné testovací otázky z případů použití prodeje, podpory, onboardingu a dokumentace.
  • Ověřili jste, že reprezentativní odpovědi vycházejí z indexovaného obsahu a že nepodporované otázky dostávají očekávanou záložní odpověď. Odpovědi zkontrolujte — úspěšný test nezaručuje správnost všech budoucích odpovědí.
  • U užitečných odpovědí se zobrazují citace zdrojů.
  • Odkazy v citacích otevírají očekávané veřejné zdrojové stránky.
  • Slabé odpovědi byly opraveny vylepšením zdrojového obsahu nebo přidáním chybějících stránek a následným opětovným scrapováním.
  • Pokud jste Personu změnili, ověřte podle stavu automatického ukládání, že se změny uložily; před testováním opravte chyby validace nebo zopakujte neúspěšné ukládání. Vynucenou záložní odpověď otestujte zvlášť. Text Persony nenahrazuje nakonfigurovanou odpověď při nedostatku kontextu.
  • Testovací otázky obsahují potřebný kontext: generátor odpovědí dostává nejvýše 12 posledních uložených zpráv, každou zkrácenou na 2 000 znaků, nikoli celou konverzaci.

Instalace widgetu​

  • Widget je nainstalován na zamýšlených veřejných stránkách.
  • Skript se na každé stránce načte pouze jednou.
  • Skript obsahuje data-api-key.
  • Skript obsahuje data-api-url.
  • Režimy Automatická detekce / Pevné a Povolit přepsání skriptem jsou nastaveny záměrně. data-locale má přednost pouze při povoleném přepsání, a to i v režimu Pevné.
  • Samostatně jste otestovali jazyk uživatelského rozhraní widgetu, jazyk otázek a odpovědí a indexované jazykové verze.
  • Widget se v anonymním okně otevře a odešle testovací otázku.
  • Testování na mobilním viewportu potvrzuje použitelnost spouštěče i panelu chatu.

Kontrola API klíče a originu​

  • Zamýšlený veřejný klíč je vybrán v Instalace → Instalace na web; jeho nastavení lze spravovat v části Klíče a domény.
  • Při rotaci jste nejprve nainstalovali a otestovali nový klíč a až poté smazali starý. Samotný název klíče prostředí neomezuje.
  • Veřejný klíč jste otestovali na zamýšlených produkčních, preview/stagingových a localhost webech. Zkontrolujte jeho omezení: klíč připravený pro konkrétní web už může být omezen na jeho origin; klíče bez omezení fungují ze všech originů prohlížeče.
  • Pokud je zapnuté volitelné dodatečné zabezpečení, část Klíče a domény → Upravit originy obsahuje přesné originy (musí souhlasit schéma, hostitel a port). Omezení originu není ověřením návštěvníka a veřejné klíče pro prohlížeč nejsou tajné.
  • V kódu frontendu, GTM, vlastním HTML CMS ani ve zdroji stránky nejsou žádné soukromé serverové API klíče, administrátorské tokeny ani tajné údaje.

Kontrola prohlížeče a nasazení​

  • Konzole prohlížeče neobsahuje chyby ChattyBox.
  • Zásady zabezpečení obsahu povolují skript widgetu a URL API, pokud web používá CSP.
  • Blokátory reklam ani nástroje pro souhlas neblokují widget na stránkách, kde se očekává.
  • Byl otestován finální nasazený web, nejen místní vývoj.

Po spuštění​

  • V každém tarifu kontrolujte Konverzace → Historie a v Pro/Business také Analytiku a Nezodpovězené otázky.
  • Analytiku chápejte jako nejvýše 5 000 zaznamenaných interakcí za posledních 30 dní včetně Testu chatu, nikoli jako ověřenou přesnost odpovědí nebo pouze návštěvnický provoz.
  • Kontrolujte zjištěné mezery, znovu testujte opravený obsah a mezery ručně označujte jako vyřešené. Výchozí seznam vyřešené mezery skrývá; Zahrnout vyřešené mezery. a Vrátit zpět je zobrazí a umožní znovu otevřít. Opakovaný výskyt mezery ji znovu neotevře automaticky.
  • Pokud záleží na přiřazení stránky, ověřte Oblíbené spouštěče. Hostovaný widget odesílá kontext stránky včetně její cesty (pathname); nenačítejte jej ani jej neponechávejte na citlivých či soukromých trasách. Samotná podmínka pro spuštění na trase v SPA již inicializovaný widget neodstraní. Ověřte podporu odstranění v nasazeném loaderu: aktuální hostovaný widget.js v16 nabízí window.ChattyBox.destroy(); při použití SDK 0.1.4 zavolejte handle.remove() u všech odpovídajících objektů vrácených z mountWidget(). Headless SDK sendMessage() kontext zdrojové stránky neodesílá.
  • Na základě skutečných dotazů návštěvníků doplňte chybějící dokumentaci, nejčastější dotazy nebo příklady.
  • Po změnách obsahu znovu scrapujte aktualizované stránky.
  • Veřejné klíče widgetu vyměňte podle potřeby; omezení originů měňte pouze tehdy, když je volitelné omezení zapnuté a změní se povolené domény.
  • Konverzace nemažte za účelem resetování využití ani analytiky — tyto záznamy jsou oddělené.

Pokud některá položka selže, použijte před spuštěním Řešení problémů.