Nastavení a používání AI chatbota

Pochopte tři oddělené části

Fungující poskytovatel AI je jen první část bota živého chatu. Zvlášť je nutné nastavit poskytovatele, hlavního bota i cíl odpovědí.

Část	Co dělá	Co to nepotvrzuje
Poskytovatel AI	Generuje text pomocí Ollama, hostovaného API nebo jiné podporované služby.	Že se zachytává živý chat nebo že lze odesílat odpovědi.
Hlavní chatbot	Rozhoduje, které zachycené živé zprávy mají dostat odpověď AI.	Že zdrojová platforma nebo účet povoluje odpovídání.
Cíl odpovědi	Publikuje vytvořené odpovědi do výstupního kanálu bota a může je posílat i přes zachycený zdroj chatu.	Tento bot.html je otevřený nebo že byl vytvořen samostatný účet bota na platformě.

1. Nastavte poskytovatele AI

1. Otevřete nastavení Social Stream a rozbalte Chat Bots and AI services.
2. Otevřít Nastavit poskytovatele LLM (Configure LLM Service Provider).
3. Vyberte poskytovatele odpovídajícího službě, kterou skutečně provozujete.
4. Zadejte koncový bod, název modelu, klíč API nebo další zobrazená pole poskytovatele.
5. Vyberte Otestovat vybraného chatbota (Test selected chat bot) a ověřte, že se pod tlačítkem objeví skutečná textová odpověď.

• Ollama (nativní místní API): použijte pouze pro Ollama. Obvyklý místní koncový bod je http://localhost:11434.
• Custom API: použijte pro servery kompatibilní s OpenAI, například llama.cpp, LM Studio, vLLM a podobné služby.
• Hostovaný poskytovatel: zadejte klíč API a model požadovaný poskytovatelem. Náklady, kvóty a názvy modelů řídí poskytovatel mimo Social Stream Ninja.
• Místní model v prohlížeči: použijte odpovídající možnost Local Gemma nebo Local Qwen a dodržte pokyny k souborům modelu.

Potřebujete nejprve nainstalovat Ollama? Použijte oficiální stránku pro stažení Ollama. Úplný seznam poskytovatelů najdete v Integrace AI v příkazech a API.

Nastavení OpenAI / ChatGPT API

Pro požadavky na model použijte standardní klíč API OpenAI. Admin API key OpenAI je určen pro správu organizace, ne běžná volání modelů. Klíč musí patřit projektu, kterému chcete účtovat spotřebu, a jeho skutečná oprávnění musí povolovat požadavky na model.

1. Vytvořte nebo zkontrolujte klíč na stránce klíčů API OpenAI Platform. Klíč nikdy nevkládejte do zprávy podpoře ani do diagnostického hlášení.
2. V Social Stream vyberte ChatGPT API, vložte celý klíč, zadejte model dostupný danému projektu a vyberte Otestovat vybraného chatbota (Test selected chat bot).
3. Pokud test hlásí Status: 401, Code: missing_scope, a Missing scope: model.request, OpenAI odmítlo přihlašovací údaj, protože jeho skutečná oprávnění neumožňují požadavky na model. model.request je oprávnění pojmenované serverem, nikoli nastavení, které máte přidat do zadání nebo názvu modelu.
4. Ověřte, že jde o standardní projektový klíč API, je vybraný správný projekt a klíč není omezen nebo má výslovně povolené požadavky na model. Pokud si nejste jistí, vytvořte nový standardní klíč ve správném projektu a nahraďte uložený klíč v Social Stream.
5. Pokud je na OpenAI Platform aktivní automatický překlad prohlížeče a ovládání oprávnění nebo popisky se chovají nečekaně, před kontrolou a uložením nastavení klíče přepněte na původní anglickou stránku. Pomohlo to v jednom nahlášeném případě, ale nejde o zdokumentovanou univerzální příčinu chyb OpenAI 401.

Pokud chyba pokračuje, zkopírujte stav, kód, chybějící oprávnění a Request ID zobrazené Social Stream a krátce po zopakování chyby odešlete diagnostické hlášení z aplikace. Hlášení obsahuje bezpečná metadata požadavku, ale vynechává klíče API a obsah zadání. Pokud přihlašovací údaje a projekt vypadají správně, předejte podpoře OpenAI Request ID a časovou značku.

2. Zapněte a nastavte hlavního bota

Otevřít Chat Bot - Primary. Toto je oddělené od nastavení poskytovatele i soukromého chatbot.html rozhraní.

