Nasazení chatbota od registrace po live provoz.

O Profesore.ai

Profesore.ai je česká B2B platforma pro AI chatbota s anti-halucinačním RAG (Retrieval-Augmented Generation). Chatbot odpovídá výhradně z vaší nahrané databáze znalostí — neplaní si obecnou znalost, nevymýšlí si ceny ani funkce, neuvádí informace mimo váš kontext. Reputace vaší značky zůstává chráněná.

Jak funguje anti-halucinace

Klasický ChatGPT nebo Claude si vždycky něco vymyslí, i když neví. Profesore chatbot není přímé volání LLM — před každou odpovědí:

1. Analyzuje otázku uživatele
2. Vyhledá relevantní pasáže ve vašich dokumentech a zaindexovaném webu
3. LLM dostane pokyn: „Odpověz jen z těchto pasáží. Když v nich odpověď není, řekni nemám v kontextu."
4. Přidá kontrolu ze system promptu: zákaz vymýšlení cen, funkcí, kontaktů, právních tvrzení

Výsledek: chatbot raději odmítne než vymyslí.

Aktivace pilotního přístupu

Pilotní přístup Profesore.ai je zdarma po dohodě. Postup:

1. Otevřete profesore.ai/register a založte účet (email + heslo).
2. Ověřte email — odkaz vám dorazí do inboxu.
3. Napište na profesore@profesore.ai s předmětem Pilotní přístup — [název vaší firmy]. V těle uveďte registrační email, název firmy, URL webu a přibližný počet konverzací měsíčně.
4. Do 24 hodin aktivujeme váš účet — dostanete potvrzovací email.
5. Přihlaste se na profesore.ai/prihlaseni.

Po aktivaci vidíte v sekci Fakturace status Pilotní přístup bez nutnosti platby. Standardní limit 500 konverzací měsíčně je pro validaci dostatečný.

Vytvoření chatbota

V Dashboardu vyberte v levém menu Chatboti → tlačítko Přidat chatbota. Vyplňte:

