HelpStackDocs

Anleitungen

KI-Anbieter

Ein KI-Anbieter ist der Modelldienst, der Ihre KI-Antwortvorschläge speist. Jede neue Organisation startet mit einem einzigen Anbieter namens Automatic, der bereits als Standard festgelegt ist, sodass KI-Antworten funktionieren, bevor Sie irgendetwas konfigurieren — er folgt jeweils dem Modell, das HelpStack derzeit empfiehlt. Sie können ihn jederzeit ändern oder ersetzen. Sie konfigurieren einen oder mehrere Anbieter für Ihre Organisation, wählen ein Modell und dessen Verhalten, und legen einen als Standard fest. Kanäle verwenden dann entweder Ihren Standardanbieter oder einen, den sie selbst auswählen. Dieser Leitfaden behandelt die unterstützten Anbietertypen, wann Sie welchen wählen sollten, alle Konfigurationsoptionen, wie der Standard funktioniert, und eine Checkliste, um Ihre erste KI-Antwort von Anfang bis Ende zum Laufen zu bringen.

Sie finden die Anbieter unter Einstellungen → KI-Anbieter (Route /settings/ai-providers). Für die Verwaltung von KI-Anbietern ist die Rolle OWNER oder ADMIN erforderlich; Agenten und Betrachter können diese in der Regel einsehen.

Die Anbietertypen#

Wenn Sie einen Anbieter hinzufügen, wählen Sie dessen Typ:

  • OpenAI — Von OpenAI gehostete Modelle. Ein guter Allzweck-Standard für die meisten Teams.
  • Anthropic — Von Anthropic gehostete Modelle (Claude). Eine weitere starke Allzweck-Wahl.
  • DeepSeek — von DeepSeek gehostete Modelle, erreichbar über eine OpenAI-kompatible API.
  • Ollama — Betreibt Modelle lokal auf Ihrer eigenen Infrastruktur. Wählen Sie diese Option, wenn Sie On-Premises-Inferenz und keinen Datenabfluss benötigen — zum Beispiel, wenn Kundendaten Ihr Netzwerk nicht verlassen dürfen. Ollama ist lokal, daher ist eine Basis-URL erforderlich, die auf Ihren Ollama-Server zeigt, und das Modell wird als Freitext angegeben (Sie tippen den Namen des Modells, das Sie lokal heruntergeladen haben).
  • Google — Googles Gemini-Modelle. Schnell und günstig, gut geeignet für hohes Chat-Aufkommen.
  • xAI — die Grok-Modelle von xAI.
  • Qwen — die Qwen-Modelle von Alibaba. Die günstigste Option, die wir anbieten.
  • Mistral — die Open-Weight-Modelle von Mistral, in Europa entwickelt.
  • Moonshot — die Kimi-Modelle von Moonshot, stark bei langen Gesprächen.
  • MiniMax — die Modelle von MiniMax.

Welchen sollten Sie wählen?

  • Möchten Sie den einfachsten Weg mit hoher Qualität? Beginnen Sie mit OpenAI oder Anthropic.
  • Möchten Sie die niedrigsten laufenden Kosten? Qwen ist pro Antwort am günstigsten.
  • Müssen Sie Daten On-Premises halten und keine Drittanbieter-API-Aufrufe tätigen? Verwenden Sie Ollama.

Konfigurationsoptionen#

Beim Hinzufügen oder Bearbeiten eines Anbieters legen Sie fest:

  • Typ — eines von OpenAI, Anthropic, DeepSeek, Google, xAI, Qwen, Mistral, Moonshot, MiniMax oder Ollama (siehe oben).
  • Name — ein von Ihnen gewähltes Label zur Identifizierung dieses Anbieters in der Liste.
  • Modell — aus einer vordefinierten Liste pro Anbieter gewählt, außer bei Ollama, wo das Modell als Freitext angegeben wird (geben Sie den Namen eines lokal heruntergeladenen Modells ein).
  • Temperatur — ein Schieberegler von 0 bis 2. Niedrigere Werte machen die KI fokussierter und konsistenter; höhere Werte machen sie abwechslungsreicher/kreativer. Für Support-Antworten ist ein niedrigerer Wert in der Regel sicherer.
  • Maximale Token — die maximale Länge der KI-Antwort.
  • Basis-URLerforderlich für Ollama; für die anderen optional.

