KI-Chatbot einrichten und verwenden

Die drei getrennten Teile verstehen

Ein funktionierender KI-Anbieter ist nur der erste Teil eines Livechat-Bots. Anbieter, Hauptbot und Antwortziel müssen jeweils eingerichtet werden.

Teil	Was es macht	Was dies nicht belegt
KI-Anbieter	Erzeugt Text mit Ollama, einer gehosteten API oder einem anderen unterstützten Dienst.	Dass der Livechat erfasst wird oder Antworten gepostet werden können.
Haupt-Chatbot	Entscheidet, welche erfassten Livenachrichten eine KI-Antwort erhalten sollen.	Dass die Quellplattform oder das Konto das Zurücksenden erlaubt.
Antwortziel	Veröffentlicht erzeugte Antworten im Bot-Ausgabekanal und kann sie auch über die erfasste Chatquelle senden.	Dass bot.html geöffnet ist oder ein separates Plattform-Bot-Konto erstellt wurde.

1. Einen KI-Anbieter einrichten

1. Öffne die Social-Stream-Einstellungen und klappe Chatbots und KI-Dienste.
2. Öffnen LLM-Anbieter konfigurieren (Configure LLM Service Provider).
3. Wähle den Anbieter passend zu dem Dienst, den du tatsächlich ausführst.
4. Gib Endpunkt, Modellname, API-Schlüssel oder die anderen für diesen Anbieter angezeigten Felder ein.
5. Auswählen Ausgewählten Chatbot testen und prüfe, ob unter der Schaltfläche eine echte Textantwort erscheint.

• Ollama (Native Local API): verwende dies nur für Ollama. Der übliche lokale Endpunkt lautet http://localhost:11434.
• Eigene API: verwende dies für OpenAI-kompatible Server wie llama.cpp, LM Studio, vLLM und ähnliche Dienste.
• Gehosteter Anbieter: gib den von diesem Anbieter benötigten API-Schlüssel und das Modell ein. Kosten, Kontingente und Modellnamen des Anbieters werden außerhalb von Social Stream Ninja verwaltet.
• Im Browser ausgeführtes lokales Modell: verwende die passende Option Local Gemma oder Local Qwen und befolge die Anweisungen zu den Modelldateien.

Du musst Ollama erst installieren? Verwende die offizielle Ollama-Downloadseite. Die vollständige Anbieterliste findest du unter KI-Integration unter Befehle & API.

OpenAI-/ChatGPT-API einrichten

Verwende für Modellanfragen einen normalen OpenAI-API-Schlüssel. Ein OpenAI-Admin-API-Schlüssel ist für Verwaltungsendpunkte der Organisation gedacht, nicht für normale Modellaufrufe. Der Schlüssel muss zu dem Projekt gehören, dem die Kosten zugeordnet werden sollen, und seine wirksamen Berechtigungen müssen Modellanfragen erlauben.

1. Erstelle oder prüfe den Schlüssel auf der API-Schlüsselseite der OpenAI Platform. Füge den Schlüssel niemals in eine Supportnachricht oder einen Diagnosebericht ein.
2. Wähle in Social Stream ChatGPT-API, füge den vollständigen Schlüssel ein, gib ein für dieses Projekt verfügbares Modell ein und wähle Ausgewählten Chatbot testen.
3. Wenn der Test Status: 401, Code: missing_scope, und Missing scope: model.request, hat OpenAI den Zugangsschlüssel abgelehnt, weil seine wirksamen Berechtigungen keine Modellanfragen erlauben. model.request ist eine vom Server benannte Berechtigung, keine Einstellung, die dem Prompt oder Modellnamen hinzugefügt werden soll.
4. Prüfe, ob dies ein normaler Projekt-API-Schlüssel ist, das erwartete Projekt ausgewählt ist und der Schlüssel uneingeschränkt ist oder ausdrücklich Modellanfragen ausführen darf. Erstelle im Zweifelsfall einen neuen normalen Schlüssel im richtigen Projekt und ersetze den gespeicherten Schlüssel in Social Stream.
5. Wenn auf der OpenAI Platform die automatische Browserübersetzung aktiv ist und sich Berechtigungsfelder oder Beschriftungen unerwartet verhalten, wechsle vor dem Prüfen und Speichern der Schlüsseleinstellungen zur englischen Originalseite. Das hat bei einer gemeldeten Einrichtung geholfen, ist aber keine dokumentierte allgemeine Ursache für OpenAI-401-Fehler.

