استكشاف الأخطاء وإصلاحها

تغطي هذه الصفحة أكثر المشكلات شيوعًا التي قد تواجهها عند استخدام شاور وكيفية حلها.

مشكلات إنشاء البوت

فشل اختبار الاتصال

الأعراض: يظهر زر "اختبار الاتصال" علامة X حمراء.

تحقق من التالي بالترتيب:

1. مفتاح API — تأكد من صحته وأنه لم تنتهِ صلاحيته. انسخه والصقه مباشرة من لوحة تحكم المزود
2. اختيار المزود — تأكد من أن المزود يتطابق مع مفتاح API (مثلاً: مفتاح OpenAI لمزود OpenAI)
3. اسم النموذج — تأكد من كتابة اسم النموذج بشكل صحيح وأنه متاح في حسابك
4. رصيد الحساب — تحقق من توفر رصيد أو اشتراك نشط في حساب المزود
5. رابط المزود المخصص — إذا كنت تستخدم مزودًا مخصصًا، تأكد من إمكانية الوصول إلى الرابط الأساسي وأنه يتضمن المسار الصحيح

لا يمكن حفظ البوت

يكون زر إنشاء البوت معطلًا عندما:

• حقل الاسم فارغ
• نموذج المحادثة المُهيَّأ لم يجتز اختبار الاتصال
• نموذج التضمين المُهيَّأ لم يجتز اختبار الاتصال

قم بحل جميع حالات فشل اختبار الاتصال قبل الحفظ.

مشكلات رفع المعرفة

فشل الرفع فورًا

• صيغة الملف — الصيغ المدعومة فقط هي PDF و DOCX و TXT و MD و CSV
• حجم الملف — قد تفشل الملفات الكبيرة جدًا. جرّب تقسيمها إلى مستندات أصغر
• تلف الملف — إذا فشل ملف بشكل متكرر، جرّب فتحه في تطبيقه الأصلي وإعادة حفظه

المستند عالق في حالة "قيد المعالجة"

يعتمد وقت المعالجة على حجم الملف ومحتواه:

• الملفات الصغيرة (أقل من 10 صفحات): 1-2 دقيقة
• الملفات الكبيرة (أكثر من 50 صفحة): حتى 10 دقائق
• الملفات التي تحتوي على صور كثيرة: وقت أطول بكثير

إذا ظل المستند عالقًا لأكثر من 10 دقائق:

1. تحقق من أن اتصال نموذج التضمين لا يزال صالحًا
2. جرّب حذف المستند وإعادة رفعه
3. تحقق من تنسيق المستند — الملفات ذات التنسيق السيئ قد تسبب فشل المعالجة

فشل المعالجة مع ظهور خطأ

الأسباب الشائعة:

• ملف فارغ — المستند لا يحتوي على نص قابل للاستخراج
• ترميز غير مدعوم — يستخدم الملف النصي ترميزًا لا يستطيع النظام معالجته
• ملف PDF تالف — بنية PDF تالفة. أعد تصديره من المصدر الأصلي
• خطأ في نموذج التضمين — أعاد مزود التضمين خطأً. تحقق من مفتاح API والرصيد

مشكلات الردود

البوت يقول "لا أعرف" رغم توفر الإجابة

1. تحقق من قاعدة المعرفة — هل المستند المعني مرفوع وفي حالة "جاهز"؟
2. استخدم وضع التصحيح — فعّل وضع التصحيح في المحادثة لرؤية المستندات المسترجعة. إذا لم يظهر المستند الصحيح:
   • خفّض حد التشابه (جرّب 0.5 بدلًا من 0.7)
   • زِد عدد النتائج الأعلى Top K (جرّب 8-10 بدلًا من 5)
3. تحقق من تنسيق المستند — إذا كان تنسيق المستند سيئًا، قد لا يتمكن البوت من مطابقة السؤال بالقسم الصحيح
4. تحقق من صياغة السؤال — جرّب إعادة صياغة السؤال بما يتوافق مع اللغة المستخدمة في المستند

البوت يعطي إجابات خاطئة أو غير ذات صلة

1. استخدم وضع التصحيح — تحقق من المستندات المسترجعة. إذا كانت مستندات غير ذات صلة تظهر:
   • ارفع حد التشابه (جرّب 0.8)
   • قلّل عدد النتائج الأعلى Top K
   • احذف المستندات غير ذات الصلة من قاعدة المعرفة
2. تحقق من وجود مستندات مكررة أو متناقضة — وجود نسخ متعددة من نفس المستند قد يربك البوت
3. راجع قواعد السلوك — القواعد المتعارضة قد تسبب ردودًا غير متوقعة

البوت لا يرد إطلاقًا

• حالة البوت — هل البوت مضبوط على "نشط"؟
• اتصال نموذج المحادثة — أعد اختبار الاتصال من صفحة الإعدادات
• رصيد API — تحقق من توفر رصيد في حساب المزود

مشكلات المحادثة العامة

خطأ 404 عند زيارة الرابط العام

• يجب أن يكون البوت نشطًا والمحادثة العامة مفعّلة
• تحقق من صحة الرابط المختصر: yourdomain.com/chat/your-slug
• إذا غيّرت الرابط المختصر مؤخرًا، استخدم الرابط الجديد

رسالة "تم تجاوز حد الطلبات"

تجاوز الزائر حدود الرسائل المُعدَّة. الخيارات:

• الانتظار حتى تنتهي فترة تقييد الطلبات
• زيادة حدود الطلبات في إعدادات البوت (إذا كانت الحدود الحالية مقيّدة جدًا)

التضمين لا يعمل على موقع خارجي

• يجب إدراج نطاق الموقع المُضمِّن في النطاقات المسموح بها (Allowed Origins)
• تحقق من صحة رابط التضمين
• تأكد من أن البوت نشط والمحادثة العامة مفعّلة

مشكلات المظهر

تغييرات الهوية البصرية لا تظهر

تُهيَّأ إعدادات الهوية البصرية العامة (اسم الموقع، الشعار) في المشرف > الهوية البصرية. قد تستغرق التغييرات بضع دقائق للانتشار بسبب التخزين المؤقت.

جرّب:

• تحديث الصفحة بالكامل (Ctrl/Cmd + Shift + R)
• مسح ذاكرة التخزين المؤقت للمتصفح
• الانتظار 5 دقائق لانتهاء صلاحية التخزين المؤقت

مرجع الأخطاء