Rozwiązywanie problemów z ReplyRabbit
Większość problemów z ReplyRabbit sprowadza się do jednej z trzech rzeczy: brakującego lub błędnego klucza API, używania dostawcy niedozwolonego w Twoim planie lub nieaktualnego cache FreeScout. Przejdź przez odpowiednią sekcję poniżej, gdzie każdy problem najpierw opisuje objaw, a następnie rozwiązanie.
Szkic nie jest generowany
Objaw: otwierasz rozmowę, ale nie pojawia się żaden szkic AI i nic się nie dzieje.
Poprawka: otwórz ustawienia ReplyRabbit skrzynki (Skrzynka > Ustawienia > ReplyRabbit) i potwierdź, że wybrano dostawcę i ustawiono jego klucz API. W planie Free jedynym dostępnym dostawcą jest OpenAI, więc jeśli wybrałeś innego, przełącz się z powrotem na OpenAI lub uaktualnij plan. Następnie sprawdź, czy ReplyRabbit jest włączony dla skrzynki, w której pracujesz, ponieważ szkice generują się tylko dla włączonych skrzynek.
Błąd nieprawidłowego klucza API lub dostawcy
Objaw: widzisz błąd wspominający o nieprawidłowym kluczu, niepowodzeniu uwierzytelniania lub niedostępnym dostawcy.
Poprawka: ponownie sprawdź klucz pod kątem literówek i zbędnych spacji, potwierdź, że jest to klucz dla dostawcy, którego faktycznie wybrałeś (klucz OpenAI nie zadziała z Anthropic) i upewnij się, że klucz nadal ma środki i dostęp w panelu dostawcy. Klucz bez pozostałego salda lub z cofniętym dostępem daje ten sam błąd.
Błędy po aktualizacji PHP
Objaw: po aktualizacji serwera (na przykład do Ubuntu 26.04 z PHP 8.5), Przetestuj połączenie kończy się niepowodzeniem lub zadania w tle się zatrzymują, a dziennik FreeScout pokazuje komunikaty kończące się na is deprecated since 8.5.
Poprawka: utrzymuj ReplyRabbit i inne moduły w aktualnej wersji z Zarządzaj > Moduły, a następnie uruchom php artisan freescout:clear-cache oraz php artisan queue:restart. ReplyRabbit obsługuje PHP od 8.0 do 8.5. Zobacz Napraw błędy "deprecated since 8.5" w FreeScout aby znaleźć, z którego modułu pochodzi wiadomość.
Brakuje menu ReplyRabbit
Objaw: ReplyRabbit nie pojawia się w menu ani ustawieniach FreeScout po instalacji.
Poprawka: najpierw upewnij się, że moduł jest aktywowany w sekcji Zarządzaj > Moduły. Następnie wyczyść pamięć podręczną z katalogu głównego FreeScout:
php artisan freescout:clear-cacheJeśli nadal go brakuje, sprawdź uprawnienia użytkownika: użytkownik bez dostępu do odpowiedniej skrzynki lub ustawień administratora nie zobaczy opcji ReplyRabbit.
Szkice zatrzymały się po pewnym czasie
Objaw: wersje robocze działały na początku, a później w ciągu miesiąca przestały się generować.
Poprawka: plan Free pozwala na 10 szkiców miesięcznie. Po osiągnięciu tego limitu szkice są wstrzymywane do następnego miesiąca. Pro i Team nie mają limitu szkiców. W każdym planie szkice są również wstrzymywane, jeśli skrzynka Miesięczny budżet tokenów jest wykorzystany, więc sprawdź też to ustawienie (0 oznacza brak budżetu).
Buforowanie promptów nie zmienia miesięcznego licznika tokenów
Objaw: powtarzające się szkice wydają się kwalifikować do buforowania promptów dostawcy, ale zużycie tokenów ReplyRabbit nadal pokazuje pełną sumę wejścia i wyjścia.
Poprawka: jest to oczekiwane. ReplyRabbit utrzymuje miesięczne budżety ostrożnie i liczy całkowite tokeny, nawet gdy dostawca rozlicza buforowane wejście inaczej. Oszczędności pamięci podręcznej dostawcy zależą od dostawcy, modelu, powtarzanych prefiksów promptów i raportowania dostawcy. Kontrola pamięci podręcznej Anthropic jest używana tylko dla kwalifikującej się powtarzanej pracy nad szkicami i wraca do normalnego generowania, gdy nie jest obsługiwana.
Zgłoszenia Linear nie są tworzone
Objaw: wykrywane są następne działania, ale nie jest tworzone żadne zgłoszenie Linear.
Poprawka: w ustawieniach ReplyRabbit sprawdź klucz API Linear, wybrany zespół i czy zgłoszenia oczekują w stanie oczekiwania na potwierdzenie. Potwierdź też, że Twój plan obejmuje Linear: ręczne tworzenie zgłoszeń Linear to funkcja Pro, a automatyczne tworzenie zgłoszeń to funkcja Team.
Zgłoszenia Jira nie są tworzone
Objaw: konwersacja wymaga pracy inżynierskiej, ale nie tworzy się żadne zgłoszenie Jira.
Poprawka: w ustawieniach ReplyRabbit potwierdź, że Jira jest wybrana jako narzędzie do śledzenia problemów skrzynki. Sprawdź adres URL witryny Jira Cloud, e-mail konta, token API, domyślny projekt i domyślny typ problemu. Potwierdź też, że Twój plan obejmuje tworzenie problemów: ręczne tworzenie problemów Jira to funkcja Pro, a automatyczne tworzenie problemów to funkcja Team. Aby poznać pełną ścieżkę konfiguracji, zobacz Integracja z Jira.
Tagi Workflow nie są stosowane
Objaw: oczekiwałeś tagów takich jak rr_priority_critical, rr_no_reply_needed, lub rr_linear_issue_created, ale rozmowa nie ma tagów ReplyRabbit.
Poprawka: otwórz ustawienia ReplyRabbit skrzynki i potwierdź Włącz synchronizację workflow oraz Zastosuj tagi FreeScout są włączone w Tagi Workflow sekcja. Jeśli brakuje tagów sygnałów, potwierdź Sygnały AI jest włączona, a rozmowa została przeanalizowana. Jeśli brakuje tagów Linear, potwierdź, że rozmowa ma problem Linear utworzony przez ReplyRabbit.
Jeśli przepisy FreeScout Workflows nie uruchamiają się, najpierw potwierdź, że ReplyRabbit dodaje oczekiwany tag FreeScout. Następnie sprawdź, czy zainstalowany moduł Workflows reaguje na programowe zmiany tagów. ReplyRabbit może stosować tagi, ale moduł Workflows decyduje, czy przepis uruchomi się na skutek tej zmiany tagu.
Źródła wiedzy: szkic nie użył moich stron pomocy, Bazy wiedzy, produktów ani wcześniejszych odpowiedzi
Objaw: szkic pominął informacje, o których wiesz, że są w Twoich stronach pomocy, bazie wiedzy, liście produktów lub wcześniejszych odpowiedziach.
Poprawka: zacznij od wiersza pod szkicem w edytorze odpowiedzi. Wyświetla on, czego użył szkic, na przykład "Uwzględniono: 2 strony pomocy, 1 artykuł bazy wiedzy, 3 wcześniejsze odpowiedzi dla tego klienta". Kliknij go, aby zobaczyć linki oraz notatkę dla każdego włączonego źródła, które nic nie dodało:
- Włączone, ale nic jeszcze nie zaindeksowano: indeksowanie nie zostało ukończone. Sprawdź proces roboczy kolejki (patrz poniżej), a następnie poczekaj na ukończenie indeksowania.
- Brak dobrego dopasowania do tej wiadomości: źródło jest w porządku, ale nic w nim nie pasowało wystarczająco blisko do wiadomości tego klienta. Dodaj lub ulepsz treść, która odpowiada na tego typu pytanie.
- Indeks powyżej limitu wyszukiwania: gdy indeks przekroczy 6000 zaindeksowanych sekcji, działa tylko dopasowywanie słów kluczowych, a nie dopasowywanie oparte na znaczeniu. Usuń źródła, których nie potrzebujesz, aby wrócić poniżej limitu.
- Twój plan tego nie obejmuje: to źródło nie jest dostępne w Twoim obecnym planie.
- Moduł Baza wiedzy nie jest zainstalowany lub aktywny: zainstaluj lub aktywuj go w sekcji Zarządzaj > Moduły.
Ostrzeżenia o stanie konfiguracji
Baner stanu konfiguracji w ustawieniach skrzynki ostrzega teraz, gdy:
- Wygląda na to, że proces roboczy kolejki nie działa. Indeksowanie i automatyczne szkice nigdy się nie kończą bez tego. FreeScout uruchamia kolejkę przez zadanie cron
php artisan schedule:runlubqueue:workproces, więc upewnij się, że jeden z nich jest skonfigurowany. - Żadne źródło wiedzy nie jest włączone. Włącz co najmniej jedno w Mailbox settings, Knowledge sources.
- Źródło jest włączone, ale jeszcze nie zaindeksowane. Pozwól indeksowaniu się zakończyć.
Źródła witryny
- Indeksowanie zatrzymuje się domyślnie na 200 stronach, a źródło teraz to informuje, z przyciskiem do podniesienia limitu. Zapisz ustawienia, a następnie uruchom indeksowanie ponownie.
- Strony, których nie można odczytać, są liczone z podaniem przyczyny, na przykład zablokowane przez witrynę (403), nie znaleziono (404), zbyt wiele żądań (429), błąd serwera, zbyt duża lub brak czytelnego tekstu (często strona zbudowana w JavaScript). Poproś swojego hosta o przepuszczenie crawlera lub wskaż źródło na strony, które nie wymagają JavaScript.
- Bardzo długie strony są skracane do około 24 000 znaków. Gdy dopasowywanie semantyczne jest włączone, źródło pokazuje, ile stron zostało skróconych. Podziel długie strony, jeśli potrzebna część znajduje się blisko końca.
Outline i dopasowywanie po znaczeniu
- Synchronizacja Outline zatrzymuje się na 1000 dokumentów. Dokumenty powyżej tego limitu nie są synchronizowane.
- Dopasowanie oparte na znaczeniu (semantyczne) wymaga dostawcy osadzeń. Niektóre modele osadzeń nie są jeszcze skalibrowane do dopasowań wyłącznie znaczeniowych i pokazują ostrzeżenie, więc przełącz się na inny model osadzeń, jeśli je zobaczysz.
Nadal utknąłeś?