Ein Hinweis zu API-Schlüsseln

Bei den Cloud-Anbietern werden API-Schlüssel plattformseitig verwaltet — in der normalen Einrichtung fügen Sie keinen OpenAI- oder Anthropic-Schlüssel selbst ein. Ollama ist die Ausnahme: Da es lokal läuft, verwendet es keinen Schlüssel, benötigt aber seine Basis-URL, damit HelpStack Ihren Server erreichen kann.

Der Standardanbieter#

Genau ein Anbieter pro Organisation ist der Standard. Der Standard wird von jedem Kanal verwendet, der keinen eigenen Anbieter auswählt.

  • Schalten Sie "Als Standard festlegen" um, wenn Sie einen Anbieter hinzufügen oder bearbeiten, oder verwenden Sie die Aktion Standard festlegen auf einer Anbieterkarte.
  • Da es immer genau einen Standard gibt, entfernt das Festlegen eines neuen Standards den Stern vom vorherigen.
  • Sie können den Standardanbieter nicht löschen — legen Sie zuerst einen anderen Anbieter als Standard fest und löschen Sie dann den alten.

Der Ausweichanbieter#

Fällt Ihr Standardanbieter mitten in einer Antwort aus, antwortet HelpStack mit einem Ausweichanbieter, statt den Kunden ohne Antwort zu lassen. Jede Organisation hat einen Ausweichanbieter, ganz gleich, ob Sie selbst einen eingerichtet haben. Welchen Sie haben, sehen Sie unten auf der Seite Einstellungen → KI-Anbieter.

HelpStack wählt ihn in dieser Reihenfolge:

  1. Ein von Ihnen gewählter Anbieter. Aktivieren Sie beim Bearbeiten eines Anbieters „Als Ausweichanbieter verwenden“. Nur ein Anbieter kann der Ausweichanbieter sein, genau wie nur einer der Standard sein kann.
  2. Ein anderer bereits eingerichteter Anbieter, sofern er aktiv ist und zu einem anderen Anbieterunternehmen gehört.
  3. Der HelpStack-Ausweichanbieter — unsere eigene Wahl, die greift, wenn Sie nichts anderes Passendes haben. Das erhalten die meisten Organisationen, und es erfordert keine Einrichtung. Wir halten mehr als einen bereit, sodass die Wahl immer auf ein anderes Anbieterunternehmen fällt als Ihr Standard — auch dann, wenn Ihr Standard zufällig das Unternehmen ist, zu dem wir sonst greifen würden.

Der Schalter setzt zwei Regeln durch, denn ein Ausweichanbieter, der eingerichtet aussieht, aber nichts abdeckt, ist schlechter als gar keiner:

  • Der Standardanbieter kann nicht sein eigener Ausweichanbieter sein.
  • Der Ausweichanbieter muss von einem anderen Anbieterunternehmen stammen als der Standard. Die Störungen, die ein Ausweichanbieter überbrücken soll — ein Ausfall, Ratenbegrenzung, eine Zeitüberschreitung — betreffen alle Modelle eines Anbieters gleichzeitig. Von einem OpenAI-Modell auf ein anderes auszuweichen, ist derselbe Ausfall zweimal. Deshalb erscheint der Schalter „Als Ausweichanbieter verwenden“ nicht, wenn Sie Ihren Standardanbieter bearbeiten oder einen, der zum selben Anbieterunternehmen gehört.

Ihr System-Prompt, die Temperatur und die maximale Tokenzahl werden übernommen. Nur Anbieter und Modell ändern sich, damit eine Ausweichantwort nicht plötzlich in anderem Ton ausfällt.

