Fehlerbehebung bei ReplyRabbit
Die meisten ReplyRabbit-Probleme lassen sich auf eines von drei Dingen zurückführen: ein fehlender oder falscher API-Schlüssel, die Verwendung eines Anbieters, den Ihre Planstufe nicht erlaubt, oder ein veralteter FreeScout-Cache. Arbeiten Sie den passenden Abschnitt unten durch, in dem jedes Problem zuerst das Symptom und dann die Lösung auflistet.
Es wird kein Entwurf erstellt
Symptom: Sie eine Unterhaltung öffnen, aber kein KI-Entwurf erscheint und nichts zu passieren scheint.
Behebung: öffnen Sie die ReplyRabbit-Einstellungen der Mailbox (Postfach > Einstellungen > ReplyRabbit) und bestätigen Sie, dass ein Anbieter ausgewählt und dessen API-Schlüssel gesetzt ist. Im Free-Tarif ist der einzige verfügbare Anbieter OpenAI. Wenn Sie einen anderen gewählt haben, wechseln Sie zurück zu OpenAI oder führen Sie ein Upgrade durch. Prüfen Sie dann, ob ReplyRabbit für das Postfach aktiviert ist, in dem Sie arbeiten, da Entwürfe nur für aktivierte Postfächer erstellt werden.
Fehler: ungültiger API-Schlüssel oder Anbieterfehler
Symptom: Sie eine Fehlermeldung sehen, die einen ungültigen Schlüssel, einen Authentifizierungsfehler oder einen nicht erreichbaren Anbieter erwähnt.
Behebung: Prüfen Sie den Schlüssel erneut auf Tippfehler und überflüssige Leerzeichen, bestätigen Sie, dass es der Schlüssel für den Anbieter ist, den Sie tatsächlich ausgewählt haben (ein OpenAI-Schlüssel funktioniert nicht mit Anthropic), und stellen Sie sicher, dass der Schlüssel noch Guthaben und Zugriff im Dashboard des Anbieters hat. Ein Schlüssel ohne Restguthaben oder mit widerrufenem Zugriff erzeugt denselben Fehler.
Fehler nach dem PHP-Upgrade
Symptom: nach einem Server-Upgrade (zum Beispiel auf Ubuntu 26.04 mit PHP 8.5), Verbindung testen schlägt fehl oder Hintergrundjobs stoppen, und das FreeScout-Log zeigt Meldungen, die enden mit is deprecated since 8.5.
Behebung: halten Sie ReplyRabbit und Ihre anderen Module aktuell unter Verwalten > Module, dann führen Sie aus php artisan freescout:clear-cache und php artisan queue:restart. ReplyRabbit unterstützt PHP 8.0 bis 8.5. Siehe Fehler "deprecated since 8.5" in FreeScout beheben um herauszufinden, von welchem Modul eine Nachricht stammt.
Das ReplyRabbit-Menü fehlt
Symptom: ReplyRabbit erscheint nach der Installation nicht in den FreeScout-Menüs oder -Einstellungen.
Behebung: stellen Sie zunächst sicher, dass das Modul aktiviert ist unter Verwalten > Module. Leeren Sie dann den Cache aus Ihrem FreeScout-Stammverzeichnis:
php artisan freescout:clear-cacheWenn es immer noch fehlt, prüfen Sie die Berechtigungen des Benutzers: Ein Benutzer ohne Zugriff auf das entsprechende Postfach oder die Admin-Einstellungen sieht die ReplyRabbit-Optionen nicht.
Entwürfe nach einer Weile gestoppt
Symptom: Entwürfe funktionierten zunächst, stellten dann später im Monat die Generierung ein.
Behebung: Der Free-Tarif erlaubt 10 Entwürfe pro Monat. Sobald Sie dieses Limit erreichen, pausieren Entwürfe bis zum nächsten Monat. Pro und Team haben kein Entwurfslimit. In jedem Plan pausieren Entwürfe auch, wenn das Postfach Monatliches Token-Budget aufgebraucht ist, prüfen Sie also auch diese Einstellung (0 bedeutet kein Budget).
Prompt-Caching ändert nicht die monatliche Token-Anzahl
Symptom: wiederholte Entwürfe scheinen für Provider-Prompt-Caching in Frage zu kommen, aber die Token-Nutzung von ReplyRabbit zeigt weiterhin die vollständige Eingabe- und Ausgabesumme.
Behebung: dies ist zu erwarten. ReplyRabbit hält monatliche Budgets konservativ und zählt Gesamt-Token, selbst wenn ein Anbieter gecachte Eingaben anders abrechnet. Die Cache-Einsparungen des Anbieters hängen vom Anbieter, Modell, wiederholten Prompt-Präfixen und der Berichterstattung des Anbieters ab. Anthropic-Cache-Steuerung wird nur für geeignete wiederholte Entwurfsarbeit verwendet und fällt auf normale Generierung zurück, wenn sie nicht unterstützt wird.
Linear-Tickets werden nicht erstellt
Symptom: nächste Aktionen werden erkannt, aber es wird kein Linear-Ticket erstellt.
Behebung: in den ReplyRabbit-Einstellungen prüfen Sie den Linear-API-Schlüssel, das ausgewählte Team und ob Tickets in einem ausstehenden Zustand auf Bestätigung warten. Bestätigen Sie außerdem, dass Ihr Tarif Linear enthält: die manuelle Linear-Ticket-Erstellung ist eine Pro-Funktion, und die automatische Ticket-Erstellung ist eine Team-Funktion.
Jira-Issues werden nicht erstellt
Symptom: eine Konversation Engineering-Arbeit erfordert, aber kein Jira-Issue erstellt wird.
Behebung: in den ReplyRabbit-Einstellungen bestätigen Sie, dass Jira als Issue-Tracker der Mailbox ausgewählt ist. Prüfen Sie die Jira Cloud-Site-URL, die Konto-E-Mail, das API-Token, das Standardprojekt und den Standard-Issue-Typ. Bestätigen Sie außerdem, dass Ihr Tarif die Issue-Erstellung enthält: die manuelle Jira-Issue-Erstellung ist eine Pro-Funktion, und die automatische Issue-Erstellung ist eine Team-Funktion. Den vollständigen Einrichtungspfad finden Sie in Jira-Integration.
Workflow-Tags werden nicht angewendet
Symptom: Sie erwartet haben, Tags wie rr_priority_critical, rr_no_reply_needed, oder rr_linear_issue_created, aber die Unterhaltung hat keine ReplyRabbit-Tags.
Behebung: öffnen Sie die ReplyRabbit-Einstellungen der Mailbox und bestätigen Sie Workflow-Synchronisierung aktivieren und FreeScout-Tags anwenden sind aktiviert in der Workflow-Tags Abschnitt. Wenn Signal-Tags fehlen, bestätigen Sie KI-Signale ist an und die Konversation wurde analysiert. Wenn Linear-Tags fehlen, bestätigen Sie, dass die Konversation ein von ReplyRabbit erstelltes Linear-Issue hat.
Wenn FreeScout Workflows-Rezepte nicht ausgelöst werden, bestätigen Sie zuerst, dass ReplyRabbit das erwartete FreeScout-Tag hinzufügt. Testen Sie dann, ob Ihr installiertes Workflows-Modul auf programmatische Tag-Änderungen reagiert. ReplyRabbit kann die Tags anwenden, aber das Workflows-Modul steuert, ob ein Rezept aufgrund dieser Tag-Änderung ausgeführt wird.
Wissensquellen: Ein Entwurf hat meine Hilfeseiten, die Wissensdatenbank, Produkte oder frühere Antworten nicht verwendet
Symptom: ein Entwurf Informationen ignoriert hat, von denen Sie wissen, dass sie in Ihren Hilfeseiten, Ihrer Knowledge Base, Produktliste oder früheren Antworten stehen.
Behebung: beginnen Sie mit der Zeile unter dem Entwurf im Antwort-Editor. Sie listet auf, was der Entwurf verwendet hat, zum Beispiel "Enthalten: 2 Hilfeseiten, 1 Knowledge-Base-Artikel, 3 frühere Antworten an diesen Kunden". Klicken Sie darauf, um Links zu sehen, plus eine Notiz für jede aktivierte Quelle, die nichts beigetragen hat:
- Eingeschaltet, aber noch nichts indexiert: die Indexierung ist noch nicht abgeschlossen. Prüfen Sie den Queue-Worker (siehe unten) und warten Sie dann, bis die Indexierung abgeschlossen ist.
- Keine passende Übereinstimmung für diese Nachricht: die Quelle ist in Ordnung, aber nichts darin passte eng genug zur Nachricht dieses Kunden. Fügen Sie Inhalte hinzu oder verbessern Sie sie, die diese Art von Frage beantworten.
- Index über dem Suchlimit: sobald der Index 6.000 indexierte Abschnitte überschreitet, läuft nur noch der Schlüsselwortabgleich, nicht der bedeutungsbasierte Abgleich. Entfernen Sie Quellen, die Sie nicht benötigen, um wieder unter das Limit zu kommen.
- Ihr Tarif enthält es nicht: diese Quelle ist in Ihrem aktuellen Plan nicht verfügbar.
- Wissensdatenbank-Modul ist nicht installiert oder aktiv: installieren oder aktivieren Sie es unter Verwalten > Module.
Warnungen zum Einrichtungsstatus
Das Einrichtungsstatus-Banner in den Mailbox-Einstellungen warnt jetzt, wenn:
- Der Queue-Worker scheint nicht zu laufen. Indizierung und automatische Entwürfe werden ohne ihn nie abgeschlossen. FreeScout führt die Warteschlange über den Cron-Job aus
php artisan schedule:runoder einequeue:workProzess, stellen Sie also sicher, dass einer davon eingerichtet ist. - Keine Wissensquelle ist aktiviert. Schalten Sie mindestens eine unter Mailbox-Einstellungen, Wissensquellen ein.
- Eine Quelle ist eingeschaltet, aber noch nicht indexiert. Lass die Indexierung abschließen.
Website-Quellen
- Der Crawl stoppt standardmäßig bei 200 Seiten, und die Quelle sagt das jetzt auch, mit einer Schaltfläche zum Erhöhen des Limits. Speichere danach deine Einstellungen und crawle erneut.
- Seiten, die nicht gelesen werden können, werden mit einem Grund gezählt, zum Beispiel von der Website blockiert (403), nicht gefunden (404), zu viele Anfragen (429), ein Serverfehler, zu groß oder kein lesbarer Text (oft eine mit JavaScript erstellte Seite). Bitten Sie Ihren Host, den Crawler durchzulassen, oder richten Sie die Quelle auf Seiten, die kein JavaScript benötigen.
- Sehr lange Seiten werden auf etwa 24.000 Zeichen gekürzt. Wenn der semantische Abgleich aktiviert ist, zeigt die Quelle an, wie viele Seiten gekürzt wurden. Teilen Sie lange Seiten auf, wenn der benötigte Teil nahe am Ende liegt.
Outline und bedeutungsbasierte Zuordnung
- Die Outline-Synchronisierung stoppt bei 1.000 Dokumenten. Dokumente darüber hinaus werden nicht synchronisiert.
- Bedeutungsbasiertes (semantisches) Matching benötigt einen Embeddings-Anbieter. Einige Embedding-Modelle sind noch nicht für rein bedeutungsbasierte Übereinstimmungen kalibriert und zeigen eine Warnung an, wechseln Sie in diesem Fall zu einem anderen Embedding-Modell.
Weiterhin festgefahren?