استكشاف أخطاء ReplyRabbit وإصلاحها
تعود معظم مشكلات ReplyRabbit إلى أحد ثلاثة أمور: مفتاح API مفقود أو خاطئ، أو استخدام مزود لا تسمح به فئة خطتك، أو ذاكرة تخزين مؤقت قديمة في FreeScout. اعمل عبر القسم المطابق أدناه، حيث تسرد كل مشكلة العَرَض أولًا ثم الإصلاح.
لا تُنشأ أي مسودة
العَرَض: تفتح محادثة، لكن لا تظهر أي مسودة AI ولا يبدو أن شيئًا يحدث.
إصلاح: افتح إعدادات ReplyRabbit لصندوق البريد (صندوق البريد > الإعدادات > ReplyRabbit) وتأكد من اختيار مزوّد وتعيين مفتاح API الخاص به. في الخطة المجانية، المزوّد الوحيد المتاح هو OpenAI، لذا إذا اخترت مزوّداً آخر، فارجع إلى OpenAI أو قم بالترقية. ثم تحقق من أن ReplyRabbit مفعّل لصندوق البريد الذي تعمل فيه، لأن المسودات تُنشأ فقط لصناديق البريد المفعّلة.
مفتاح API غير صالح أو خطأ في المزود
العَرَض: ترى خطأً يذكر مفتاحًا غير صالح أو فشل مصادقة أو مزودًا لا يمكن الوصول إليه.
إصلاح: أعد التحقق من المفتاح بحثًا عن أخطاء إملائية ومسافات زائدة، وتأكد من أنه المفتاح الخاص بالمزود الذي اخترته فعليًا (مفتاح OpenAI لن يعمل مع Anthropic)، وتأكد من أن المفتاح لا يزال لديه رصيد ووصول على لوحة تحكم المزود. المفتاح الذي لا يحتوي على رصيد متبقٍ أو تم إلغاء وصوله ينتج نفس الخطأ.
أخطاء بعد ترقية PHP
العَرَض: بعد ترقية الخادم (على سبيل المثال، إلى Ubuntu 26.04 مع PHP 8.5)، اختبر الاتصال يفشل أو تتوقف المهام الخلفية، ويعرض سجل FreeScout رسائل تنتهي بـ is deprecated since 8.5.
إصلاح: حافظ على تحديث ReplyRabbit ووحداتك الأخرى من إدارة > الوحدات، ثم شغّل php artisan freescout:clear-cache و php artisan queue:restart. يدعم ReplyRabbit PHP 8.0 حتى 8.5. انظر إصلاح أخطاء "deprecated since 8.5" في FreeScout لمعرفة من أي وحدة تأتي الرسالة.
قائمة ReplyRabbit مفقودة
العَرَض: لا يظهر ReplyRabbit في قوائم FreeScout أو إعداداته بعد تثبيته.
إصلاح: تأكد أولاً من تنشيط الوحدة تحت إدارة > الوحدات. ثم أفرغ ذاكرة التخزين المؤقت من جذر FreeScout الخاص بك:
php artisan freescout:clear-cacheإذا كان لا يزال مفقوداً، تحقق من أذونات المستخدم: المستخدم الذي لا يملك صلاحية الوصول إلى صندوق البريد المعني أو إعدادات المسؤول لن يرى خيارات ReplyRabbit.
توقفت المسودات بعد فترة
العَرَض: عملت المسودات في البداية، ثم توقفت عن التوليد لاحقًا في الشهر.
إصلاح: تسمح الخطة المجانية بـ 10 مسودات شهريًا. بمجرد وصولك إلى هذا الحد، تتوقف المسودات حتى الشهر التالي. لا تحتوي Pro وTeam على حد للمسودات. في أي خطة، تتوقف المسودات أيضًا إذا كان ميزانية الرموز المميزة الشهرية مستنفد، لذا تحقق من ذلك الإعداد أيضًا (0 يعني عدم وجود ميزانية).
التخزين المؤقت للمطالبات لا يغيّر عدد الرموز الشهري
العَرَض: تبدو المسودات المتكررة مؤهلة للتخزين المؤقت لمطالبات المزود، لكن استخدام الرموز في ReplyRabbit لا يزال يُظهر إجمالي الإدخال والإخراج الكامل.
إصلاح: هذا متوقع. يحافظ ReplyRabbit على ميزانيات شهرية متحفظة ويحسب إجمالي الرموز، حتى عندما يفوتر المزود الإدخال المخزن مؤقتًا بشكل مختلف. تعتمد وفورات ذاكرة التخزين المؤقت للمزود على المزود والنموذج وبادئات المطالبات المتكررة وتقارير المزود. يُستخدم التحكم في ذاكرة التخزين المؤقت في Anthropic فقط لعمل المسودات المتكرر المؤهل ويعود إلى التوليد العادي عند عدم الدعم.
تذاكر Linear لا تُنشأ
العَرَض: يتم اكتشاف الإجراءات التالية، ولكن لا يتم إنشاء تذكرة Linear.
إصلاح: في إعدادات ReplyRabbit، تحقق من مفتاح Linear API والفريق المحدد وما إذا كانت التذاكر في حالة معلقة تنتظر التأكيد. تأكد أيضًا من أن خطتك تتضمن Linear: إنشاء تذكرة Linear يدويًا هو ميزة Pro، والإنشاء التلقائي للتذاكر هو ميزة Team.
مشكلات Jira لا تُنشأ
العَرَض: تحتاج محادثة إلى عمل هندسي، لكن لا يتم إنشاء أي مشكلة Jira.
إصلاح: في إعدادات ReplyRabbit، تأكد من تحديد Jira كمتتبع مشكلات صندوق البريد. تحقق من عنوان URL لموقع Jira Cloud والبريد الإلكتروني للحساب ورمز API والمشروع الافتراضي ونوع المشكلة الافتراضي. تأكد أيضًا من أن خطتك تتضمن إنشاء المشكلات: إنشاء مشكلة Jira يدويًا هو ميزة Pro، والإنشاء التلقائي للمشكلات هو ميزة Team. لمسار الإعداد الكامل، انظر تكامل Jira.
لا يتم تطبيق علامات سير العمل
العَرَض: الوسوم التي توقعتها مثل rr_priority_critical, rr_no_reply_needed، أو rr_linear_issue_created، لكن المحادثة لا تحتوي على وسوم ReplyRabbit.
إصلاح: افتح إعدادات ReplyRabbit لصندوق البريد وتأكد من تفعيل مزامنة سير العمل و تطبيق وسوم FreeScout مفعّلة في علامات سير العمل القسم. إذا كانت علامات الإشارة مفقودة، فتأكد من AI Signals قيد التشغيل وتم تحليل المحادثة. إذا كانت وسوم Linear مفقودة، تأكد من أن المحادثة لديها مشكلة Linear أنشأها ReplyRabbit.
إذا لم يتم تفعيل وصفات FreeScout Workflows، تأكد أولاً من أن ReplyRabbit يضيف وسم FreeScout المتوقع. ثم اختبر ما إذا كانت وحدة Workflows المثبتة لديك تتفاعل مع تغييرات الوسوم البرمجية. يمكن لـ ReplyRabbit تطبيق الوسوم، لكن وحدة Workflows تتحكم في ما إذا كانت الوصفة تعمل من تغيير الوسم هذا.
مصادر المعرفة: لم تستخدم مسودة صفحات المساعدة أو قاعدة المعرفة أو المنتجات أو الردود السابقة
العَرَض: تجاهلت مسودة معلومات تعرف أنها موجودة في صفحات المساعدة أو قاعدة المعرفة أو قائمة المنتجات أو الردود السابقة.
إصلاح: ابدأ بالسطر الموجود أسفل المسودة في محرر الرد. يسرد ما استخدمته المسودة، على سبيل المثال "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer". انقر عليه لرؤية الروابط، بالإضافة إلى ملاحظة لكل مصدر مُشغَّل لم يضف شيئًا:
- مفعّل لكن لم تتم فهرسة أي شيء بعد: لم تنته الفهرسة. تحقق من عامل قائمة الانتظار (انظر أدناه)، ثم انتظر اكتمال الفهرسة.
- لا يوجد تطابق جيد لهذه الرسالة: المصدر جيد، لكن لا شيء فيه طابق رسالة هذا العميل بشكل وثيق بما يكفي. أضف أو حسّن المحتوى الذي يجيب على هذا النوع من الأسئلة.
- الفهرس فوق حد البحث: بمجرد أن يتجاوز الفهرس 6000 قسم مفهرس، يتم تشغيل مطابقة الكلمات المفتاحية فقط، وليس المطابقة القائمة على المعنى. قم بإزالة المصادر التي لا تحتاجها لإعادته تحت الحد.
- خطتك لا تتضمنه: هذا المصدر غير متاح في خطتك الحالية.
- وحدة قاعدة المعرفة غير مثبتة أو غير نشطة: قم بتثبيته أو تنشيطه تحت إدارة > الوحدات.
تحذيرات حالة الإعداد
يحذر شريط حالة الإعداد في إعدادات صندوق البريد الآن عندما:
- يبدو أن عامل قائمة الانتظار لا يعمل. لا تكتمل الفهرسة والمسودات التلقائية أبداً بدونه. يشغّل FreeScout قائمة الانتظار عبر مهمة cron
php artisan schedule:runأوqueue:workالعملية، لذا تأكد من إعداد أحدها. - لا يوجد مصدر معرفة مُفعّل. شغّل واحدًا على الأقل في Mailbox settings، Knowledge sources.
- مصدر مفعّل لكنه غير مفهرس بعد. دع الفهرسة تكتمل.
مصادر الموقع الإلكتروني
- يتوقف الزحف عند 200 صفحة افتراضيًا، ويذكر المصدر ذلك الآن، مع زر لرفع الحد. احفظ إعداداتك بعد ذلك، ثم ازحف مرة أخرى.
- تُحتسب الصفحات التي لا يمكن قراءتها مع سبب، على سبيل المثال محظورة من الموقع (403)، أو غير موجودة (404)، أو طلبات كثيرة جداً (429)، أو خطأ في الخادم، أو كبيرة جداً، أو لا يوجد نص قابل للقراءة (غالباً صفحة مبنية بـ JavaScript). اطلب من مضيفك السماح للزاحف بالمرور، أو وجّه المصدر إلى صفحات لا تحتاج إلى JavaScript.
- يتم تقصير الصفحات الطويلة جداً إلى حوالي 24,000 حرف. عند تفعيل المطابقة الدلالية، يعرض المصدر عدد الصفحات التي تم تقصيرها. قسّم الصفحات الطويلة إذا كان الجزء الذي تحتاجه قرب النهاية.
المخطط التفصيلي والمطابقة القائمة على المعنى
- تتوقف مزامنة Outline عند 1,000 مستند. لا تتم مزامنة المستندات التي تتجاوز ذلك.
- تتطلب المطابقة القائمة على المعنى (الدلالية) مزود تضمينات. بعض نماذج التضمين غير معايَرة بعد للمطابقات القائمة على المعنى فقط وتعرض تحذيرًا، لذا بدّل إلى نموذج تضمين مختلف إذا رأيته.
ما زلت عالقًا؟