استكشاف أخطاء الرفيق بالذكاء الاصطناعي

المشاكل الشائعة وحلولها لـ الرفيق بالذكاء الاصطناعي. إن واجهت مشاكل، ابدأ من هنا.

عدم ظهور الاقتراحات

التحقق من حالة الرفيق بالذكاء الاصطناعي

المشكلة: توقفت الاقتراحات عن الظهور.

الحلول:

1. انتقل إلى إعدادات الرفيق بالذكاء الاصطناعي
2. تحقق من أن مفتاح الحالة يعرض Active (وليس Paused)
3. إن كان متوقفاً، انقر لتفعيله
4. تحقق من بقاء التكوين

التحقق من مصدر آخر رسالة

المشكلة: الاقتراح لا يُنشأ لردك.

السبب: الرفيق بالذكاء الاصطناعي ينشئ اقتراحات فقط عندما تكون آخر رسالة من العميل.

الحلول:

• انتظر رد العميل
• الاقتراحات تُنشأ تلقائياً على رسائل العملاء
• ردودك لا تحفّز الاقتراحات

التحقق من صلاحية مفتاح API

المشكلة: مفتاح API قد يكون غير صالح أو منتهي الصلاحية.

الأعراض:

• توقفت الاقتراحات عن الظهور
• لا تظهر رسائل خطأ
• التكوين يبدو صحيحاً

الحلول:

1. انتقل إلى إعدادات الرفيق بالذكاء الاصطناعي
2. انقر تحرير على API Key
3. تحقق من صحة المفتاح (بدون مسافات زائدة)
4. اختبر المفتاح في وحدة المزوّد
5. أنشئ مفتاحاً جديداً إن لزم
6. حدّث في الإعدادات

مراجعة حالة حساب المزوّد

المشكلة: قد تكون هناك مشاكل في حساب المزوّد.

تحقق من:

• حالة الفواتير - الحساب لديه طريقة دفع فعّالة
• الرصيد/الحصة - رصيد كافٍ متاح
• حالة الحساب - الحساب فعّال وغير موقوف
• حدود الاستخدام - عدم تجاوز الحدود

الحلول:

1. سجّل الدخول إلى وحدة المزوّد
2. تحقق من حالة الحساب والفواتير
3. تحقق من توفر الرصيد/الحصة
4. راجع حدود الاستخدام
5. أضف طريقة دفع إن لزم
6. تواصل مع دعم المزوّد إن استمرت المشكلة

مشاكل جودة الاقتراحات

التحقق من رابط قاعدة المعرفة

المشكلة: الاقتراحات لا تشير إلى وثائقك.

تحقق من:

• صحة رابط قاعدة المعرفة
• إمكانية الوصول العام للرابط
• فهرسة المحتوى من محركات البحث
• تطابق النطاق مع موقع الوثائق

الحلول:

1. اختبر الرابط في متصفح التصفح الخاص (يُحمّل دون تسجيل دخول)
2. تحقق من أن صيغة الرابط تتضمن https://
3. تحقق من ظهور المحتوى في بحث Google
4. حدّث الرابط إن نُقلت الوثائق
5. تأكد من إمكانية الوصول العام للمحتوى

مراجعة جودة محتوى قاعدة المعرفة

المشكلة: الاقتراحات غير دقيقة أو قديمة.

أسباب محتملة:

• الوثائق قديمة
• المحتوى لا يطابق منتجاتك/خدماتك
• المعلومات غير صحيحة
• البنية غير واضحة

الحلول:

1. راجع الوثائق وحدّثها
2. تأكد من دقة المحتوى
3. حسّن تنظيم المحتوى
4. أضف المعلومات الناقصة
5. أبقِ الوثائق محدثة

فكّر في تغيير المزوّد

المشكلة: جودة اقتراحات ضعيفة باستمرار.

متى تغيّر:

• الاقتراحات غير دقيقة غالباً
• النبرة لا تطابق هويتك
• الردود عامة جداً
• المزوّد لا يلبي احتياجاتك

كيف تغيّر:

1. انتقل إلى إعدادات الرفيق بالذكاء الاصطناعي
2. انقر تحرير على Provider
3. اختر المزوّد الجديد
4. أدخل مفتاح API للمزوّد الجديد
5. احفظ التغييرات

توصيات المزوّدين:

• OpenAI - أفضل جودة إجمالية
• Anthropic - سريع وفعّال
• Gemini - اقتصادي
• Grok - خيار بديل