Ein Ausweichanbieter wird nur bei Fehlern genutzt, bei denen ein anderer Anbieter plausibel Erfolg haben könnte. Aufgebrauchtes Guthaben, ein abgelehnter API-Schlüssel oder eine fehlerhafte Anfrage werden nicht anderswo wiederholt — das würde Geld ausgeben, um denselben Fehler zu reproduzieren, und seine Ursache verschleiern.

Die Anbieterkarten lesen#

Jeder Anbieter in der Liste zeigt:

  • Name
  • Typ-Badge (OpenAI / Anthropic / DeepSeek / Google / xAI / Qwen / Mistral / Moonshot / MiniMax / Ollama)
  • Standard-Stern (wenn es der Standard ist) oder ein Ausweich-Abzeichen (wenn es der Ausweichanbieter ist)
  • Modell
  • Temperatur
  • Maximale Token
  • Aktiv / Inaktiv-Status
  • Aktionen: Standard festlegen, Bearbeiten, Löschen (Sie können den Standard nicht löschen)

Wo der System-Prompt gespeichert ist#

Der System-Prompt — die Persona und Anweisungen der KI (ihr Ton, was sie tun soll und was nicht) — wird nicht beim Anbieter festgelegt. Er wird pro Kanal in der Registerkarte KI & Wissensdatenbank des Kanals konfiguriert. Dadurch können Sie verschiedenen Kanälen unterschiedliche Persönlichkeiten geben, während Sie denselben Anbieter teilen. Siehe Kanäle.

Beachten Sie außerdem: Der E-Mail/Bezeichner des Kunden wird der KI automatisch in ihrem Prompt zur Verfügung gestellt, damit sie bei kontospezifischen Fragen helfen kann, ohne dass Sie dies manuell einrichten müssen.

Ihre erste KI-Antwort zum Laufen bringen#

Eine funktionierende KI-Antwort erfordert drei Dinge. Verwenden Sie diese Checkliste:

  1. Konfigurieren Sie einen Anbieter. Ihr Konto hat bereits einen DeepSeek-Anbieter als Standard, Sie können diesen Schritt also überspringen. Um einen anderen zu verwenden, fügen Sie unter Einstellungen → KI-Anbieter einen Anbieter eines der oben genannten Typen hinzu, wählen Sie ein Modell und eine Temperatur, und legen Sie ihn als Standard fest (oder planen Sie, ihn einem bestimmten Kanal zuzuweisen). Legen Sie für Ollama die Basis-URL fest.
  2. Verknüpfen Sie eine Wissensdatenbank mit dem Kanal. Damit Antworten auf Ihren realen Inhalten basieren, verknüpfen Sie Wissensdatenbank-Gruppen mit dem Kanal unter Einstellungen → Kanäle → Kanal → KI & Wissensdatenbank. Siehe Wissensdatenbank und Kanäle.
  3. Aktivieren Sie KI-Antworten auf dem Kanal. Schalten Sie KI-Antworten für den Kanal ein (und legen Sie seinen System-Prompt in derselben Registerkarte KI & Wissensdatenbank fest). Siehe KI-Antworten.

Wenn diese drei Schritte abgeschlossen sind, senden Sie eine Testnachricht auf dem Kanal und bestätigen Sie, dass die KI eine auf Ihrer Wissensdatenbank basierende Antwort entwirft.

Verwandte Themen#

  • Kanäle — weisen Sie pro Kanal einen Anbieter zu und legen Sie den kanalspezifischen System-Prompt fest.
  • KI-Antworten — wie KI-Antwortvorschläge funktionieren und wie Sie diese aktivieren.
  • Wissensdatenbank — fundieren Sie Antworten in Ihren eigenen Inhalten.
  • Agententools (Übersicht) — geben Sie der KI benutzerdefinierte Fähigkeiten beim Entwerfen von Antworten.
  • Erste Schritte — anfängliche Organisations- und Kanaleinrichtung.
  • Glossar — Definitionen von Temperatur, Token, System-Prompt und mehr.