KI-Companion – Einrichtung

Diese Seite erklärt, wie du den KI-Companion einschaltest, wie das KI-Guthaben funktioniert und wo du siehst, was er kostet. Was der Companion ist und wie er sich verhält, liest du am besten zuerst im KI-Companion – Konzept.

Einzurichten gibt es nichts: keinen Anbieter, keinen API-Schlüssel, keine Modellwahl. dzbot betreibt den Companion für dich und rechnet die Nutzung über das KI-Guthaben deiner Organisation ab.

Einschalten

Der Companion erscheint nur bei Benutzern mit dem Zugriffsrecht KI-Companion (es liegt in der Tickets-Gruppe der Admin-Rechte, als tickets.ai_companion). Gib es den Gruppen, deren Mitglieder den Companion nutzen sollen:

• Server Admin → Gruppen → Gruppe auswählen → KI-Companion aktivieren.

Wer in einer Gruppe mit diesem Recht ist, sieht den KI-Companion-Button im Admin-Header (das Funkel-Symbol oben rechts). Benutzer ohne das Recht sehen ihn nie.

In Discord steht /ai bei jedem Mitglied des Servers in der Befehlsliste, ohne dass du eine Discord-Rolle oder Integrations-Einstellung anlegen musst. Der Bot prüft beim Benutzen dasselbe Recht und weist alle anderen ab.

Wie Zugriffsrechte und Gruppen allgemein funktionieren, steht in Zugriffssteuerung.

Optional: eigene Anweisungen

Du kannst dem Companion zusätzliche Vorgaben zu Tonfall, Formulierung oder Richtlinien mitgeben, die für jede Unterhaltung deiner Organisation gelten – im Feld KI-Companion-Anweisungen in den Organisationseinstellungen unter Integrationen. Die Anweisungen verfeinern das Verhalten des Companions, setzen aber nie seine Grundregeln außer Kraft: Er handelt weiterhin nur mit den Rechten der Person, die ihn nutzt, und jede Änderung erscheint als Karte im Chat. Lässt du das Feld leer, gelten die Standardeinstellungen.

So funktioniert das KI-Guthaben

Das KI-Guthaben gehört deiner Organisation und wird von allen ihren Servern gemeinsam genutzt.

• Jeden Monat inklusive: Jede Organisation mit mindestens einem Server im aktiven Abo oder im Testzeitraum bekommt 1 € KI-Nutzung pro Abrechnungsmonat. Der Abrechnungsmonat richtet sich nach dem ältesten aktiven Server-Abo der Organisation, im Testzeitraum nach dessen Ende. Nicht verbrauchtes Inklusiv-Guthaben wird nicht in den nächsten Monat übernommen.
• Gekauftes Guthaben: Brauchst du mehr, lädst du Prepaid-Guthaben auf. Gekauftes Guthaben verfällt nie und bleibt bei der Organisation, auch wenn sie gerade keinen Server hat. Es ist nicht übertragbar, wird nicht erstattet und nicht ausgezahlt.
• Reihenfolge: Zuerst wird der Inklusiv-Betrag des Monats verbraucht, danach das gekaufte Guthaben.

KI-Apps, die du über MCP verbindest (etwa Claude oder ChatGPT), verbrauchen kein KI-Guthaben – sie bringen ihr eigenes Modell mit. Siehe KI-Apps verbinden (MCP).

Was eine Anfrage kostet

Jede Anfrage wird nach ihrem Abschluss in Euro abgerechnet, je nach ihrem Umfang. Eine typische Anfrage kostet einen Bruchteil eines Cents. Du siehst immer nur Euro-Beträge.

Jede Nachricht nimmt die ganze bisherige Sitzung mit, deshalb werden Nachrichten teurer, je länger eine Sitzung wird. Ist eine Sitzung sehr lang, kostet jede weitere Nachricht noch einmal etwa doppelt so viel. Für ein neues Thema startest du am besten eine neue Sitzung.

Kostet eine Anfrage mehr als noch übrig ist, endet das Guthaben bei 0 – es wird nie negativ – und dzbot übernimmt die Differenz. Danach lehnt der Companion neue Anfragen ab, bis wieder Guthaben da ist:

