7 Administrace a konfigurace
Vše se ukládá do config.json přes webové rozhraní administrace.
Po uložení proběhne přesměrování (bez opakovaného odeslání formuláře).
Všechny tři varianty exponátu (základní SVG, Rive, D-ID) čtou stejnou konfiguraci.
| Sekce v adminu | Co nastavíte |
|---|---|
| Využití API & kredity | Statistiky dnes/měsíc, stav klíčů Gemini/OpenAI/D-ID, poslední požadavky, odhad USD. Plánovací odhad nákladů → |
| Provozní profil | Doporučená nastavení pro mládež, muzeum, firmu, veletrh nebo domácí demo – system prompt, bublina, styl omluv, testovací režim. návod k profilům, nevhodný obsah a filtry AI |
| AI & API | Poskytovatel (Gemini / ChatGPT), API klíče, modely, tarif free/placený, OpenAI varianta (Instant / Thinking) – viz návod k nastavení Gemini |
| Exponát | Nadpisy, uvítání, system prompt, sada omluv při chybě, testovací režim. Texty zadávejte v češtině – překlad pro návštěvníka řeší přepínač jazyků na kiosku. |
| Hlas | TTS engine, hlas, voice_lang (výchozí/API TTS), barge-in, nepřetržité poslouchání, rychlost odpovědi.
Jazyk STT na kiosku řídí spíše vlajky CS/EN/DE/PL/SK. |
| Bublina & hledání | Komiksová bublina nad avatarem, volitelné vyhledávání Gemini, odkazy v bublině – návod k použití, náklady |
| Nečinnost | Timeout bez interakce, volitelná idle prezentace webových stránek; při vypnuté prezentaci návrat na „Klepněte pro start“ |
| Avatary | Rive (.riv, animace) a D-ID (klíč, fotka, hlas Microsoft TTS) |
| Barvy & motiv | Jednotný vzhled všech variant exponátu – přehled motivů |
| Bezpečnost | Heslo do administrace |
Výběr AI poskytovatele
- Gemini – pole
api_key, modelymodel_free/model_paid - ChatGPT (OpenAI) – pole
openai_api_key, varianty modelu v administraci - Oba klíče můžete mít uložené; aktivní je jen ten podle
ai_provider - Chat i TTS směruje podle zvoleného poskytovatele (u D-ID včetně video vrstvy)
Režim nečinnosti (idle)
Sekce Nečinnost v administraci řídí, co exponát udělá po určité době
bez dotyku a bez nové otázky. Společný parametr je
idle_timeout_seconds (v adminu „Nečinnost před startem“, výchozí 120 s).
Podle toho, zda je zapnutá idle prezentace, se chování liší – viz tabulka níže.
Funguje na všech variantách exponátu (základní SVG, Rive, Live2D, D-ID).
idle_mode_enabled |
Po timeoutu bez interakce | Typický provoz |
|---|---|---|
| Vypnuto (checkbox nezaškrtnutý) | Návrat na obrazovku „Klepněte pro start“ – mikrofon se vypne, historie chatu se vymaže, avatar čeká v klidu. Další návštěvník klepne a začne nová relace (uvítání, volba jazyka vlajkami). | Recepce, veletrh, kiosk s rychlým střídáním lidí – každý začíná od startu |
| Zapnuto (idle prezentace) | Automatické procházení seznamu webových stránek – u každé stránky AI složí krátký monolog a avatar ho přečte. Klepnutí nebo mluvení režim ukončí a vrátí běžný dialog. | Muzeum, areál, dlouhodobý provoz – orientace i když nikdo neklade dotaz |
Společné nastavení (oba režimy)
- Timeout –
idle_timeout_seconds: počet sekund od poslední interakce (klepnutí, klávesa, odeslaná otázka). Během mluvení AI nebo čekání na odpověď se odpočet pozastaví. - Interakce – resetuje odpočet; při zapnuté idle prezentaci také ukončí právě běžící monolog.
Idle prezentace zapnutá (idle_mode_enabled)
Volitelná funkce pro dlouhodobý provoz: exponát sám prochází stránky ze seznamu v administraci. U každé stránky server načte obsah, AI z něj složí krátký projev (2–4 věty) a avatar ho přečte hlasem.
- Seznam stránek – řádky ve tvaru
Název atrakce|https://váš-web.cz/…(idle_pages); stránky se střídají v pořadí - Povolené domény – server stahuje jen hostitele odvozené z vašich URL (
idle_allowed_hosts) - Extrakce z HTML – titulek, meta popis, otevírací doba, stav otevřeno/zavřeno, zajímavosti z textu stránky
- AI monolog – krátký projev ve zvoleném stylu; při výpadku AI záložní text ze stránky (hlas prohlížeče)
- Pauza mezi stránkami –
idle_page_seconds(výchozí 12 s) - Obrazovka – bez overlay; ve stavovém řádku název aktuální atrakce, hlavní kanál je hlas
- Ukončení idle – klepnutí, klávesa nebo mluvení (alespoň 3 znaky) okamžitě vrátí běžný dialog
- Styl mluvení – teen slang, klasický tón, nebo stejný jako omluvy při chybě (
idle_phrase_set); volitelně vlastní system prompt (idle_narrator_prompt) - Varianta D-ID – idle používá běžné TTS, ne generování D-ID videa (úspora kreditů a času)
Idle prezentace vypnutá
Checkbox „Zapnout režim nečinnosti (idle prezentace)“ nechte prázdný.
Po uplynutí idle_timeout_seconds bez interakce se exponát chová jako na začátku dne:
- Znovu se zobrazí overlay „Klepněte pro start“ (v jazyce zvolené vlajky – viz Jazyk exponátu)
- Mikrofon a aktivní dialog se ukončí, historie chatu se smaže
- Avatar přejde do klidového stavu (Rive/Live2D: animace idle)
- Nepotřebujete vyplňovat
idle_pages– seznam stránek se v tomto režimu nepoužívá
Doporučení: pro profily Mládež nebo domácí demo často necháváme idle vypnutý; pro Muzeum nebo veletrh s vlastním webem idle zapnutý.
Náklady na TTS při dlouhém idle provozu (jen při zapnuté prezentaci) viz Náklady provozu.