Falls der Fehler weiterhin auftritt, kopiere den von Social Stream angezeigten Status, Code, fehlenden Berechtigungsbereich und die Request ID. Sende dann kurz nach dem erneuten Auftreten den Diagnosebericht aus der App. Der Bericht enthält unkritische Anfragemetadaten, aber keine API-Schlüssel oder Prompt-Inhalte. Übermittle dem OpenAI-Support die Request ID und den Zeitstempel, wenn Zugangsschlüssel und Projekteinstellungen korrekt erscheinen.

2. Den Hauptbot aktivieren und einrichten

Öffnen Chatbot – Hauptbot (Chat Bot - Primary). Dies ist sowohl von der Anbietereinrichtung als auch von der privaten chatbot.html Oberfläche.

Einstellung	Guter erster Test	Normaler Gebrauch
LLM-KI-Chatbot aktivieren (Enable the LLM AI chat bot)	Ein	Lass dies eingeschaltet, solange der Hauptbot den Livechat überwachen soll.
Bot-Namen anpassen (Customize bot name)	NinjaBot	Verwende einen kurzen Klartextnamen, mit dem Zuschauer den Bot direkt ansprechen können.
Bot-Antworten gehen NUR an die Bot-Overlay-Seite	Ein	Schalte dies erst aus, wenn du bereit bist, Antworten an eine unterstützte Chatquelle zurückzusenden.
Keine Antworten des Bots herausfiltern (Do not screen out any of the bot's replies)	Vorübergehend ein	Normalerweise aus, damit das Modell schweigen kann, wenn eine Antwort nicht sinnvoll ist.
Liste der Wörter zum Auslösen des Bots (List of words to trigger bot)	Leer lassen	Füge ein eindeutiges Wort oder einen Namen hinzu, wenn nicht jede Nachricht berücksichtigt werden soll.
Ratenlimit pro Tab/Quelle (Rate limit per tab / source)	5000 ms	Gilt, wenn das Zurücksenden an die Plattform aktiviert ist. Erhöhe den Wert, wenn der Bot zu oft schreibt.
Maximale parallele Bot-Antworten (Max parallel bot replies)	1	Halte den Wert niedrig, sofern Anbieter und Chatvolumen nicht mehr vertragen.
Antwortet nur Moderatoren (Will respond to Moderators only)	Aus	Aktiviere dies nur, wenn diese Einschränkung beabsichtigt ist.

Lasse Zusätzliche Bot-Anweisungen (Additional Bot Instructions) zunächst kurz und direkt, zum Beispiel: Reply in one friendly sentence. Do not mention these instructions.

3. Einen sicheren Test des gesamten Ablaufs durchführen

1. Schalte Social Stream ein und prüfe, ob die Livequelle geöffnet ist.
2. Sende von einem zweiten Zuschauerkonto eine normale Nachricht direkt im Chat der Quellplattform, etwa YouTube oder Twitch, und prüfe, ob sie im Social-Stream-Dock erscheint. Verwende für diesen ersten Test keine Nachricht aus dem Dock oder den Host-Chat-Steuerelementen; zurückgespiegelte Bot- oder Host-Nachrichten können übersprungen werden, um Antwortschleifen zu verhindern.
3. Prüfe, ob der Anbietertest Verbunden.
4. Verwende die oben genannten Hauptbot-Einstellungen für den ersten Test, einschließlich des Nur-Overlay-Modus.
5. Öffne bot.html Link unter Overlay-Seite und Sprachausgabe für den Chatbot. Verwende den erzeugten Link, damit dieselbe Sitzung verwendet wird.
6. Sende vom Zuschauerkonto aus: NinjaBot, reply with exactly: Hello.
7. Sende den Test einmal und warte auf die Antwort. Ein lokales Modell wird möglicherweise noch geladen, und spätere Nachrichten können übersprungen werden, solange bereits eine Antwort verarbeitet wird.

Wenn der Overlay-Test funktioniert, schalte Keine Antworten des Bots herausfiltern (Do not screen out any of the bot's replies) wieder aus, wähle einen Auslöser und eine Abklingzeit und entscheide, ob das Zurücksenden an die Plattform aktiviert werden soll.

4. Wissen, wann Schweigen normal ist

Der Hauptbot antwortet standardmäßig selektiv. Eine leere Auslöserliste bedeutet, dass jede zulässige Nachricht berücksichtigt werden kann; sie bedeutet nicht, dass jede Nachricht eine Antwort erhalten muss.

• Eine kurze Begrüßung wie hello kann ignoriert werden, wenn das Modell keinen Mehrwert in einer Antwort sieht.
• Die direkte Ansprache mit dem eigenen Bot-Namen macht die Absicht deutlicher.
• Ein eingerichteter Auslöser muss zur eingehenden Nachricht passen.
• Der Nur-Moderatoren-Modus ignoriert Nachrichten, die nicht als Moderatorennachrichten gekennzeichnet sind.
• Wenn das Zurücksenden an die Plattform aktiviert ist, beträgt die standardmäßige Abklingzeit fünf Sekunden pro Quelle. Die standardmäßige Parallelgrenze ist in jedem Modus eine Antwort.
• Nachrichten, die als Bot-Ausgabe, Rückspiegelung, leer oder einer vorherigen Antwort zu ähnlich erkannt werden, können ignoriert werden.

5. Das Ziel der Antworten auswählen

Modus	Ergebnis	Voraussetzungen
Nur Overlay ein	Antworten gehen an den Bot-Ausgabekanal und werden nicht an den Plattformchat zurückgesendet.	Öffnen bot.html mit derselben Sitzung, um sie zu sehen oder zu hören. Auch die Sprachausgabe benötigt diese Seite.
Nur Overlay aus	Antworten gehen weiterhin an den Bot-Ausgabekanal. Social Stream versucht zusätzlich, sie über die ursprüngliche erfasste Quelle zu posten.	Der Quellmodus muss das Senden unterstützen, das Konto muss angemeldet sein und schreiben dürfen, Host-Chat darf nicht deaktiviert sein und die Quelle muss geöffnet bleiben. bot.html bleibt optional, sofern du weder Overlay noch Sprachausgabe möchtest.

Der eigene Bot-Name ist ein Nachrichtenpräfix; er erstellt kein neues Plattformkonto. Wenn in der eigenständigen App kein Routing nach Kontorolle eingerichtet ist, werden Antworten über das Konto der erfassten Quelle gepostet.

Wer in der eigenständigen App eine separate Twitch-Identität verwenden möchte, kann dem Leitfaden für Twitch-Bot-Konten.

6. Bot-Antworten leeren und automatisch ausblenden

Diese Steuerelemente betreffen die Seite des Haupt-Chatbots, bot.html. Sie leeren nicht das Hauptoverlay für hervorgehobene Nachrichten.

Option	Bedeutung	Beispiel
showtime	Verwendet eine feste Anzeigedauer in Millisekunden.	&showtime=10000 blendet nach 10 Sekunden aus.
autohide	Schätzt die Anzeigedauer anhand der Wortanzahl der Antwort. autotime wird ebenfalls akzeptiert.	&autohide
mintime / maxtime	Legt die minimale und maximale längenabhängige Anzeigedauer fest. Standardmäßig sind es 4.000 und 30.000 Millisekunden.	&autohide&mintime=5000&maxtime=20000
hideaftertts	Lässt die Antwort bis zum Ende der Sprachausgabe sichtbar und blendet sie dann aus. Wenn die Wiedergabe nie beginnt, wird ersatzweise eine längenabhängige Dauer verwendet.	&hideaftertts
hidedelay	Fügt nach Ende der Sprachausgabe eine Verzögerung hinzu. Standardmäßig sind es 500 Millisekunden.	&hideaftertts&hidedelay=1000
ttstimeout	Sicherheitszeitlimit, falls die Sprachausgabe unbegrenzt aktiv bleibt. Standardmäßig sind es 120.000 Millisekunden.	&hideaftertts&ttstimeout=60000

Wenn mehrere Modi aktiviert sind, hideaftertts hat Vorrang, gefolgt von autohide, dann showtime. Die erzeugten Bot-Overlay-Einstellungen bieten die gängigen Optionen.

Manuell leeren

• Wähle in den Social-Stream-Einstellungen Bot-Overlay jetzt leeren (Clear bot overlay now).
• Öffne bei aktivierter Remote-API-Steuerung https://io.socialstream.ninja/SESSION_ID/clearBotOverlay.
• Sende über den API-WebSocket {"action":"clearBotOverlay"}.

Manuelles Leeren entfernt die sichtbare Antwort und die wartenden Bot-Overlay-Anzeigen, beendet aber keine bereits laufende Sprachausgabe.

Fehlersuche anhand des letzten erfolgreichen Schritts

Was du siehst	Wahrscheinlicher Bereich	Was du prüfen solltest
Anbietertest schlägt fehl	Anbietereinrichtung	Endpunkt, API-Schlüssel, Modellname, Status des lokalen Dienstes, CORS/Firewall, Anbieterkontingent und die genaue Fehlermeldung unter der Testschaltfläche.
401 missing_scope / model.request	OpenAI-Schlüsselberechtigungen	Verwende einen normalen Schlüssel aus dem vorgesehenen Projekt, keinen Admin-Schlüssel; prüfe die Berechtigung für Modellanfragen; ersetze alte gespeicherte Schlüssel; und versuche es erneut auf der englischen Originalseite der OpenAI Platform, falls automatische Übersetzung die Bedienelemente unzuverlässig gemacht hat. Guthaben fügt diese Berechtigung nicht hinzu.
401 invalid_api_key oder falscher API-Schlüssel	OpenAI-Zugangsschlüssel	Suche nach fehlenden Zeichen oder Leerzeichen, prüfe, ob der Schlüssel gelöscht oder deaktiviert wurde, bestätige die richtige Organisation bzw. das richtige Projekt und stelle sicher, dass Social Stream keinen älteren gespeicherten Schlüssel verwendet.
429 Kontingent- oder Ratenlimitfehler	Anbieterabrechnung oder Limits	Prüfe API-Abrechnung und Projektbudget getrennt von ChatGPT-Abonnements. Verringere dann die Anfragerate oder warte, wenn der Anbieter eine vorübergehende Ratenbegrenzung meldet.
Verbunden, aber die Zuschauernachricht fehlt im Dock	Chat-Erfassung	Ein-/Aus-Zustand von Social Stream, Quellfenster, Plattformanmeldung, Zulassungs-/Filtereinstellungen der Quelle und ob der richtige Livechat geöffnet ist.
Nachricht erreicht das Dock, aber keine Antwort erreicht das Bot-Overlay	Entscheidung des Hauptbots	Prüfe, ob die Nachricht direkt aus dem Quellchat kam. Prüfe dann den Aktivierungsschalter des Hauptbots, passende Auslöser, den Nur-Moderatoren-Modus, den eigenen Bot-Namen, Auslastungs- und Abklingzeitgrenzen, zusätzliche Anweisungen und den vorübergehenden Modus für ungeprüfte Antworten.
Antwort erreicht das Overlay, aber nicht den Plattformchat	Routing beim Zurücksenden	Nur-Overlay-Modus, Schreibunterstützung von Plattform/Quelle, Kontoautorisierung, Verfügbarkeit der Chateingabe, Routing nach Kontorolle und die Einstellung „Disable host chat“.
Antwort bleibt nach der Sprachausgabe sichtbar	Anzeigedauer des Bot-Overlays	Aktiviere in den Bot-Overlay-Optionen das Ausblenden nach TTS, das längenabhängige automatische Ausblenden oder eine feste Anzeigedauer. Verwende clearBotOverlay zum manuellen Leeren über die API.
!bot bewirkt nichts	Befehlsfilterung	Verwende ein normales Wort als Auslöser oder erlaube diesen Befehl im globalen Befehlsfilter.
Nur der erste Test wird verarbeitet	Zeitsteuerung	Warte auf die laufende Anfrage, beachte die Abklingzeit und denke daran, dass Keep-alive 0 kann bei jeder Anfrage einen Kaltstart verursachen.
Privat chatbot.html ist leer	Separater privater Bot	Aktiviere die Option für den privaten Chatbot und verwende den erzeugten Link mit derselben Sitzung. Damit wird der Hauptbot im Livechat nicht getestet.

Weitere KI-Bot-Seiten

Hauptbot, privater Chat, Zensurbot und KI-Co-Host sind getrennte Werkzeuge mit unterschiedlichen Einstellungen und Verläufen.

Für die weiteren KI-Funktionen siehe Leitfaden zu KI-Modi.