Wie aktiviert man Captain auf selbst gehosteten Installationen?

Captain ist ein KI-Assistent, der Ihnen dabei hilft, schneller und präziser zu antworten. Mit Bring Your Own Key (BYOK) können Sie Ihren eigenen API-Schlüssel von OpenAI oder einem kompatiblen KI-Dienst verwenden. Sie steuern die Daten, Kosten und welches Modell verwendet wird. In einer selbstgehosteten Umgebung sendet Captain Daten nur an das KI-Modell, das Sie auswählen.

Diese Anleitung zeigt Ihnen, wie Sie Captain in Ihrer selbstgehosteten Enterprise Edition aktivieren, Ihren API-Schlüssel hinzufügen und ein benutzerdefiniertes Modell einrichten können, falls gewünscht.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Chatwoot Enterprise Edition mit einem kostenpflichtigen Tarif.

• Admin-Zugriff auf die Super Admin Console.

• Einen gültigen OpenAI API-Schlüssel.

• (Optional) Einen selbstgehosteten OpenAI-kompatiblen API-Endpunkt.

• (Optional) Einen Firecrawl API-Schlüssel für ein besseres Durchsuchen von Dokumentationen.

Captain in der Super Admin Console aktivieren

Um Captain auf Installationsebene zu aktivieren:

Loggen Sie sich in die Super Admin Console ein. Navigieren Sie zu Einstellungen → Captain.

Füllen Sie die Konfigurationsfelder aus:

1. OpenAI API-Schlüssel (Erforderlich) – Der Schlüssel zur Authentifizierung von Anfragen bei OpenAI oder einem kompatiblen Dienst.

2. OpenAI Modell (Erforderlich) – Standard ist gpt-4o-mini. Sie können auch ein anderes unterstütztes Modell wie gpt-5 wählen.

3. OpenAI API-Endpunkt (Optional) – Geben Sie Ihren benutzerdefinierten API-Endpunkt ein, wenn Sie ein selbstgehostetes Modell verwenden.

4. Firecrawl API-Schlüssel (Optional) – Empfohlen für besseres Crawlen von Webseiten und Dokumentationen.

   Klicken Sie auf Absenden, um Ihre Konfiguration zu speichern.

Captain für ein Konto aktivieren

Nachdem Sie Captain global aktiviert haben, aktivieren Sie es für einzelne Konten:

1. Gehen Sie in der Super Admin Console zu Konten.

2. Wählen Sie das Konto aus, für das Sie Captain aktivieren möchten, und klicken Sie auf Bearbeiten.

3. Im Bereich Premium-Funktionen aktivieren Sie den Schalter Captain.

4. Speichern Sie die Änderungen.

Fehlerbehebung

Falls Captain nicht wie erwartet reagiert:

• Überprüfen Sie, ob der OpenAI API-Schlüssel korrekt und aktiv ist.

• Stellen Sie sicher, dass der Modellname mit einem unterstützten Modell übereinstimmt.

• Überprüfen Sie, ob Ihr Firecrawl API-Schlüssel gültig ist, falls Sie das Crawlen nutzen.

• Vergewissern Sie sich, dass Captain sowohl auf Installations- als auch auf Kontoebene aktiviert ist.

Wenn Captain weiterhin nicht reagiert, überprüfen Sie die Chatwoot-Serverprotokolle sowohl für die Web- als auch für die Worker-Prozesse, um Fehler zu identifizieren, und teilen Sie diese Fehlermeldungen dem Support-Team für weitere Unterstützung mit.