Začínáme
Dokumentované kvóty zahrnutých stránek jsou sdílené mezi projekty vlastníka. Kvóty plánů najdete v ceníku a aktuální využití a dostupnou kvótu svého účtu v části Účet a fakturace v dashboardu.
Užitečného chatbota vytvořte dříve, než jej umístíte na svůj web. Základní postup je vytvořit → přidat obsah → zkontrolovat → otestovat → přizpůsobit → integrovat.
1. Vytvořte účet a projekt
Přihlaste se do řídicího panelu ChattyBox, vyberte Nový chatbot, zadejte název a případně URL webu. Po vytvoření se projekt otevře v části Znalosti → Import a aktualizace. Pokud projekt otevřete bez vybrané karty, výchozím zobrazením je Přehled. Samotné vytvoření projektu import nespustí.
Aktuální limity projektů, stránek a využití najdete v ceníku.
2. Nakonfigurujte zdroj obsahu
V části Znalosti → Import a aktualizace připojte veřejný web, zkontrolujte nalezené stránky, upravte doporučený nebo vlastní výběr a spusťte import či aktualizaci vybraných stránek. Změny nastavení zdroje se ukládají automaticky: před pokračováním zkontrolujte stav uložení, opravte chyby validace nebo opakujte neúspěšné uložení. Pokročilé nastavení zdroje nabízí samostatnou akci Spustit scraping, která používá nakonfigurovaný režim vyhledávání. Pravidla include/exclude a hloubku procházení lze nastavit přes konfiguraci jako kód, nikoli v dashboardu.
ChattyBox extrahuje čitelný obsah HTML a změněný obsah zařazuje do fronty k indexování. Samotné vyhledávání stránek ani automatické ukládání import nespouští. Nevyrenderuje JavaScript ani nevynucuje robots.txt; vybírejte veřejné stránky, k jejichž indexování máte oprávnění, a pečlivě zvolte rozsah spuštění. Doba zpracování závisí na vyhledávání, počtu stránek a indexování.
Pokyny k sitemapě, ručním URL, procházení, vícejazyčnému obsahu nebo opětovnému scrapování najdete v části Přidání a obnovení obsahu.
3. Zkontrolujte indexovaný obsah
Otevřete Znalosti → Stránky a porovnejte skutečné stránky s očekávanými zdroji. V podrobnostech úlohy importu zkontrolujte počty a upozornění na částečný obsah; před hodnocením odpovědí ověřte také samostatnou úlohu přípravy embeddingů. Dokončený import nezaručuje, že byla indexována každá požadovaná stránka nebo každá její část. Viz průběh a částečné indexování.
4. Otestujte kvalitu odpovědí
Otevřete Otestovat chatbota a položte reprezentativní otázky, které budou skuteční návštěvníci používat. Ověřte, že odpovědi:
- používají indexovanou dokumentaci, nikoli nepodložené domněnky;
- odkazují na užitečné zdrojové stránky;
- při chybějících informacích použijí zamýšlenou záložní odpověď;
- fungují pro důležité jazyky a terminologii.
Když je odpověď slabá, vylepšete zdrojový obsah nebo výběr stránek a aktualizujte je po uplynutí limitu plánu: Free nejvýše jednou týdně a placené tarify nejvýše jednou denně. Testy ve zobrazení Otestovat chatbota využívají limit zpráv vlastníka a ukládají konverzace. Testovací interakce se mohou objevit v analytice a otázky rozpoznané jako nezodpovězené také mezi zjištěnými mezerami v obsahu; účtování i zaznamenání mezery závisí na výsledku. Chatbota neinstalujte jen proto, že první import skončil.
5. Vylaďte prostředí
V části Přizpůsobení → Chování vyberte nebo upravte pokyny asistenta. Můžete zvolit Helpful Assistant, Sales Representative, Technical Support, Sarcastic Bot nebo Custom Persona. Změny se ukládají automaticky; před pokračováním zkontrolujte stav uložení. Úpravou předvolby se přepne na Custom. Pokyny doplňují vestavěná pravidla pro odpovědi podložené zdroji; načtený obsah se připojuje automaticky, proto nevkládejte znalostní bázi do promptu. Persona nenahrazuje vynucenou záložní odpověď při chybějícím kontextu nebo mezeře v obsahu. Samostatné nastavení assistant.fallbackMessage je dostupné přes konfiguraci jako kód, nikoli jako pole Persona. Po uložení otestujte podporované otázky i záložní odpověď.
Pokud plánujete použít hostovaný widget, v části Přizpůsobení → Vzhled si prohlédněte název, uvítací zprávu, barvy, ikonu, pozici a chování jazyků. Změny se ukládají automaticky; před pokračováním zkontrolujte stav uložení. Volba Pevné a přepsání skriptem mění jazyk rozhraní widgetu, nikoli jazyk indexovaných stránek; viz řešení problémů s jazykem. Tarif Free zahrnuje úpravu vzhledu, ale vyžaduje branding ChattyBox; od tarifu Starter jej lze skrýt.
Tato nastavení provádějte až po otestování obsahu, aby vizuální konfigurace nezakryla problémy s vyhledáváním nebo dokumentací.
6. Vyberte integraci
| Cíl | Další krok |
|---|---|
| Připojit spravované rozhraní ChattyBox z kódu aplikace | JavaScript SDK |
| Vytvořit a spravovat vlastní rozhraní | Headless JavaScript SDK |
| Nechat AI programovacího asistenta integrovat balíček npm | Integrace s pomocí AI |
| Spravovat konfiguraci projektu z Gitu a CI | Nasazení konfigurace pomocí CLI |
| Použít spravované rozhraní bez npm nebo kroku sestavení | Skript hostovaného widgetu |
| Přidat spravovaný widget do WordPressu bez úprav šablony | Plugin WordPress |
| Přidat spravovaný widget do Drupalu 10 nebo 11 pomocí Composeru | Modul Drupal |
Integrace v prohlížeči potřebují veřejný klíč API widgetu. V části Instalace → Instalace na web připravte instalaci pro web nebo spravujte klíč bezpečný pro prohlížeč v části Instalace → Klíče a domény. Zkontrolujte omezení originů: klíč připravený pro doménu webu už může být omezen na tento origin, zatímco klíče vytvořené bez omezení fungují ze všech originů. V části Upravit originy můžete omezení volitelně zapnout nebo přidat produkční, náhledové, stagingové a localhost originy. Pokud je omezení zapnuté, shoda je přesná podle schématu, názvu hostitele a portu (například https://example.com a http://localhost:3000 jsou různé originy). V části Instalace na web vyberte klíč a zkopírujte vygenerovaný úryvek a URL API.
Veřejné klíče widgetu jsou určeny k zobrazení v kódu prohlížeče. Tokeny pro nasazení konfigurace a další přihlašovací údaje pro správu jsou soukromé a nikdy se nesmějí přidávat na web.
Omezení originů jsou volitelným dodatečným zabezpečením, nikoli ověřením návštěvníků. Existující klíč získáte zadáním HTTP(S) URL webu v části Instalace na web a jeho výběrem v úryvku. Výběr nabízí neexpirované klíče bez omezení nebo povolené pro origin zadané URL. Pro výběr omezeného klíče zadejte povolený origin; jeho omezení zkontrolujte přes Spravovat klíče a povolené domény. Není-li instalační formulář dostupný, nejprve dokončete krok nastavení uvedený v dashboardu. Chcete-li klíč vyměnit, vytvořte nový, aktualizujte a otestujte instalaci a poté starý smažte; smazání okamžitě zastaví instalace, které jej stále používají. Klíč patří jednomu chatbotovi — název „staging“ nebo „production“ nevytváří hranici prostředí.
7. Ověřte vše před spuštěním
Vybranou integraci nejprve nainstalujte na náhledový nebo stagingový web. Před zveřejněním otestujte nasazený origin, navigaci mezi trasami, citace, chování záložních odpovědí, mobilní rozvržení a konzoli prohlížeče.
Dokončete kontrolní seznam před spuštěním, poté používejte Konverzace → Historie v každém tarifu a Konverzace → Analytika / Nezodpovězené otázky v Pro/Business; další informace najdete v části Analytika a mezery v obsahu.
Aktuální navigace dashboardu
Projekt otevřete na /chatbot/<projectId>. Karty jsou pohledy v jednom pracovním prostoru a používají parametr tab, nikoli samostatné podstránky:
| Pohled | Hodnota tab | Co zde dělat |
|---|---|---|
| Přehled | overview | Zkontrolovat průběh nastavení a nedávnou aktivitu |
| Znalosti → Import a aktualizace | settings | Vyhledávat, vybírat, importovat a aktualizovat stránky; upravit nastavení zdroje |
| Znalosti → Stránky | content | Kontrolovat stránky a úlohy importu, mazat obsah a znovu vytvořit embeddingy |
| Otestovat chatbota | test | Pokládat otázky a vracet se k uloženým konverzacím |
| Konverzace → Historie | logs | Číst uložené konverzace a mazat jednotlivé nebo všechny |
| Konverzace → Analytika | analytics | Prohlížet zaznamenané interakce za posledních 30 dní, nejvýše 5 000; Pro/Business |
| Konverzace → Nezodpovězené otázky | gaps | Kontrolovat a řešit zjištěné nezodpovězené otázky; Pro/Business |
| Přizpůsobení → Chování | prompts | Vybírat nebo upravovat pokyny asistenta |
| Přizpůsobení → Vzhled | appearance | Náhled a úpravy vzhledu a jazyka hostovaného widgetu |
| Instalace → Klíče a domény | keys | Vytvářet a mazat veřejné klíče a upravovat volitelná omezení originů |
| Instalace → Instalace na web | embed | Připravit instalaci a zkopírovat úryvek s klíčem |
| Nastavení chatbota | manage | Spravovat podrobnosti chatbota, tokeny nasazení a zámek konfigurace nebo chatbota odstranit |
Seznam chatbotů je na /dashboard, přehled účtu na /dashboard/overview a Účet a fakturace na /settings/account, kde najdete profil, tarif, využití zpráv, fakturační portál a nastavení PAYG. Cesty /settings a /settings/billing sem přesměrovávají. Stránka /settings/keys umožňuje vybrat projekt pro tvorbu a mazání veřejných klíčů; volitelná omezení originů se upravují v části Klíče a domény daného chatbota.
Tarify a limity
| Tarif | Chatboti | Stránky na účtu | Zprávy za měsíc |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1 000 |
| Pro | 10 | 5 000 | 10 000 |
| Business | 25 | 25 000 | 50 000 |
Limity zpráv a uložených stránek jsou kvóty vlastníka sdílené mezi jeho chatboty, včetně testů ve zobrazení Otestovat chatbota. Měsíční limit práce na aktualizaci stránek a limity četnosti aktualizací jsou samostatné; před velkým importem nebo opětovným vytvořením indexu si přečtěte limity aktualizací. Viz ceník a aktuální využití a dostupná kvóta v části Účet a fakturace.
PAYG pro zprávy, stránky a weby je v Pro/Business volitelné a ve výchozím stavu vypnuté. V části Účet a fakturace nastavte měsíční rozpočet překročení pro jednotlivé funkce nebo výslovně zvolte Bez limitu útraty. Rozpočet nula ponechá danou funkci pevně omezenou; bez limitu útraty umožňuje neomezené poplatky za použití. PAYG nezpřístupní funkce tarifů Free/Starter ani neobchází prodlevy crawleru mezi aktualizacemi. Jméno v profilu lze upravit zde; e-mail se spravuje v nastavení účtu poskytovatele přihlášení.
Oprávnění a zámek konfigurace
Přístup k projektu v dashboardu má pouze jeho vlastník (nebo uživatel, který je vlastníkem staršího pracovního prostoru). Veřejný klíč widgetu neposkytuje přístup k nastavení projektu ani k uložené historii konverzací; samotné členství v organizaci tato oprávnění k projektu neuděluje.
Pro správu přes Git/CI nabízí Nastavení chatbota konfigurační nasazovací tokeny s rozsahem pro prostředí development, preview a/nebo production, volitelnou expirací a možností odvolání. Na rozdíl od veřejných klíčů widgetu se celá hodnota nasazovacího tokenu zobrazí pouze při jeho vytvoření. Tato část zobrazuje také historii nasazení.
V části Nastavení chatbota je zapnutí config lock nevratné. Blokuje zápisy konfigurace z dashboardu i ruční operace s obsahem, včetně ukládání Persona a akce Spustit scraping, i když příslušné ovládání zůstane viditelné. Konfiguraci místo toho nasazujte přes CLI. Správa veřejných klíčů, mazání konverzací a nastavení brandingu povolené tarifem zůstávají mimo uzamčená pole konfigurace. Rozsahy prostředí tokenu pro nasazení opravňují k nasazení, ale nevytvářejí samostatné chatboty ani prostředí pro klíče v prohlížeči.
Konfigurace jako kód zpřístupňuje také nastavení widget.enabled. Nastavení na false vypne veřejný chat včetně headless SDK, nikoli pouze plovoucí widget. Aktuální formulář vzhledu nemá odpovídající přepínač pro zapnutí ani vypnutí.