ReplyRabbit sorun giderme
ReplyRabbit sorunlarının çoğu üç şeyden birine indirgenir: eksik veya yanlış bir API anahtarı, plan katmanınızın izin vermediği bir sağlayıcı kullanmak veya eski bir FreeScout önbelleği. Aşağıdaki ilgili bölümü inceleyin; her sorun önce belirtiyi, ardından çözümü listeler.
Taslak oluşturulmaz
Belirti: bir konuşma açıyorsunuz, ancak hiçbir AI taslağı görünmüyor ve hiçbir şey olmuyor gibi görünüyor.
Düzeltme: posta kutusunun ReplyRabbit ayarlarını açın (Posta Kutusu > Ayarlar > ReplyRabbit) ve bir sağlayıcının seçili olduğunu ve API anahtarının ayarlandığını doğrulayın. Free planda mevcut tek sağlayıcı OpenAI'dir, bu yüzden farklı bir sağlayıcı seçtiyseniz OpenAI'ye geri dönün veya yükseltin. Ardından, taslaklar yalnızca etkinleştirilmiş posta kutuları için oluşturulduğundan, çalıştığınız posta kutusu için ReplyRabbit'in etkinleştirildiğini kontrol edin.
Geçersiz API anahtarı veya sağlayıcı hatası
Belirti: geçersiz anahtar, kimlik doğrulama hatası veya erişilemeyen bir sağlayıcıdan söz eden bir hata görüyorsunuz.
Düzeltme: anahtarı yazım hataları ve fazladan boşluklar için yeniden kontrol edin, gerçekten seçtiğiniz sağlayıcının anahtarı olduğunu doğrulayın (bir OpenAI anahtarı Anthropic ile çalışmaz) ve anahtarın sağlayıcının panosunda hâlâ kredi ve erişimi olduğundan emin olun. Bakiyesi kalmamış veya erişimi iptal edilmiş bir anahtar aynı hatayı üretir.
PHP yükseltmesinden sonraki hatalar
Belirti: bir sunucu yükseltmesinden sonra (örneğin, PHP 8.5 ile Ubuntu 26.04'e), Bağlantıyı test et başarısız olur veya arka plan işleri durur ve FreeScout günlüğü şununla biten mesajlar gösterir: is deprecated since 8.5.
Düzeltme: ReplyRabbit'i ve diğer modüllerinizi şuradan güncel tutun: Yönet > Modüller, ardından şunu çalıştırın: php artisan freescout:clear-cache ve php artisan queue:restart. ReplyRabbit PHP 8.0 ile 8.5 arasını destekler. Bkz. FreeScout'ta "deprecated since 8.5" hatalarını düzeltin bir mesajın hangi modülden geldiğini bulmak için.
ReplyRabbit menüsü eksik
Belirti: ReplyRabbit, kurulduktan sonra FreeScout menülerinde veya ayarlarında görünmüyor.
Düzeltme: önce modülün şurada etkinleştirildiğinden emin olun: Yönet > Modüller. Ardından önbelleği FreeScout kök dizininizden temizleyin:
php artisan freescout:clear-cacheHâlâ eksikse, kullanıcının izinlerini kontrol edin: ilgili posta kutusuna veya yönetici ayarlarına erişimi olmayan bir kullanıcı ReplyRabbit seçeneklerini görmez.
Taslaklar bir süre sonra durdu
Belirti: taslaklar başta çalıştı, sonra ayın ilerleyen günlerinde üretimi durdurdu.
Düzeltme: Ücretsiz katman ayda 10 taslak sunar. Bu sınıra ulaştığınızda, taslaklar bir sonraki aya kadar duraklar. Pro ve Team için taslak sınırı yoktur. Herhangi bir planda, posta kutusunun Aylık Belirteç Bütçesi kullanılmış, bu yüzden o ayarı da kontrol edin (0 bütçe yok anlamına gelir).
İstem önbelleğe alma aylık token sayısını değiştirmez
Belirti: tekrarlanan taslaklar sağlayıcı istem önbelleğe alımı için uygun görünür, ancak ReplyRabbit'in token kullanımı hâlâ tam giriş ve çıkış toplamını gösterir.
Düzeltme: bu beklenen bir durumdur. ReplyRabbit aylık bütçeleri tutucu tutar ve bir sağlayıcı önbelleğe alınmış girdiyi farklı faturalandırsa bile toplam tokenları sayar. Sağlayıcı önbellek tasarrufları sağlayıcıya, modele, tekrarlanan istem öneklerine ve sağlayıcı raporlamasına bağlıdır. Anthropic önbellek kontrolü yalnızca uygun tekrarlanan taslak çalışmaları için kullanılır ve desteklenmediğinde normal üretime geri döner.
Linear biletleri oluşturulmuyor
Belirti: sonraki eylemler algılanır, ancak hiçbir Linear bileti oluşturulmaz.
Düzeltme: ReplyRabbit ayarlarında Linear API anahtarını, seçili ekibi ve biletlerin onay bekleyen bir durumda bekleyip beklemediğini kontrol edin. Ayrıca katmanınızın Linear içerdiğini doğrulayın: manuel Linear bileti oluşturma bir Pro özelliğidir ve otomatik bilet oluşturma bir Team özelliğidir.
Jira sorunları oluşturulmuyor
Belirti: bir konuşma mühendislik işi gerektirir, ancak hiçbir Jira sorunu oluşturulmaz.
Düzeltme: ReplyRabbit ayarlarında Jira'nın posta kutusu sorun izleyicisi olarak seçildiğini doğrulayın. Jira Cloud site URL'sini, hesap e-postasını, API tokenını, varsayılan projeyi ve varsayılan sorun türünü kontrol edin. Ayrıca katmanınızın sorun oluşturmayı içerdiğini doğrulayın: manuel Jira sorunu oluşturma bir Pro özelliğidir ve otomatik sorun oluşturma bir Team özelliğidir. Tam kurulum yolu için bakın: Jira entegrasyonu.
Workflow Etiketleri uygulanmıyor
Belirti: şu gibi etiketler bekliyordunuz: rr_priority_critical, rr_no_reply_needed, veya rr_linear_issue_created, ancak konuşmada ReplyRabbit etiketi yok.
Düzeltme: posta kutusunun ReplyRabbit ayarlarını açın ve doğrulayın: İş akışı eşitlemesini etkinleştir ve FreeScout etiketlerini uygula şurada açık: Workflow Etiketleri bölüm. Sinyal etiketleri eksikse, onaylayın AI Signals açık ve konuşma analiz edildi. Linear etiketleri eksikse konuşmanın ReplyRabbit tarafından oluşturulmuş bir Linear sorunu olduğunu doğrulayın.
FreeScout Workflows tarifleri çalışmıyorsa, önce ReplyRabbit'in beklenen FreeScout etiketini eklediğini doğrulayın. Ardından yüklü Workflows modülünüzün programatik etiket değişikliklerine tepki verip vermediğini test edin. ReplyRabbit etiketleri uygulayabilir, ancak bir tarifin bu etiket değişikliğinden çalışıp çalışmayacağını Workflows modülü kontrol eder.
Bilgi kaynakları: bir taslak yardım sayfalarımı, Bilgi Tabanını, ürünleri veya önceki yanıtları kullanmadı
Belirti: bir taslak, yardım sayfalarınızda, Knowledge Base'inizde, ürün listenizde veya önceki yanıtlarınızda olduğunu bildiğiniz bilgileri yok saydı.
Düzeltme: yanıt düzenleyicideki taslağın altındaki satırla başlayın. Taslağın ne kullandığını listeler, örneğin "Dahil edilen: 2 yardım sayfası, 1 Bilgi Bankası makalesi, bu müşteriye 3 önceki yanıt". Bağlantıları görmek için tıklayın, ayrıca hiçbir şey eklemeyen her açık kaynak için bir not:
- Açık ama henüz dizinlenmiş bir şey yok: dizin oluşturma tamamlanmadı. Kuyruk çalışanını kontrol edin (aşağıya bakın), ardından dizin oluşturmanın tamamlanmasını bekleyin.
- Bu mesaj için iyi bir eşleşme yok: kaynak uygun, ancak içindeki hiçbir şey bu müşterinin mesajıyla yeterince yakından eşleşmedi. Bu tür soruları yanıtlayan içerik ekleyin veya iyileştirin.
- Arama sınırının üzerindeki dizin: dizin 6.000 dizinlenmiş bölümü geçtiğinde, yalnızca anahtar kelime eşleştirme çalışır, anlam tabanlı eşleştirme değil. İhtiyacınız olmayan kaynakları kaldırarak sınırın altına geri getirin.
- Planınız bunu içermiyor: bu kaynak mevcut planınızda kullanılamıyor.
- Bilgi Tabanı modülü kurulu veya etkin değil: şurada yükleyin veya etkinleştirin: Yönet > Modüller.
Kurulum durumu uyarıları
Posta kutusu ayarlarındaki kurulum durumu başlığı artık şu durumlarda uyarır:
- Kuyruk çalışanı çalışmıyor gibi görünüyor. Dizinleme ve otomatik taslaklar bu olmadan asla tamamlanmaz. FreeScout kuyruğu cron işi aracılığıyla çalıştırır
php artisan schedule:runveya birqueue:worksüreç, bu yüzden bunlardan birinin kurulu olduğundan emin olun. - Hiçbir bilgi kaynağı açık değil. Posta kutusu ayarları, Bilgi kaynakları altında en az birini açın.
- Bir kaynak açık ancak henüz dizinlenmedi. Dizine eklemenin tamamlanmasına izin verin.
Web sitesi kaynakları
- Tarama varsayılan olarak 200 sayfada durur ve kaynak artık bunu belirtiyor, sınırı yükseltmek için bir düğmeyle birlikte. Ayarlarınızı sonra kaydedin, ardından tekrar tarayın.
- Okunamayan sayfalar bir nedenle sayılır, örneğin site tarafından engellendi (403), bulunamadı (404), çok fazla istek (429), bir sunucu hatası, çok büyük veya okunabilir metin yok (genellikle JavaScript ile oluşturulmuş bir sayfa). Barındırıcınızdan tarayıcının geçmesine izin vermesini isteyin veya kaynağı JavaScript gerektirmeyen sayfalara yönlendirin.
- Çok uzun sayfalar yaklaşık 24.000 karaktere kısaltılır. Anlamsal eşleştirme açıkken kaynak, kaç sayfanın kısaltıldığını gösterir. İhtiyacınız olan kısım sona yakınsa uzun sayfaları bölün.
Ana hat ve anlama dayalı eşleştirme
- Outline eşitlemesi 1.000 belgede durur. Bunun ötesindeki belgeler eşitlenmez.
- Anlam tabanlı (semantik) eşleştirme bir gömme sağlayıcısı gerektirir. Bazı gömme modelleri henüz yalnızca anlam eşleşmeleri için kalibre edilmemiştir ve bir uyarı gösterir, bu uyarıyı görürseniz farklı bir gömme modeline geçin.
Hâlâ takıldınız mı?