Komiksová bublina

Komiksová bublina u avatarů

← Kapitola 7: Administrace a konfigurace

Komiksová bublina zobrazí nad avatarem textový obsah, který návštěvník výslovně požaduje – srovnání cen, seznamy, krátké tabulky, informace z webu. Asistent současně krátce promluví (1–2 věty); podrobnosti jsou v bublině. Funguje na všech variantách exponátu se postavou: základní SVG, Rive, Live2D a D-ID.

Zapnutí v administraci

Otevřete webovou administraci exponátu → sekce Bublina & hledání (v levém menu pod „Hlas“). Po uložení se nastavení zapíše do config.

Chování pro návštěvníka

1. Návštěvník klepne na start a mluví otázku (stejně jako u běžného chatu).
2. Exponát rozpozná řeč a pošle dotaz na server.
3. Pokud dotaz spadá do režimu bubliny, server vrátí krátkou větu pro hlas + text do bubliny.
4. Bublina se vysune nad avatarem (komiksový styl, ocásek směrem k postavě).
5. Asistent přečte krátkou odpověď hlasem (TTS) – stejný hlas jako u běžných otázek.
6. Když návštěvník položí další otázku, předchozí bublina zmizí.

Rozdíl oproti textovému chatu

Na kiosku je výchozí režim hlasový (show_chat: false) – konverzace se nezobrazuje v panelu. Bublina je jednorázový vizuální doplněk nad avatarem, ne scroll historie chatu. Viz kapitola Monitor – koncept.

Grafické ukázky

Níže jsou statické náhledy, jak bublina vypadá nad avatarem v provozu – včetně překryvu tváře postavy, stejně jako na kiosku. Šířka až 620 px, výška až téměř celá obrazovka nad tlačítkem startu; text je běžným písmem bez tučného řezu a bez scrollování (kiosk se ovládá jen hlasem). Ve výchozím režimu (bubble_allow_links: false) se URL z textu odstraní; poslední ukázka ukazuje vzhled s odkazy pro interní nebo důvěryhodné kiosky.

Bublina zmizí při další otázce. Na kiosku využívá maximum volného místa nad avatarem a může překrývat horní část postavy – návštěvník nemusí nic rolovat. Barvy vycházejí z motivu kiosku, viz barevné motivy.

Vyhledávání přes Gemini (Google Search grounding)

S zapnutým vyhledáváním Gemini u dotazů s bublinou prohledá web a složí odpověď z aktuálních výsledků. Nepoužívá se scraping Seznam.cz ani Google v prohlížeči – jde o oficiální Grounding with Google Search v rámci Gemini API.

• Vyžaduje poskytovatele Gemini a placený tarif v administraci.
• U typického kiosku (desítky dotazů s bublinou denně) grounding obvykle spadne do free limitu Google – viz náklady bubliny u Gemini.
• ChatGPT (OpenAI): bublina funguje, ale bez webového grounding – odpověď jen z modelu.

Katalog exponátů (MySQL znalostní báze)

Když je zapnutá znalostní báze a v MySQL existuje katalog, chat může načíst konkrétní exponát a do bubliny vložit sloupec descriptionAI (delší HTML popis). Krátký text pro TTS je v ai_short_desc. Model volá nástroje exhibit_get, exhibit_search, exhibit_list – nehádá fakta z tréninku.

Typické dotazy: „Co je to za exponát?“, „Řekni mi víc o mamutu“, „Co je v tomto sále?“. Nastavení MySQL, tabulky a generování textů: kapitola Znalostní báze exponátů.

Barvy a vzhled bubliny

Bublina automaticky používá barvy z motivu exponátu – stejné CSS proměnné jako zbytek kiosku (--bg-card, --text, --accent). Nastavíte je v administraci v sekci Barvy & motiv – podrobně v kapitole Barvy a motiv. Samotné barvy API nezpoplatňují.

• Pozadí bubliny = barva panelů (bg_card)
• Text = hlavní barva textu (text), běžný řez (ne tučně)
• Obrys a stín = akcent motivu (accent)
• Odkazy (pokud povoleny) = barva akcentu
• Velikost: šířka až 620 px, výška podle obsahu až ~720 px – bez vnitřního scrollu, vhodné pro kiosk

Pole v configu

{
    "bubble_enabled": true,
    "bubble_allow_links": false,
    "bubble_search_enabled": true,
    "bubble_search_when": "when_asked"
}

Výchozí hodnoty po instalaci: vše vypnuto kromě režimu when_asked. Po změně v adminu vždy obnovte stránku exposátu (F5), aby frontend načetl novou konfiguraci ze serveru.

Náklady a testování

• Odhad nákladů bubliny podle scénářů provozu (10 h / den)
• Gemini – tokeny a grounding
• Reálná čísla po testu: administrace → Využití API & kredity