إدارة إعدادات الرفيق الذكي (الرفيق بالذكاء الاصطناعي)

حدّث إعداد الرفيق الذكي، غيّر المزودين، عدّل الإعدادات، وأدر مساعد الذكاء الاصطناعي بعد الإعداد الأولي.

الوصول إلى الإعدادات

1. سجّل الدخول إلى لوحة تحكم SupportRetriever
2. انتقل إلى الرفيق الذكي من الإعدادات أو زر /ai-companion
3. اعرض الإعداد الحالي

تعرض صفحة الإعدادات:

• مفتاح الحالة — تفعيل أو إيقاف الرفيق الذكي
• تفاصيل الإعداد — الاسم، المزود، مفتاح API، قاعدة المعرفة، MCP (اختياري)
• خيارات الإدارة — تعديل، حذف، تحديث الإعدادات

مفتاح التفعيل/الإيقاف

إيقاف أو استئناف الرفيق الذكي بسرعة:

1. ابحث عن مفتاح الحالة أعلى قسم الإعداد
2. انقر للتبديل بين نشط و متوقف
3. التغييرات تُطبَّق فوراً

عند التوقف:

• لا تُنشأ اقتراحات جديدة
• الاقتراحات الحالية تبقى ظاهرة
• الإعداد محفوظ
• سهل الاستئناف لاحقاً

عند النشاط:

• الاقتراحات تُنشأ تلقائياً
• يعمل بشكل طبيعي لجميع المحادثات

تعديل الإعداد

التعديل المضمن

معظم الحقول تدعم التعديل المضمن:

1. انقر أيقونة التعديل (قلم) بجانب أي حقل
2. أجرِ التغييرات
3. انقر علامة الصح للحفظ أو X للإلغاء

تغيير اسم الرفيق

1. انقر تعديل بجانب اسم الذكاء الاصطناعي
2. أدخل الاسم الجديد (حتى 50 حرفاً)
3. احفظ التغييرات

الاسم الجديد يظهر في رؤوس الاقتراحات فوراً.

تغيير المزود

1. انقر تعديل بجانب المزود
2. اختر المزود الجديد من القائمة
3. مهم: ستحتاج إدخال مفتاح API للمزود الجديد
4. احفظ التغييرات

تحديث مفتاح API

1. انقر تعديل بجانب مفتاح API
2. أدخل مفتاح API الجديد
3. احفظ التغييرات

مفتاح API يُشفَّر قبل التخزين. المعاينة تعرض نسخة مقنّعة (مثلاً sk-proj-...abc123).

متى تحدّث:

• انتهت صلاحية المفتاح أو أُبطِل
• تدوير أمني (أفضل ممارسة سنوية)
• تغيير المزود
• تعرّض المفتاح للاختراق

تعديل عنوان URL لقاعدة المعرفة

1. انقر تعديل بجانب عنوان URL لقاعدة المعرفة
2. أدخل عنوان URL جديد أو اتركه فارغاً للإزالة
3. احفظ التغييرات

الاقتراحات الجديدة تستخدم قاعدة المعرفة المحدّثة فوراً.

ضبط MCP

يمكنك اختيارياً إضافة نقطة نهاية MCP (Model Context Protocol) ليتمكن الذكاء الاصطناعي من جلب سياق إضافي (مثل بيانات المستخدم أو الحساب) عند إنشاء الاقتراحات. انقر تعديل بجانب MCP، ثم أدخل عنوان URL للنقطة النهائية (HTTPS)، مفتاح السرّ، ومخطط JSON لجسم الطلب. اربط كل خاصية في المخطط باسم العميل أو بريد العميل أو مفتاح بيانات وصفية من إرسالات النموذج. للخطوات الكاملة والأمثلة، راجع ضبط MCP.

حذف الإعداد

إزالة إعداد الرفيق الذكي نهائياً:

1. مرّر إلى أسفل قسم الإعداد
2. انقر حذف الإعداد
3. أكد الحذف في النافذة المنبثقة
4. يُزال الإعداد نهائياً

ما يحدث عند الحذف:

• يُزال الإعداد نهائياً
• يُحذف مفتاح API المشفّر
• لا تُنشأ اقتراحات جديدة
• الاقتراحات الحالية تبقى ظاهرة
• يمكنك الإعداد من جديد في أي وقت

أفضل الممارسات