مراجعة سياق المحادثة

المشكلة: الاقتراحات لا تطابق سياق المحادثة.

تحقق من:

• اكتمال سجل المحادثة
• وضوح سؤال العميل
• أن الرسائل السابقة توفّر السياق
• عدم نقص معلومات

الحلول:

• تأكد من سجل المحادثة الكامل
• تحقق من ترتيب الرسائل
• راجع نقص السياق
• قدّم تفاصيل أكثر إن لزم

أخطاء مفتاح API

صيغة مفتاح غير صالحة

المشكلة: صيغة مفتاح API غير صحيحة.

الأعراض:

• رسالة خطأ حول مفتاح غير صالح
• المفتاح غير مقبول أثناء الإعداد
• الاقتراحات لا تُنشأ

الحلول:

1. تحقق من تطابق صيغة المفتاح مع المزوّد:
   • OpenAI: يبدأ بـ sk-proj- أو sk-
   • Anthropic: يبدأ بـ sk-ant-
   • Grok: يبدأ بـ grok-
   • Gemini: يبدأ بـ AIza
2. تحقق من المسافات الزائدة (انسخ/الصق بعناية)
3. تأكد من نسخ المفتاح كاملاً
4. أنشئ مفتاحاً جديداً إن كانت الصيغة خاطئة

مفاتيح منتهية أو ملغاة

المشكلة: المفتاح لم يعد يعمل.

الأعراض:

• توقفت الاقتراحات عن العمل
• رسائل خطأ حول المصادقة
• المفتاح أُلغي في وحدة المزوّد

الحلول:

1. سجّل الدخول إلى وحدة المزوّد
2. تحقق من حالة المفتاح
3. أنشئ مفتاح API جديد
4. حدّث في إعدادات الرفيق بالذكاء الاصطناعي
5. ألغِ المفتاح القديم لأسباب أمنية

صلاحيات غير كافية

المشكلة: المفتاح لا يملك الصلاحيات المطلوبة.

تحقق من:

• تفعيل وصول API للمفتاح
• منح النطاقات/الصلاحيات المطلوبة
• مستوى الوصول اللازم للحساب

الحلول:

1. راجع صلاحيات المفتاح في وحدة المزوّد
2. تأكد من تفعيل وصول API
3. أنشئ مفتاحاً جديداً بالصلاحيات الصحيحة
4. حدّث في الإعدادات

رموز أخطاء خاصة بالمزوّد

أخطاء OpenAI:

• 401 - مفتاح API غير صالح
• 429 - تجاوز حد المعدل
• 500 - خطأ خادم
• راجع صفحة حالة OpenAI

أخطاء Anthropic:

• 401 - مفتاح API غير صالح
• 429 - تجاوز حد المعدل
• 500 - خطأ خادم
• راجع حالة Anthropic

أخطاء Grok:

• 401 - مفتاح API غير صالح
• 429 - تجاوز حد المعدل
• راجع وحدة xAI للحالة

أخطاء Gemini:

• 400 - طلب غير صالح
• 403 - مفتاح API غير صالح أو تجاوز الحصة
• راجع حالة Google Cloud

أسئلة الفواتير

فهم التكاليف

السؤال: كم يكلف الرفيق بالذكاء الاصطناعي؟

الجواب:

• SupportRetriever لا يتقاضى مقابل استخدام AI
• تدفع لمزوّد AI مباشرة
• تكلفة تقريبية: 0.005–0.03 دولار لكل اقتراح
• التكاليف الشهرية تختلف حسب الحجم

تقدير التكاليف:

• 100 رسالة/يوم: نحو 15–45 دولاراً/شهر
• 500 رسالة/يوم: نحو 75–225 دولاراً/شهر
• 1000 رسالة/يوم: نحو 150–450 دولاراً/شهر

مراقبة الاستخدام

كيف تراقب:

1. سجّل الدخول إلى وحدة المزوّد
2. تحقق من لوحة الاستخدام
3. راجع سجلات استدعاءات API
4. اضبط تنبيهات الاستخدام
5. راقب الإنفاق بانتظام

رسوم غير متوقعة

المشكلة: تكاليف أعلى من المتوقع.

تحقق من:

• زيادة حجم الاستخدام
• عمليات بحث قاعدة المعرفة تضيف تكلفة
• تغيّر تسعير المزوّد
• عدم تعيين حدود استخدام

الحلول:

