Fejlfinding af ReplyRabbit
De fleste ReplyRabbit-problemer skyldes en af tre ting: en manglende eller forkert API-nøgle, brug af en udbyder, som dit planniveau ikke tillader, eller en forældet FreeScout-cache. Gå gennem det relevante afsnit nedenfor, hvor hvert problem først viser symptomet og derefter løsningen.
Der genereres ingen kladde
Symptom: du åbner en samtale, men der vises ingen AI-kladde, og der ser ikke ud til at ske noget.
Ret: åbn postkassens ReplyRabbit-indstillinger (Postkasse > Indstillinger > ReplyRabbit) og bekræft, at en udbyder er valgt, og at dens API-nøgle er angivet. På Free-abonnementet er den eneste tilgængelige udbyder OpenAI, så hvis du valgte en anden, skal du skifte tilbage til OpenAI eller opgradere. Tjek derefter, at ReplyRabbit er aktiveret for den postkasse, du arbejder i, da kladder kun genereres for aktiverede postkasser.
Ugyldig API-nøgle eller udbyderfejl
Symptom: du ser en fejl, der nævner en ugyldig nøgle, godkendelsesfejl eller en udbyder, der ikke kan nås.
Ret: tjek nøglen for tastefejl og løse mellemrum, bekræft at det er nøglen til den udbyder, du faktisk valgte (en OpenAI-nøgle virker ikke med Anthropic), og sørg for at nøglen stadig har kredit og adgang på udbyderens dashboard. En nøgle uden resterende saldo eller med tilbagekaldt adgang giver samme fejl.
Fejl efter opgradering af PHP
Symptom: efter en serveropgradering (for eksempel til Ubuntu 26.04 med PHP 8.5), Test forbindelse fejler eller baggrundsjob stopper, og FreeScout-loggen viser meddelelser, der slutter med is deprecated since 8.5.
Ret: hold ReplyRabbit og dine andre moduler opdaterede fra Administrer > Moduler, og kør derefter php artisan freescout:clear-cache og php artisan queue:restart. ReplyRabbit understøtter PHP 8.0 til 8.5. Se Ret "deprecated since 8.5"-fejl i FreeScout for at finde ud af, hvilket modul en besked kommer fra.
ReplyRabbit-menuen mangler
Symptom: ReplyRabbit vises ikke i FreeScout-menuen eller -indstillingerne efter installation.
Ret: skal du først sikre, at modulet er aktiveret under Administrer > Moduler. Tøm derefter cachen fra din FreeScout-rod:
php artisan freescout:clear-cacheHvis det stadig mangler, skal du tjekke brugerens tilladelser: en bruger uden adgang til den relevante postkasse eller administratorindstillinger vil ikke se ReplyRabbit-indstillingerne.
Udkast stoppede efter et stykke tid
Symptom: kladder fungerede i starten og stoppede derefter med at generere senere på måneden.
Ret: Free-planen tillader 10 udkast pr. måned. Når du rammer grænsen, sættes udkast på pause indtil næste måned. Pro og Team har ingen udkastgrænse. På enhver plan sættes udkast også på pause, hvis postkassens Månedligt tokenbudget er brugt op, så kontrollér også den indstilling (0 betyder intet budget).
Prompt caching ændrer ikke den månedlige token-tælling
Symptom: gentagne udkast ser ud til at være kvalificerede til udbyderens prompt-caching, men ReplyRabbits tokenforbrug viser stadig det fulde input- og outputtotal.
Ret: dette er forventet. ReplyRabbit holder månedlige budgetter konservative og tæller samlede tokens, selv når en udbyder fakturerer cached input anderledes. Udbyderens cache-besparelser afhænger af udbyderen, modellen, gentagne prompt-præfikser og udbyderens rapportering. Anthropic cache control bruges kun til kvalificeret gentaget udkastarbejde og falder tilbage til normal generering, når det ikke understøttes.
Linear-tickets oprettes ikke
Symptom: næste handlinger registreres, men der oprettes ingen Linear-ticket.
Ret: i ReplyRabbit-indstillingerne skal du kontrollere Linear API-nøglen, det valgte team og om tickets venter i en afventende tilstand på bekræftelse. Bekræft også, at dit niveau inkluderer Linear: manuel oprettelse af Linear-tickets er en Pro-funktion, og automatisk oprettelse af tickets er en Team-funktion.
Jira-sager bliver ikke oprettet
Symptom: en samtale kræver ingeniørarbejde, men der oprettes ingen Jira-sag.
Ret: i ReplyRabbit-indstillingerne skal du bekræfte, at Jira er valgt som postkassens issue-tracker. Kontrollér Jira Cloud-site-URL'en, kontoens e-mail, API-token, standardprojekt og standardissue-type. Bekræft også, at dit niveau inkluderer oprettelse af issues: manuel oprettelse af Jira-issues er en Pro-funktion, og automatisk oprettelse af issues er en Team-funktion. For den fulde opsætningsvej, se Jira-integration.
Workflow-tags anvendes ikke
Symptom: du forventede tags som rr_priority_critical, rr_no_reply_needed, eller rr_linear_issue_created, men samtalen har ingen ReplyRabbit-tags.
Ret: åbn postkassens ReplyRabbit-indstillinger, og bekræft Aktivér workflow-synkronisering og Anvend FreeScout-tags er slået til i Workflow-tags sektion. Hvis signal-tags mangler, bekræft AI-signaler er slået til, og samtalen er blevet analyseret. Hvis Linear-tags mangler, skal du bekræfte, at samtalen har et ReplyRabbit-oprettet Linear-issue.
Hvis FreeScout Workflows-opskrifter ikke udløses, skal du først bekræfte, at ReplyRabbit tilføjer det forventede FreeScout-tag. Test derefter, om dit installerede Workflows-modul reagerer på programmatiske tagændringer. ReplyRabbit kan anvende tags, men Workflows-modulet styrer, om en opskrift kører fra den tagændring.
Videnskilder: et udkast brugte ikke mine hjælpesider, Vidensbase, produkter eller tidligere svar
Symptom: en kladde ignorerede information, som du ved findes i dine hjælpesider, Knowledge Base, produktliste eller tidligere svar.
Ret: start med linjen under udkastet i svarredigeringsfeltet. Den viser, hvad udkastet brugte, for eksempel "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer". Klik på den for at se links, plus en note for hver aktiveret kilde, der ikke tilføjede noget:
- Slået til, men intet indekseret endnu: indeksering er ikke færdig. Kontrollér kø-workeren (se nedenfor), og vent derefter på, at indekseringen er færdig.
- Ingen god matchning til denne besked: kilden er fin, men intet i den matchede denne kundes besked tæt nok. Tilføj eller forbedr indhold, der besvarer denne type spørgsmål.
- Indeks over søgegrænsen: når indekset passerer 6.000 indekserede sektioner, kører kun nøgleordsmatchning, ikke betydningsbaseret matchning. Fjern kilder, du ikke har brug for, for at bringe det tilbage under grænsen.
- Dit abonnement inkluderer det ikke: den kilde er ikke tilgængelig på din nuværende plan.
- Vidensbase-modulet er ikke installeret eller aktivt: installer eller aktivér den under Administrer > Moduler.
Advarsler om opsætningsstatus
Opsætningsstatusbanneret i postkasseindstillinger advarer nu, når:
- Køarbejderen ser ikke ud til at køre. Indeksering og automatiske kladder fuldføres aldrig uden det. FreeScout kører køen via cron-jobbet
php artisan schedule:runeller enqueue:workproces, så sørg for, at en af dem er opsat. - Ingen videnskilde er slået til. Slå mindst én til i Mailbox settings, Knowledge sources.
- En kilde er slået til, men ikke indekseret endnu. Lad indekseringen færdiggøre.
Websteds kilder
- Crawlingen stopper ved 200 sider som standard, og kilden siger det nu, med en knap til at hæve grænsen. Gem dine indstillinger bagefter, og crawl igen.
- Sider, der ikke kan læses, tælles med en årsag, for eksempel blokeret af webstedet (403), ikke fundet (404), for mange anmodninger (429), en serverfejl, for stor eller ingen læsbar tekst (ofte en side bygget med JavaScript). Bed din host om at lukke crawleren igennem, eller peg kilden mod sider, der ikke kræver JavaScript.
- Meget lange sider forkortes til omkring 24.000 tegn. Når semantisk matchning er slået til, viser kilden, hvor mange sider der blev forkortet. Opdel lange sider, hvis den del, du har brug for, er nær slutningen.
Outline og betydningsbaseret matchning
- Outline-synkronisering stopper ved 1.000 dokumenter. Dokumenter ud over det synkroniseres ikke.
- Betydningsbaseret (semantisk) matchning kræver en embeddings-udbyder. Nogle embedding-modeller er endnu ikke kalibreret til kun-betydning-match og viser en advarsel, så skift til en anden embedding-model, hvis du ser den.
Stadig fast?