Felsökning av ReplyRabbit
De flesta ReplyRabbit-problem beror på en av tre saker: en saknad eller felaktig API-nyckel, användning av en leverantör som din plan inte tillåter, eller en inaktuell FreeScout-cache. Gå igenom motsvarande avsnitt nedan, där varje problem först listar symtomet och sedan lösningen.
Inget utkast genereras
Symptom: du öppnar en konversation, men inget AI-utkast visas och ingenting verkar hända.
Åtgärd: öppna mailboxens ReplyRabbit-inställningar (Postlåda > Inställningar > ReplyRabbit) och bekräfta att en leverantör är vald och att dess API-nyckel är angiven. På Free-nivån är den enda tillgängliga leverantören OpenAI, så om du valde en annan, byt tillbaka till OpenAI eller uppgradera. Kontrollera sedan att ReplyRabbit är aktiverat för den brevlåda du arbetar i, eftersom utkast bara genereras för aktiverade brevlådor.
Fel: ogiltig API-nyckel eller leverantörsfel
Symptom: du ser ett fel som nämner en ogiltig nyckel, autentiseringsfel eller en leverantör som inte kan nås.
Åtgärd: kontrollera nyckeln igen för stavfel och överflödiga mellanslag, bekräfta att det är nyckeln för den leverantör du faktiskt valde (en OpenAI-nyckel fungerar inte med Anthropic) och se till att nyckeln fortfarande har kredit och åtkomst på leverantörens instrumentpanel. En nyckel utan återstående saldo eller med återkallad åtkomst ger samma fel.
Fel efter uppgradering av PHP
Symptom: efter en serveruppgradering (till exempel till Ubuntu 26.04 med PHP 8.5), Testa anslutning misslyckas eller bakgrundsjobb stoppas, och FreeScout-loggen visar meddelanden som slutar med is deprecated since 8.5.
Åtgärd: håll ReplyRabbit och dina andra moduler uppdaterade från Hantera > Moduler, kör sedan php artisan freescout:clear-cache och php artisan queue:restart. ReplyRabbit stöder PHP 8.0 till 8.5. Se Åtgärda "deprecated since 8.5"-fel i FreeScout för att hitta vilken modul ett meddelande kommer från.
ReplyRabbit-menyn saknas
Symptom: ReplyRabbit visas inte i FreeScout-menyerna eller inställningarna efter installationen.
Åtgärd: börja med att kontrollera att modulen är aktiverad under Hantera > Moduler. Rensa sedan cachen från din FreeScout-rot:
php artisan freescout:clear-cacheOm det fortfarande saknas, kontrollera användarens behörigheter: en användare utan åtkomst till den relevanta brevlådan eller administratörsinställningarna ser inte ReplyRabbit-alternativen.
Utkast stoppades efter ett tag
Symptom: utkast fungerade först, men slutade genereras senare under månaden.
Åtgärd: Free-nivån tillåter 10 utkast per månad. När du når den gränsen pausas utkast till nästa månad. Pro och Team har ingen utkastgräns. På alla planer pausas utkast även om brevlådans Månatlig tokenbudget är förbrukad, så kontrollera den inställningen också (0 betyder ingen budget).
Promptcachning ändrar inte den månatliga tokenräkningen
Symptom: upprepade utkast verkar vara berättigade till leverantörens promptcachning, men ReplyRabbits tokenanvändning visar fortfarande hela summan av in- och utdata.
Åtgärd: detta är förväntat. ReplyRabbit håller månadsbudgetar konservativa och räknar totala tokens, även när en leverantör fakturerar cachad indata annorlunda. Leverantörens cachebesparingar beror på leverantören, modellen, upprepade promptprefix och leverantörens rapportering. Anthropic-cachekontroll används endast för kvalificerat upprepat utkastarbete och faller tillbaka till normal generering när det inte stöds.
Linear-ärenden skapas inte
Symptom: nästa åtgärder upptäcks, men inget Linear-ärende skapas.
Åtgärd: i ReplyRabbit-inställningarna, kontrollera Linear API-nyckeln, det valda teamet och om ärenden ligger i väntande läge i väntan på bekräftelse. Bekräfta också att din nivå inkluderar Linear: manuellt skapande av Linear-ärenden är en Pro-funktion, och automatiskt ärendeskapande är en Team-funktion.
Jira-ärenden skapas inte
Symptom: en konversation behöver ingenjörsarbete, men inget Jira-ärende skapas.
Åtgärd: i ReplyRabbit-inställningarna, bekräfta att Jira är valt som mailboxens ärendehanteringssystem. Kontrollera Jira Cloud-webbplatsens URL, kontots e-post, API-token, standardprojekt och standardärendetyp. Bekräfta också att din nivå inkluderar ärendeskapande: manuellt skapande av Jira-ärenden är en Pro-funktion, och automatiskt ärendeskapande är en Team-funktion. För den fullständiga installationsvägen, se Jira-integration.
Workflow-taggar tillämpas inte
Symptom: du förväntade dig taggar som rr_priority_critical, rr_no_reply_needed, eller rr_linear_issue_created, men konversationen har inga ReplyRabbit-taggar.
Åtgärd: öppna mailboxens ReplyRabbit-inställningar och bekräfta Aktivera workflowsynk och Tillämpa FreeScout-taggar är på i Workflow-taggar avsnittet. Om signaltaggar saknas, bekräfta AI-signaler är på och konversationen har analyserats. Om Linear-taggar saknas, bekräfta att konversationen har ett Linear-ärende skapat av ReplyRabbit.
Om FreeScout Workflows-recept inte utlöses, bekräfta först att ReplyRabbit lägger till den förväntade FreeScout-taggen. Testa sedan om din installerade Workflows-modul reagerar på programmatiska taggändringar. ReplyRabbit kan tillämpa taggarna, men Workflows-modulen styr om ett recept körs från den taggändringen.
Kunskapskällor: ett utkast använde inte mina hjälpsidor, kunskapsbas, produkter eller tidigare svar
Symptom: ett utkast ignorerade information som du vet finns i dina hjälpsidor, Knowledge Base, produktlista eller tidigare svar.
Åtgärd: börja med raden under utkastet i svarsredigeraren. Den listar vad utkastet använde, till exempel "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer". Klicka på den för att se länkar, plus en notering för varje påslagen källa som inte bidrog med något:
- Påslagen men inget indexerat ännu: indexeringen har inte slutförts. Kontrollera köarbetaren (se nedan) och vänta sedan på att indexeringen slutförs.
- Ingen bra matchning för detta meddelande: källan är okej, men inget i den matchade den här kundens meddelande tillräckligt nära. Lägg till eller förbättra innehåll som svarar på den här typen av fråga.
- Index över sökgränsen: när indexet passerar 6 000 indexerade avsnitt körs endast nyckelordsmatchning, inte betydelsebaserad matchning. Ta bort källor du inte behöver för att få det tillbaka under gränsen.
- Din plan inkluderar det inte: den källan är inte tillgänglig i din nuvarande plan.
- Kunskapsbasmodulen är inte installerad eller aktiv: installera eller aktivera den under Hantera > Moduler.
Varningar om konfigurationsstatus
Statusbannern för installation i brevlådeinställningarna varnar nu när:
- Köarbetaren verkar inte köra. Indexering och automatiska utkast slutförs aldrig utan den. FreeScout kör kön via cron-jobbet
php artisan schedule:runeller enqueue:workprocess, så se till att en av dem är konfigurerad. - Ingen kunskapskälla är aktiverad. Slå på minst en i Mailbox settings, Knowledge sources.
- En källa är påslagen men ännu inte indexerad. Låt indexeringen slutföras.
Webbplatskällor
- Genomsökningen stoppar vid 200 sidor som standard, och källan säger nu det, med en knapp för att höja gränsen. Spara dina inställningar efteråt och genomsök igen.
- Sidor som inte kan läsas räknas med en anledning, till exempel blockerad av webbplatsen (403), hittades inte (404), för många förfrågningar (429), ett serverfel, för stor eller ingen läsbar text (ofta en sida byggd med JavaScript). Be din värd att släppa igenom crawler, eller peka källan mot sidor som inte behöver JavaScript.
- Väldigt långa sidor kortas till cirka 24 000 tecken. När semantisk matchning är på visar källan hur många sidor som kortades. Dela upp långa sidor om delen du behöver finns nära slutet.
Outline och betydelsebaserad matchning
- Outline-synkronisering stannar vid 1 000 dokument. Dokument utöver det synkroniseras inte.
- Betydelsebaserad (semantisk) matchning kräver en inbäddningsleverantör. Vissa inbäddningsmodeller är ännu inte kalibrerade för enbart betydelsematchningar och visar en varning, så byt till en annan inbäddningsmodell om du ser den.
Fortfarande fast?