مراقبة فوترة المزود

أعد تنبيهات الاستخدام في حساب مزود الذكاء الاصطناعي:

• OpenAI: حدود وتنبيهات الاستخدام في إعدادات الحساب
• Anthropic: تنبيهات الفوترة في لوحة التحكم
• Grok: مراقبة الاستخدام في لوحة التحكم
• Gemini: حدود الحصة في Google Cloud Console

تدوير مفاتيح API سنوياً

لأفضل ممارسات الأمان:

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

حافظ على قاعدة المعرفة محدثة

حدّث عنوان URL لقاعدة المعرفة بانتظام:

• عند نقل التوثيق
• عند تغيير البنية
• عند إضافة محتوى جديد
• لضمان أحدث المعلومات

راجع جودة الاقتراحات

راجع جودة الاقتراحات دورياً:

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

تفاصيل الإعداد

الحالة الحالية

تعرض صفحة الإعدادات:

• اسم الذكاء الاصطناعي — اسم الرفيق
• المزود — مزود الذكاء الاصطناعي الحالي
• معاينة مفتاح API — نسخة مقنّعة من المفتاح المشفّر
• عنوان URL لقاعدة المعرفة — عنوان التوثيق (إن مُضبط)
• MCP — نقطة النهاية الاختيارية وتخطيط المخطط (إن مُضبط)
• الحالة — نشط أو متوقف

مؤشرات الحالة

• نشط — مفتاح أخضر، الاقتراحات تُنشأ
• متوقف — مفتاح رمادي، الاقتراحات متوقفة
• غير مُعدّ — يُعرض معالج الإعداد

استكشاف أخطاء الإعدادات

التغييرات لا تُحفظ

تحقق من:

• اتصال الإنترنت
• وحدة تحكم المتصفح للأخطاء
• تنسيق مفتاح API (إن كنت تحدّثه)
• تنسيق العنوان (إن كنت تحدّث قاعدة المعرفة)

الحل:

• حدّث الصفحة وحاول مرة أخرى
• تحقق من تنسيقات الحقول
• راجع وحدة تحكم المتصفح

مفتاح API لا يعمل بعد التحديث

تحقق من:

• صحة المفتاح (بدون مسافات زائدة)
• تطابق المزود مع المزود المختار
• وجود رصيد/حصة في الحساب
• أن المفتاح لم تنتهِ صلاحيته

الحل:

• تحقق من المفتاح في لوحة المزود
• اختبر بمفتاح جديد
• تحقق من حالة حساب المزود

قاعدة المعرفة لا تتحدّث

تحقق من:

• صحة العنوان وإمكانية الوصول
• تضمين التنسيق https://
• أن النطاق متاح للعموم

الحل:

• اختبر العنوان في المتصفح
• تحقق من الوصول العام
• تحقق من تنسيق العنوان

إعادة الإعداد بعد الحذف

إن حذفت الإعداد وترغب بالإعداد من جديد:

1. اذهب إلى إعدادات الرفيق الذكي
2. انقر ابدأ
3. اتبع معالج الإعداد
4. أدخل الإعداد الجديد

يمكنك الإعداد بنفس المزود أو مزود مختلف، واسم وقاعدة معرفة مختلفة.

الإعداد المتقدم

إعدادات خاصة بالمزود

بعض المزودين يوفّرون إعدادات إضافية في لوحاتهم:

• حدود الاستخدام — حد أقصى لاستدعاءات API
• حدود المعدل — التحكم في تردد الطلبات
• اختيار النموذج — اختيار نماذج محددة (إن متاحة)

اضبطها في لوحة المزود، وليس في SupportRetriever.

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

لتحسين استخدام قاعدة المعرفة:

• حافظ على التوثيق محدثاً
• استخدم محتوى واضحاً وقابلاً للبحث
• نظّم المحتوى منطقياً
• تأكد من إتاحة الوصول العام

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

• إعداد الرفيق الذكي — دليل الإعداد الأولي
• اختيار مزود ذكاء اصطناعي — مقارنة المزودين
• ضبط قاعدة المعرفة — إعداد قاعدة المعرفة
• ضبط MCP — نقطة نهاية MCP الاختيارية وتخطيط الحقول
• أمان وخصوصية الرفيق الذكي — تفاصيل الأمان
• استكشاف أخطاء الرفيق الذكي — المشاكل الشائعة