Feilsøking av ReplyRabbit
De fleste ReplyRabbit-problemer skyldes en av tre ting: en manglende eller feil API-nøkkel, bruk av en leverandør planlaget ditt ikke tillater, eller en utdatert FreeScout-hurtigbuffer. Gå gjennom den aktuelle delen nedenfor, der hvert problem først lister symptomet og deretter løsningen.
Ingen utkast genereres
Symptom: du åpner en samtale, men ingen AI-kladde vises og ingenting ser ut til å skje.
Fiks: åpne postkassens ReplyRabbit-innstillinger (Postkasse > Innstillinger > ReplyRabbit) og bekreft at en leverandør er valgt og at API-nøkkelen er satt. På Free-abonnementet er OpenAI den eneste tilgjengelige leverandøren, så hvis du valgte en annen, bytt tilbake til OpenAI eller oppgrader. Sjekk deretter at ReplyRabbit er aktivert for postkassen du jobber i, siden utkast bare genereres for aktiverte postkasser.
Ugyldig API-nøkkel eller leverandørfeil
Symptom: du ser en feil som nevner en ugyldig nøkkel, autentiseringsfeil eller en leverandør som ikke kan nås.
Fiks: sjekk nøkkelen på nytt for skrivefeil og overflødige mellomrom, bekreft at det er nøkkelen for leverandøren du faktisk valgte (en OpenAI-nøkkel fungerer ikke med Anthropic), og sørg for at nøkkelen fortsatt har kreditt og tilgang på leverandørens dashbord. En nøkkel uten gjenværende saldo eller med tilbakekalt tilgang gir samme feil.
Feil etter oppgradering av PHP
Symptom: etter en serveroppgradering (for eksempel til Ubuntu 26.04 med PHP 8.5), Test tilkobling feiler eller bakgrunnsjobber stopper, og FreeScout-loggen viser meldinger som slutter med is deprecated since 8.5.
Fiks: hold ReplyRabbit og de andre modulene dine oppdatert fra Administrer > Moduler, og kjør deretter php artisan freescout:clear-cache og php artisan queue:restart. ReplyRabbit støtter PHP 8.0 til 8.5. Se Fiks "deprecated since 8.5"-feil i FreeScout for å finne hvilken modul en melding kommer fra.
ReplyRabbit-menyen mangler
Symptom: ReplyRabbit vises ikke i FreeScout-menyene eller -innstillingene etter at det er installert.
Fiks: først sørg for at modulen er aktivert under Administrer > Moduler. Tøm deretter hurtigbufferen fra FreeScout-roten din:
php artisan freescout:clear-cacheHvis det fortsatt mangler, sjekk brukerens tillatelser: en bruker uten tilgang til den relevante postkassen eller admininnstillingene vil ikke se ReplyRabbit-alternativene.
Utkast stoppet etter en stund
Symptom: utkast fungerte først, men sluttet å generere senere i måneden.
Fiks: Free-planen tillater 10 utkast per måned. Når du når den grensen, pauses utkast til neste måned. Pro og Team har ingen utkastgrense. På alle planer pauses også utkast hvis postkassens Månedlig tokenbudsjett er brukt opp, så sjekk den innstillingen også (0 betyr ingen budsjett).
Promptbufring endrer ikke den månedlige tokentellingen
Symptom: gjentatte utkast ser ut til å være kvalifisert for leverandørens prompt-caching, men ReplyRabbits tokenbruk viser fortsatt hele summen av input og output.
Fiks: dette er forventet. ReplyRabbit holder månedlige budsjetter konservative og teller totale tokens, selv når en leverandør fakturerer bufret input annerledes. Leverandørens cache-besparelser avhenger av leverandøren, modellen, gjentatte prompt-prefikser og leverandørens rapportering. Anthropic cache-kontroll brukes bare for kvalifisert gjentatt utkastarbeid og faller tilbake til normal generering når det ikke støttes.
Linear-saker opprettes ikke
Symptom: neste handlinger oppdages, men ingen Linear-sak opprettes.
Fiks: i ReplyRabbit-innstillingene, sjekk Linear API-nøkkelen, det valgte teamet, og om saker ligger i en ventende tilstand og venter på bekreftelse. Bekreft også at nivået ditt inkluderer Linear: manuell oppretting av Linear-saker er en Pro-funksjon, og automatisk saksoppretting er en Team-funksjon.
Jira-saker opprettes ikke
Symptom: en konversasjon trenger ingeniørarbeid, men ingen Jira-sak opprettes.
Fiks: i ReplyRabbit-innstillingene, bekreft at Jira er valgt som postkassens sakssporingssystem. Sjekk Jira Cloud-nettstedets URL, kontoe-post, API-token, standardprosjekt og standard sakstype. Bekreft også at nivået ditt inkluderer saksoppretting: manuell oppretting av Jira-saker er en Pro-funksjon, og automatisk saksoppretting er en Team-funksjon. For hele oppsettbanen, se Jira-integrasjon.
Workflow-tagger brukes ikke
Symptom: du forventet tagger som rr_priority_critical, rr_no_reply_needed, eller rr_linear_issue_created, men samtalen har ingen ReplyRabbit-tagger.
Fiks: åpne postkassens ReplyRabbit-innstillinger og bekreft Aktiver arbeidsflytsynkronisering og Bruk FreeScout-tagger er på i Workflow-tagger seksjonen. Hvis signaltagger mangler, bekreft AI-signaler er på og samtalen er analysert. Hvis Linear-tagger mangler, bekreft at samtalen har en ReplyRabbit-opprettet Linear-sak.
Hvis FreeScout Workflows-oppskrifter ikke utløses, må du først bekrefte at ReplyRabbit legger til den forventede FreeScout-taggen. Test deretter om den installerte Workflows-modulen reagerer på programmatiske tagg-endringer. ReplyRabbit kan bruke taggene, men Workflows-modulen styrer om en oppskrift kjøres fra den tagg-endringen.
Kunnskapskilder: et utkast brukte ikke hjelpesidene, Kunnskapsbasen, produktene eller tidligere svar
Symptom: et utkast ignorerte informasjon du vet finnes i hjelpesidene, Knowledge Base, produktlisten eller tidligere svar.
Fiks: start med linjen under utkastet i svarredigereren. Den lister opp hva utkastet brukte, for eksempel "Inkludert: 2 hjelpesider, 1 Knowledge Base-artikkel, 3 tidligere svar til denne kunden". Klikk på den for å se lenker, pluss et notat for hver påslått kilde som ikke la til noe:
- Slått på, men ingenting indeksert ennå: indekseringen er ikke ferdig. Sjekk køarbeideren (se nedenfor), og vent deretter på at indekseringen fullføres.
- Ingen god match for denne meldingen: kilden er grei, men ingenting i den matchet denne kundens melding nært nok. Legg til eller forbedre innhold som svarer på denne typen spørsmål.
- Indeks over søkegrensen: når indeksen passerer 6 000 indekserte seksjoner, kjøres bare nøkkelordmatching, ikke betydningsbasert matching. Fjern kilder du ikke trenger for å bringe den tilbake under grensen.
- Planen din inkluderer det ikke: den kilden er ikke tilgjengelig på din nåværende plan.
- Kunnskapsbase-modulen er ikke installert eller aktiv: installer eller aktiver den under Administrer > Moduler.
Advarsler om oppsettsstatus
Statusbanneret for oppsett i postkasseinnstillingene varsler nå når:
- Køarbeideren ser ikke ut til å kjøre. Indeksering og automatiske utkast fullføres aldri uten den. FreeScout kjører køen gjennom cron-jobben
php artisan schedule:runeller enqueue:workprosess, så sørg for at en av dem er satt opp. - Ingen kunnskapskilde er slått på. Slå på minst én i Postkasseinnstillinger, Kunnskapskilder.
- En kilde er slått på, men ikke indeksert ennå. La indekseringen fullføre.
Nettstedskilder
- Gjennomgangen stopper ved 200 sider som standard, og kilden sier nå det, med en knapp for å øke grensen. Lagre innstillingene etterpå, og gjennomgå igjen.
- Sider som ikke kan leses, telles med en årsak, for eksempel blokkert av nettstedet (403), ikke funnet (404), for mange forespørsler (429), en serverfeil, for stor, eller ingen lesbar tekst (ofte en side bygget med JavaScript). Be verten din slippe gjennom crawleren, eller pek kilden mot sider som ikke trenger JavaScript.
- Svært lange sider forkortes til omtrent 24 000 tegn. Når semantisk matching er på, viser kilden hvor mange sider som ble forkortet. Del lange sider hvis delen du trenger er nær slutten.
Disposisjon og betydningsbasert matching
- Outline-synkronisering stopper ved 1 000 dokumenter. Dokumenter utover det synkroniseres ikke.
- Betydningsbasert (semantisk) matching krever en innebygging-leverandør. Noen innebyggingsmodeller er ennå ikke kalibrert for bare betydningstreff og viser en advarsel, så bytt til en annen innebyggingsmodell hvis du ser den.
Fortsatt fast?