Nastavení	Dobrý první test	Běžné použití
Zapnout AI chatbota LLM (Enable the LLM AI chat bot)	Zapnuto (On)	Nechte zapnuté, pokud má hlavní bot sledovat živý chat.
Vlastní jméno bota (Customize bot name)	NinjaBot	Použijte krátké jméno v prostém textu, kterým mohou diváci bota přímo oslovit.
Odpovědi bota jdou POUZE na stránku překryvu bota	Zapnuto (On)	Vypněte až tehdy, když jste připraveni posílat odpovědi zpět do podporovaného zdroje chatu.
Nefiltrovat žádné odpovědi bota (Do not screen out any of the bot's replies)	Dočasně zapnuto	Obvykle vypnuto, aby model mohl mlčet, když odpověď není užitečná.
Seznam slov spouštějících bota (List of words to trigger bot)	Ponechte prázdné	Pokud se nemá posuzovat každá zpráva, přidejte jednoznačné slovo nebo jméno.
Omezení frekvence na kartu / zdroj	5000 ms	Platí při zapnutém odesílání zpět na platformu. Zvyšte hodnotu, pokud bot píše příliš často.
Maximální souběžné odpovědi bota (Max parallel bot replies)	1	Ponechte nízkou hodnotu, pokud poskytovatel a objem chatu nezvládnou více.
Odpovídat pouze moderátorům (Will respond to Moderators only)	Vypnuto	Zapněte pouze tehdy, je-li toto omezení záměrné.

Ponechte Další pokyny pro bota (Additional Bot Instructions) zpočátku krátké a přímé, například: Reply in one friendly sentence. Do not mention these instructions.

3. Proveďte bezpečný test celého průchodu

1. Zapněte Social Stream a ověřte, že je živý zdroj otevřený.
2. Pošlete běžnou zprávu z druhého účtu diváka přímo v chatu zdrojové platformy, například YouTube nebo Twitch, a ověřte její zobrazení v doku Social Stream. Pro první test nepoužívejte zprávu napsanou do doku nebo ovládání chatu hostitele; zpětně zachycené zprávy bota nebo hostitele se mohou přeskočit, aby nevznikla smyčka odpovědí.
3. Ověřte, že test poskytovatele hlásí Připojeno (Connected).
4. Použijte výše uvedené nastavení hlavního bota pro první test včetně režimu pouze překryvu.
5. Otevřete bot.html odkaz zobrazený pod Stránka překryvu a TTS chatbota. Použijte vygenerovaný odkaz, aby měl stejnou relaci.
6. Z účtu diváka pošlete: NinjaBot, reply with exactly: Hello.
7. Pošlete test jednou a počkejte na odpověď. Místní model se může stále načítat a další zprávy se mohou přeskočit, pokud už jedna odpověď běží.

Až test překryvu funguje, přepněte Nefiltrovat žádné odpovědi bota (Do not screen out any of the bot's replies) znovu vypněte, vyberte spouštěč a prodlevu a rozhodněte, zda povolit odpovědi na platformu.

4. Rozpoznejte, kdy je mlčení normální

Hlavní bot je ve výchozím stavu výběrový. Prázdný seznam spouštěčů znamená, že lze posoudit každou vhodnou zprávu; neznamená, že každá musí dostat odpověď.

• Krátký pozdrav, například hello může být ignorován, pokud model nepovažuje odpověď za přínosnou.
• Přímé oslovení vlastním jménem bota dává záměr jasněji najevo.
• Nastavený spouštěč se musí shodovat s příchozí zprávou.
• Režim pouze pro moderátory ignoruje zprávy, které nejsou označené jako zprávy moderátora.
• Při zapnutém odpovídání na platformu je výchozí prodleva pět sekund na zdroj. Výchozí limit souběhu je jedna odpověď ve všech režimech.
• Zprávy rozpoznané jako výstup bota, zpětně zachycené, prázdné nebo příliš podobné předchozí odpovědi mohou být ignorovány.

5. Vyberte, kam mají odpovědi chodit

Režim	Výsledek	Požadavky
Pouze překryv zapnuto	Odpovědi jdou do výstupního kanálu bota a neposílají se zpět do chatu platformy.	Otevřít bot.html se stejnou relací, abyste je viděli nebo slyšeli. TTS také vyžaduje tuto stránku.
Pouze překryv vypnuto	Odpovědi stále jdou do výstupního kanálu bota a Social Stream se navíc pokusí odeslat je přes původní zachycený zdroj.	Režim zdroje musí podporovat odesílání, účet musí být přihlášený a smět psát, chat hostitele nesmí být vypnutý a zdroj musí zůstat otevřený. bot.html zůstává volitelné, pokud nechcete překryv nebo TTS.

Vlastní jméno bota je předpona zprávy; nevytváří nový účet platformy. Pokud není nastavené směrování rolí účtů samostatné aplikace, odpovědi se posílají účtem používaným zachyceným zdrojem.

Uživatelé samostatné aplikace, kteří chtějí oddělenou identitu Twitch, mohou postupovat podle průvodce účtem bota Twitch.

6. Mazání a automatické skrývání odpovědí bota

Tyto ovládací prvky ovlivňují stránku hlavního chatbota, bot.html. Hlavní překryv vybraných zpráv nemažou.

Možnost	Význam	Příklad
showtime	Používá jednu pevnou dobu zobrazení v milisekundách.	&showtime=10000 skryje po 10 sekundách.
autohide	Odhaduje dobu zobrazení podle počtu slov odpovědi. autotime je také přijímáno.	&autohide
mintime / maxtime	Nastavuje minimální a maximální dobu zobrazení podle délky. Výchozí hodnoty jsou 4 000 a 30 000 milisekund.	&autohide&mintime=5000&maxtime=20000
hideaftertts	Udržuje odpověď viditelnou do dokončení TTS a pak ji skryje. Pokud přehrávání nezačne, použije se náhradní doba podle délky.	&hideaftertts
hidedelay	Přidává prodlevu po skončení TTS. Výchozí hodnota je 500 milisekund.	&hideaftertts&hidedelay=1000
ttstimeout	Bezpečnostní časový limit, pokud TTS zůstane aktivní neomezeně. Výchozí hodnota je 120 000 milisekund.	&hideaftertts&ttstimeout=60000

Pokud je zapnuto více režimů, hideaftertts má přednost, poté autohide, potom showtime. Vygenerované nastavení překryvu bota obsahuje běžné možnosti.

Ruční vymazání

• V nastavení Social Stream vyberte Vymazat překryv bota nyní (Clear bot overlay now).
• Se zapnutým Remote API Control otevřete https://io.socialstream.ninja/SESSION_ID/clearBotOverlay.
• Přes API WebSocket pošlete {"action":"clearBotOverlay"}.

Ruční vymazání odstraní viditelnou odpověď i čekající frontu zobrazení překryvu bota, ale nezastaví již přehrávanou řeč.

Řešte potíže podle posledního fungujícího kroku

Co vidíte	Pravděpodobná oblast	Co zkontrolovat
Test poskytovatele selže	Nastavení poskytovatele	Koncový bod, klíč API, název modelu, stav místní služby, CORS/firewall, kvóta poskytovatele a přesná chyba pod tlačítkem testu.
401 missing_scope / model.request	Oprávnění klíče OpenAI	Použijte standardní klíč požadovaného projektu, ne klíč Admin; ověřte povolení požadavků na model, nahraďte starý uložený klíč a pokud automatický překlad narušil ovládání, zkuste znovu původní anglickou stránku OpenAI Platform. Kredit toto oprávnění nepřidává.
401 invalid_api_key nebo nesprávný klíč API	Přihlašovací údaj OpenAI	Zkontrolujte chybějící znak nebo mezeru, ověřte, že klíč nebyl smazán či deaktivován, ověřte správnou organizaci/projekt a že Social Stream nepoužívá starší uložený klíč.
429 chyba kvóty nebo omezení frekvence	Účtování nebo limity poskytovatele	Ověřte účtování API a rozpočet projektu odděleně od předplatného ChatGPT; pokud poskytovatel hlásí dočasné omezení frekvence, snižte počet požadavků nebo počkejte.
Připojeno, ale zpráva diváka chybí v doku	Zachytávání chatu	Zapnutí Social Stream, okno zdroje, přihlášení k platformě, povolení/filtry zdroje a otevření správného živého chatu.
Zpráva dorazí do doku, ale odpověď ne do překryvu bota	Rozhodování hlavního bota	Ověřte, že zpráva přišla přímo ze zdrojového chatu, a pak zkontrolujte zapnutí hlavního bota, shodu spouštěče, režim pouze pro moderátory, vlastní jméno bota, omezení souběhu/prodlev, dodatečné pokyny a dočasný režim nefiltrovaných odpovědí.
Odpověď dorazí do překryvu, ale ne do chatu platformy	Směrování odesílání zpět	Režim pouze překryvu, podpora zápisu platformy/zdroje, autorizace účtu, dostupnost vstupu chatu, směrování rolí účtů a nastavení Disable host chat.
Odpověď zůstává viditelná po TTS	Časování překryvu bota	V možnostech překryvu bota zapněte Hide after TTS, automatické skrytí podle délky nebo pevnou dobu zobrazení. Použijte clearBotOverlay pro ruční vymazání přes API.
!bot nic nedělá	Filtrování příkazů	Použijte spouštěč v podobě běžného slova nebo povolte daný příkaz v globálním filtru příkazů.
Zpracuje se pouze první test	Časování	Počkejte na aktivní požadavek, dodržte prodlevu a pamatujte, že uchování modelu 0 může způsobit opětovné načítání modelu při každém požadavku.
Soukromý chatbot.html je prázdné	Samostatný soukromý bot	Zapněte soukromého chatbota a použijte vygenerovaný odkaz se stejnou relací. Toto netestuje hlavního živého bota.

Další stránky AI botů

Hlavní bot, soukromý chat, cenzurní bot a AI spolumoderátor jsou samostatné nástroje s různým nastavením a historií.

Širší nabídku funkcí AI najdete v Průvodce režimy AI.