• Im Admin-Panel bekommen Benutzer, die aufladen dürfen, einen Link dorthin; alle anderen werden gebeten, sich an einen Organisations-Admin zu wenden.
• In Discord (/ai und Erwähnungen) enthält die Meldung einen Link zur Seite AI Companion.

Verbrauch ansehen und aufladen

Navigationspfad:

• Server Admin → Organisation → AI Companion

Die Seite braucht das Zugriffsrecht AI-Companion-Seite öffnen – an der Organisation (org.ai_companion.access) oder am Server (admin.ai_companion.access). Jede Gruppe, die bereits das Recht KI-Companion hatte, hat das Server-Recht automatisch bekommen.

Die Seite zeigt:

• Jetzt verfügbar – alles, was der Companion noch ausgeben kann
• Inklusive diesen Monat – was vom 1 € noch übrig ist und wann er sich erneuert
• Gekauftes Guthaben – dein Prepaid-Guthaben
• KI-Guthaben aufladen – das Aufladeformular (siehe unten)
• den Verbrauch pro Tag über 7, 30 oder 90 Tage
• den Verbrauch nach Teammitglied
• die teuersten Unterhaltungen
• Beträge, die dzbot übernommen hat, weil das Guthaben mitten in einer Unterhaltung ausging
• Gutgeschrieben – den Verlauf der Aufladungen und der Gutschriften von dzbot

Auch das Companion-Panel selbst zeigt das aktuelle KI-Guthaben in seiner Kopfzeile, und jede Sitzung zeigt, was sie bisher gekostet hat.

Aufladen

Zum Aufladen brauchst du das Abrechnungsrecht Abrechnung ansehen – an der Organisation (org.billing.access) oder am Server (admin.billing.access), dasselbe Recht, mit dem das dzbot-Abo verwaltet wird. Ohne dieses Recht wird das Aufladeformular nicht angezeigt.

1. Wähle 5 €, 10 € oder 25 € oder gib einen anderen Betrag zwischen 5 € und 500 € ein.
2. Setze das Häkchen, dass dzbot das Guthaben sofort bereitstellt und du dadurch dein Widerrufsrecht verlierst.
3. Bezahle über den Stripe-Checkout. Stripe rechnet Umsatzsteuer hinzu, wo sie anfällt.

Das Guthaben erscheint auf der Seite, sobald die Zahlung bestätigt ist. Jede Aufladung wird außerdem in der Buchhaltung deiner Organisation als Ausgabe dzbot KI-Guthaben gebucht – in einer Organisation ohne Euro mit dem Betrag, den deine Karte tatsächlich in ihrer Buchungswährung belastet hat. Einzelne KI-Anfragen tauchen dort nie auf – nur Aufladungen.

Funktioniert es?

Sobald du das Zugriffsrecht hast:

1. Lade das Admin-Panel neu.
2. Suche den KI-Companion-Button (Funkel-Symbol) oben rechts im Header.
3. Öffne ihn, starte eine Neue Sitzung und frage etwas Einfaches wie „suche Spieler <Name>".

Bekommst du eine sinnvolle Antwort, ist alles bereit. Weiter geht es mit KI-Companion – Nutzung.

Fehlerbehebung

Schlägt eine Anfrage fehl, zeigt der Chat eine kurze Meldung mit dem Grund:

Meldung	Bedeutung	Was tun
Das KI-Guthaben dieser Organisation ist aufgebraucht.	Deine Organisation hat weder Inklusiv- noch gekauftes Guthaben übrig	Unter Organisation → AI Companion aufladen oder einen Organisations-Admin darum bitten
Der KI-Dienst ist gerade nicht erreichbar	Eine vorübergehende Störung des KI-Dienstes	Kurz warten und erneut versuchen
Maximale Schrittzahl erreicht	Die Aufgabe lief lange, ohne fertig zu werden	Mit „weiter“ antworten, dann macht er dort weiter – oder die Aufgabe in kleinere Anfragen aufteilen
Systemfehler	Bei dzbot ist etwas schiefgelaufen	Später erneut versuchen

Verwandte Dokumentation

• KI-Companion – Konzept
• KI-Companion – Nutzung
• KI-Apps verbinden (MCP)
• Buchhaltung
• Zugriffssteuerung