Přejít na hlavní obsah

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ílDalší krok
Připojit spravované rozhraní ChattyBox z kódu aplikaceJavaScript SDK
Vytvořit a spravovat vlastní rozhraníHeadless JavaScript SDK
Nechat AI programovacího asistenta integrovat balíček npmIntegrace s pomocí AI
Spravovat konfiguraci projektu z Gitu a CINasazení konfigurace pomocí CLI
Použít spravované rozhraní bez npm nebo kroku sestaveníSkript hostovaného widgetu
Přidat spravovaný widget do WordPressu bez úprav šablonyPlugin WordPress
Přidat spravovaný widget do Drupalu 10 nebo 11 pomocí ComposeruModul 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:

PohledHodnota tabCo zde dělat
PřehledoverviewZkontrolovat průběh nastavení a nedávnou aktivitu
Znalosti → Import a aktualizacesettingsVyhledávat, vybírat, importovat a aktualizovat stránky; upravit nastavení zdroje
Znalosti → StránkycontentKontrolovat stránky a úlohy importu, mazat obsah a znovu vytvořit embeddingy
Otestovat chatbotatestPokládat otázky a vracet se k uloženým konverzacím
Konverzace → HistorielogsČíst uložené konverzace a mazat jednotlivé nebo všechny
Konverzace → AnalytikaanalyticsProhlížet zaznamenané interakce za posledních 30 dní, nejvýše 5 000; Pro/Business
Konverzace → Nezodpovězené otázkygapsKontrolovat a řešit zjištěné nezodpovězené otázky; Pro/Business
Přizpůsobení → ChovánípromptsVybírat nebo upravovat pokyny asistenta
Přizpůsobení → VzhledappearanceNáhled a úpravy vzhledu a jazyka hostovaného widgetu
Instalace → Klíče a doménykeysVytvářet a mazat veřejné klíče a upravovat volitelná omezení originů
Instalace → Instalace na webembedPřipravit instalaci a zkopírovat úryvek s klíčem
Nastavení chatbotamanageSpravovat 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​

TarifChatbotiStránky na účtuZprávy za měsíc
Free110100
Starter31501 000
Pro105 00010 000
Business2525 00050 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í.