1. راجع الاستخدام في لوحة المزوّد
2. اضبط حدود/تنبيهات الاستخدام
3. راقب التكاليف بانتظام
4. فكّر في تغيير المزوّد إن كانت التكاليف عالية
5. حسّن استخدام قاعدة المعرفة

مشاكل التكوين

عدم حفظ الإعدادات

المشكلة: التغييرات لا تبقى.

الحلول:

1. حدّث الصفحة وحاول مرة أخرى
2. تحقق من اتصال الإنترنت
3. تحقق من صيغ الحقول (الرابط، مفتاح API)
4. تحقق من وحدة التحكم في المتصفح للأخطاء
5. جرّب متصفحاً آخر

فقدان التكوين

المشكلة: اختفت الإعدادات.

أسباب محتملة:

• حُذف التكوين
• مشكلة في الحساب
• مشكلة في قاعدة البيانات

الحلول:

1. تحقق من بقاء التكوين
2. تحقق من تسجيل الدخول إلى الحساب الصحيح
3. جرّب الإعداد من جديد
4. تواصل مع الدعم إن استمرت المشكلة

مشاكل قاعدة المعرفة

عدم العثور على قاعدة المعرفة

المشكلة: AI لا يستطيع الوصول إلى قاعدة المعرفة.

تحقق من:

• صحة الرابط وإمكانية الوصول
• إمكانية الوصول العام للنطاق
• الموقع ليس خلف مصادقة
• فهرسة المحتوى من محركات البحث

الحلول:

1. اختبر الرابط في متصفح التصفح الخاص
2. تحقق من الوصول العام (بدون تسجيل دخول)
3. تحقق من ظهور المحتوى في بحث Google
4. تأكد من تضمين الرابط لـ https://
5. حدّث الرابط إن نُقلت الوثائق

عدم استخدام قاعدة المعرفة

المشكلة: الاقتراحات لا تشير إلى الوثائق.

تحقق من:

• تكوين رابط قاعدة المعرفة
• صحة الرابط وإمكانية الوصول
• إمكانية البحث في المحتوى
• تطابق النطاق مع موقع الوثائق

الحلول:

1. تحقق من رابط قاعدة المعرفة في الإعدادات
2. اختبر إمكانية الوصول للرابط
3. تأكد من فهرسة المحتوى
4. حدّث الرابط إن لزم
5. راجع سلوك المزوّد المحدد

مشاكل الأداء

بطء إنشاء الاقتراحات

المشكلة: الاقتراحات تأخذ وقتاً طويلاً للظهور.

أسباب محتملة:

• زمن استجابة API المزوّد
• سجل محادثة طويل
• تأخير بحث قاعدة المعرفة
• مشاكل شبكة

الحلول:

1. تحقق من صفحة حالة المزوّد
2. قلّل طول سجل المحادثة (إن أمكن)
3. حسّن محتوى قاعدة المعرفة
4. تحقق من اتصال الشبكة
5. فكّر في مزوّد أسرع (Anthropic، Gemini)

انتهاء وقت الاقتراحات

المشكلة: فشل إنشاء الاقتراحات.

الحلول:

1. تحقق من حالة المزوّد
2. تحقق من صلاحية مفتاح API
3. تحقق من رصيد/حصة الحساب
4. راجع رسائل الخطأ
5. جرّب لاحقاً إن كانت المشكلة مؤقتة

الحصول على المساعدة

لا تزال تواجه مشاكل؟

إن استمرت المشاكل:

1. راجع هذا الدليل - راجع الأقسام ذات الصلة
2. راجع الإعدادات - تحقق من التكوين
3. اختبر المزوّد - تحقق من حالة المزوّد
4. تواصل مع الدعم - اطلب المساعدة

موارد مفيدة

• ما هو الرفيق بالذكاء الاصطناعي - نظرة على الميزة
• إعداد الرفيق بالذكاء الاصطناعي - دليل الإعداد
• إدارة الرفيق بالذكاء الاصطناعي - إدارة التكوين
• صفحات حالة ووثائق المزوّدين

مواضيع ذات صلة

• إعداد الرفيق بالذكاء الاصطناعي - استكشاف أخطاء الإعداد
• إدارة الرفيق بالذكاء الاصطناعي - مشاكل التكوين
• استخدام اقتراحات AI - أسئلة الاستخدام
• أمان وخصوصية الرفيق بالذكاء الاصطناعي - مشاكل أمنية