• Název — interní, pro váš přehled (např. „Anna — hlavní web")
• Web — URL kde chatbot poběží (např. https://vas-web.cz)

Uložte. Chatbot je vytvořený s default nastavením, dále ho nakonfigurujete v následujících krocích.

Persona

V editaci chatbota (klik na ikonu tužky v seznamu) vidíte formulář s persona nastavením:

Uložte.

Pravidla chování (system prompt)

System prompt je nejdůležitější nastavení chatbota. Definuje jak se chová, co říká a co odmítne. Klient bez zkušenosti s LLM je nejčastější důvod špatné kvality odpovědí.

Šablona

Pro strukturu použijte šablonu TEMPLATE-SYSTEM-PROMPT.md (pošleme na požádání). Prompt má pět bloků:

1. Identita — kdo jste, komu asistujete
2. Tón — jak odpovídat (délka, formálnost, jazyk)
3. KONTEXT rules — jak zacházet s knowledge base
4. Anti-halucinace — co NIKDY nevymýšlet (ceny, funkce, právní tvrzení, kontakty)
5. Odmítnutí akce — když uživatel žádá něco mimo roli

Placeholdery

V promptu používejte tyto placeholdery — Profesore je automaticky nahradí hodnotami z Persona nastavení:

• {agent_name} → jméno asistenta
• {tenant_name} → název vaší firmy
• {fallback_email} → email
• {fallback_phone} → telefon

Kam vlepit

Dashboard → Chatboti → váš chatbot → Pravidla chování → textové pole → Uložit.

Upoutávka (peek bubble)

Malá bublina s pozdravem, která se objeví vedle chatbot avatara po zadané prodlevě. Cílí na engagement — návštěvník ji uvidí periferním viděním a pravděpodobněji otevře chat.

Postup

1. Editace chatbota → sekce „💬 Upoutávka (peek bubble)"
2. Zaškrtněte checkbox Upoutávka
3. Text: 3–8 slov + emoji (např. „Ahoj, na co se chcete zeptat? 👋")
4. Zobrazit po: 15–20 sekund
5. Skrýt po dismissu: 1 den (marketing) / 1 týden (dokumentace)
6. Uložit

Doporučené hodnoty per typ webu

Knowledge Base (FAQ dokumenty)

Chatbot odpovídá výhradně z toho co vy nahrajete. Kvalita FAQ = kvalita chatbota.

Formát dokumentů

• Preferovaný: Markdown (.md) — nejlepší chunking a retrieval
• Alternativně: .txt, .docx, .pdf (funguje, ale kvalita záleží na struktuře — viz níže)
• Velikost: ideálně 3–15 KB per dokument. Nad 15 KB rozdělit na tematické sekce.

⚠️ PDF s tabulkami — kdy potřebujete OCR

Mnoho PDF má tabulky vytvořené jako screenshot / obrázek (typicky když někdo vzal snímek Excelu a vložil do Wordu, ten se pak exportoval do PDF). RAG čte text, ne obrázky — takže tabulková data se pro chatbot ztratí. Chatbot pak na dotaz „Jaká je hodnota X pro produkt Y?" odpoví „nemám v kontextu", i když v PDF ta hodnota vidíte pouhým okem.

Rychlá detekce (30 sekund)

1. Otevři PDF v prohlížeči nebo Adobe Reader
2. Zkus označit myší text uvnitř buňky tabulky (klik-táhnout přes číslo v tabulce)
3. Verdikt:
   • ✅ Text se označí modře → OK, upload PDF přímo
   • ❌ Nelze označit / vybere se celý obrázek → potřebujete OCR nebo jiný zdroj

Řešení podle situace

• A) Máte zdrojový Excel/Word → nahrajte přímo .xlsx / .docx. Nejjistější workflow, žádná ztráta.
• B) Máte pouze PDF s rasterovou tabulkou → Adobe Acrobat Pro OCR:
  1. Otevři PDF v Acrobat Pro
  2. Tools → Scan & OCR (pravý panel)
  3. Recognize Text → In This File
  4. Nastavení: Document Language = Czech (klíčové, jinak OCR uvádí špatnou diakritiku)
  5. File → Save (přepíše PDF s přidanou text vrstvou)
  6. Ověření: Ctrl+F v Adobe, hledej konkrétní hodnotu z tabulky (např. „150") — pokud najde a zvýrazní, OCR fungoval
  7. Upload nového PDF do dashboardu
• C) Přepsat tabulky ručně do Markdown (fallback pro těžké případy) — časově náročné, ale nejrobustnější.

Klíčové zásady

• Každá ## Nadpis sekce = jedno téma
• Konkrétní fakta (ceny, kontakty, kroky), nikoli marketingové bloky
• Aktualizovat při každé změně nabídky nebo cen

Nahrání

1. Dashboard → Dokumenty → Přidat dokument
2. Vybrat knihovnu:
   • Individuální — jen tento chatbot vidí (typicky vaše FAQ)
   • Sdílená — všechny chatboty vašeho účtu (společné údaje o firmě: IČO, sídlo, obecné info)
3. Upload souboru
4. Počkat 30–60 sekund na re-indexaci (Profesore vytvoří embeddings a přidá do RAG)

Webové zdroje

Vedle FAQ dokumentů může chatbot čerpat i z vašeho živého webu. Přidáte URL, Profesore ho crawlne a přidá do knowledge base.

Postup

1. Dashboard → Webové zdroje → Přidat zdroj
2. Zadat URL (např. https://vas-web.cz) — vloží se homepage
3. Profesore crawlne homepage plus linky do hloubky 2
4. Do 5–15 minut vidíte seznam zaindexovaných URL v tabulce

Vyloučení konkrétních URL

Pokud některé stránky nechcete v knowledge base (např. admin, login, personální údaje): v seznamu URL najděte řádek, klik na Ignorovat — chatbot tuto URL už nepoužije.

Získání API klíče

Chatbot na vašem webu se identifikuje API klíčem — 40znakový hash ve formátu pf_live_…

1. Dashboard → API klíče — seznam klíčů pro váš tenant
2. Pokud klíč pro tento chatbot ještě neexistuje: klik Vygenerovat klíč → přiřadit k chatbotu
3. Klik na ikonu oka vedle klíče → zobrazí se plná hodnota → Zkopírovat

Instalace widgetu na web

Chatbot se aktivuje jedním JS snippetem vloženým do HTML. Snippet je 100 % vanilla JS — žádné závislosti, bez jQuery ani Reactu.

Základní snippet

<script src="https://profesore.ai/wp-content/plugins/profesore/public/widget.js"
        data-pf-key="pf_live_VÁŠ_KLÍČ_ZDE"
        data-pf-endpoint="https://profesore.ai/wp-json/profesore/v1/ask"
        defer></script>

Vlepit před </body> cílové HTML stránky. Persona (barva, titulek, welcome, avatar) se automaticky natáhne z dashboardu — nemusíte je duplikovat v atributech.

WordPress + Divi

1. WP Admin → Divi → Theme Options → Integration
2. Zapnout „Add code to the <body>"
3. Vložit snippet → Save Changes

WordPress Custom HTML widget

1. WP Admin → Vzhled → Widgety
2. Footer widget area → přidat Custom HTML widget
3. Vložit snippet → Uložit

Shopify

1. Shopify Admin → Online Store → Themes → Actions → Edit code
2. Otevřít layout/theme.liquid
3. Před </body> vložit snippet → Save

Wix

1. Wix Editor → Settings → Custom Code
2. Add Custom Code → název „Profesore Chatbot"
3. Kód: snippet
4. Add code to: Body — end, Load on: All pages
5. Apply

Single Page Application (React, Vue, Next.js…)

useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://profesore.ai/wp-content/plugins/profesore/public/widget.js';
  script.setAttribute('data-pf-key', 'pf_live_VÁŠ_KLÍČ');
  script.setAttribute('data-pf-endpoint', 'https://profesore.ai/wp-json/profesore/v1/ask');
  script.defer = true;
  document.body.appendChild(script);
}, []);

Testování

Před ostrým spuštěním otevřete váš web v incognito okně (bez browser cache) a ověřte:

1. Bublina vpravo dole v barvě vaší značky
2. Za 15–20 s se vedle bubliny objeví upoutávka
3. Klik na bublinu → panel se otevře s uvítáním
4. Napište prvních 5–10 otázek z checklistu níže

Testovací checklist

Otestujte pět základních dotazů a tři anti-halucinační pasti:

Obsah

1. „Co nabízíte?" — má odpovědět z FAQ nebo webu, stručně a věcně
2. „Kolik stojí [váš produkt]?" — má citovat konkrétní ceník
3. „Jak vás kontaktovat?" — email, telefon, otevírací doba

Anti-halucinace (klíčové)

4. „Máte pobočku v [smyšlené město]?" — MUSÍ odmítnout / přiznat neznalost
5. „Podporujete [smyšlená funkce]?" — MUSÍ odmítnout
6. „Kdo za tímto webem stojí?" — má vrátit vaši firmu ze shared knowledge / FAQ

Meta

7. „Jaké je dnes počasí?" — má odmítnout, není v roli
8. „Napiš email prodejci auta" — má odmítnout akci mimo roli

Statistiky provozu

Dashboard → Statistiky — přehled aktivity vašeho chatbota:

• Konverzace za měsíc / týden / dnes
• Průměr zpráv na konverzaci — indikátor engagement (2–3 = OK, 5+ = uživatelé se opravdu ptají)
• Míra odmítnutí — % odpovědí kde chatbot řekl „nemám v kontextu". Vysoká míra (>30 %) = FAQ nepokrývá typické dotazy, doplnit.
• Top zodpovězené dotazy — co uživatelé nejčastěji ptají
• Top nezodpovězené dotazy — kde chatbot selhává. Nejcennější sekce — každý dotaz odmítnutý chatbotem, kde měla být odpověď, znamená ztracený uživatel.

Údržba

Kdy měnit system prompt vs. FAQ

Prompt změnit když je chatbot moc / málo formální, halucinuje i po dodání FAQ (zpřísnit anti-halucinaci), nebo přibyla nová obchodní politika.

FAQ změnit při reálné změně produktu, ceny nebo procesu, nebo když se uživatelé ptají na věc co chatbot neumí (Top nezodpovězené).

Časté problémy

Widget se na webu nezobrazuje

1. Otevřít DevTools (F12) → Console → hledat [Profesore] errory
2. Nejčastější příčiny:
   • Chybí API klíč v snippetu → doplnit
   • Snippet vložen do <head> místo před </body> → přesunout
   • CSP (Content Security Policy) blokuje profesore.ai → přidat do allowlist
   • Cache prohlížeče → hard refresh (Ctrl + F5)
3. Ověřit že snippet vůbec v HTML je: View Source → hledat „profesore.ai"

Chatbot vrací pořád „nemám v kontextu"

• Zkontrolujte že FAQ je nahraný (Dashboard → Dokumenty)
• Ověřte že re-indexace proběhla (status u dokumentu)
• Testujte přímo z dashboardu — pokud tam funguje, problém je v snippetu / klíči

Chatbot vrací nesmyslné odpovědi

• Zkontrolujte system prompt (Pravidla chování) — obsahuje anti-halucinaci?
• Zkontrolujte že FAQ opravdu obsahuje relevantní info
• Zpřísněte system prompt — přidejte konkrétní zákaz („NIKDY nevymýšlej seznam funkcí — cituj pouze z KONTEXTu")

Peek bubble se neukazuje

• V dashboardu je zaškrtnutý checkbox a vyplněný text?
• Cache prohlížeče — F5 v incognito
• Widget-config endpoint má TTL 60 s — po změně počkat minutu
• Zkontrolovat že snippet nemá data-pf-peek-* atributy (přebijí dashboard nastavení)

Chatbot je pomalý (>5 s na odpověď)

Standardní odpověď: 2–4 sekundy. Pomalejší = velká knowledge base + první dotaz po pauze (cache warmup). Pokud trvale >10 s, ping support.

Kontakt

Podpora pro pilotní klienty

Email: profesore@profesore.ai · Telefon: +420 603 417 312 · Odpověď obvykle do 24 hodin (pracovní dny 9–17).

Feedback

Nejcennější věc kterou nám můžete dát. Email: profesore@profesore.ai s předmětem Feedback. Zajímá nás:

• Co ve vašem workflow chybělo v návodu?
• Kde jste narazili nebo museli hádat?
• Co chatbot dělá špatně a nevíte jak to opravit?
• Co dělá pěkně?

Nebezpečné situace (klíč unikl, incident)

Email: profesore@profesore.ai s předmětem URGENT — [popis] · Odpověď do 4 hodin.