الإعدادات
إعدادات السلوك
تغطي هذه الصفحة تبويب Settings → Behavior، حيث يضبط المسؤول كيفية سلوك المساعد: مدى التزامه الصارم بالنطاق، والنموذج المسؤول عن المهام الخلفية، ومعدل إعادة فهرسة قاعدة المعرفة، وحدود المعدل، ورسائل التفاعل، والوصول حسب مجموعة العميل، وضبط الاسترجاع.
انتقل إلى Addons → AI Copilot Suite → Settings → Behavior. تضم قائمة Categories الجانبية سبعة أقسام: Scope Guard (site-only answers)، Models & Tokens، Indexing، Rate Limits، Engagement، Access control، وRAG retrieval.
Scope Guard (site-only answers)
يتحكم في مدى التزام المساعد الصارم بمحتوى موقعك.
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Scope strength | scope_strength |
قائمة اختيار، مثل "3 — Balanced — recommended for WHMCS support" | 3 |
| Refusal message | refusal_message |
نص متعدد الأسطر، نص بديل "Leave empty to use the built-in localized message" | فارغ |
يعرض كل مستوى من قوة النطاق وصفاً خاصاً به في الواجهة. بالنسبة للمستوى 3 ("Balanced")، توضّح اللوحة: "Default: blocks creative off-topic; product/ticket follow-ups only; polite refusal; suspend after 3 off-topic messages." وتسرد الحدود المطبَّقة (رفض مهذّب + إعادة توجيه، تعليق بعد N مخالفات، وحدود التشابه الأساسية).
Tip
ارفع Scope strength إذا بدأ المساعد بالإجابة عن أسئلة معرفة عامة لا علاقة لها بنشاط الاستضافة الخاص بك. اخفضه فقط إذا كانت أسئلة مشروعة وذات صلة تُرفَض خطأً.
Models & Tokens
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Auxiliary (cheap) provider | aux_provider_id |
قائمة اختيار — "Automatic (use main chain)" أو مزوّد محدد | Automatic |
| Max reply tokens | max_output_tokens |
رقم | 500 |
| Response cache TTL (hours) | cache_ttl_hours |
رقم | 24 |
يُستخدم Auxiliary (cheap) provider للتصنيف والتلخيص — اختر هنا نموذجاً رخيصاً وسريعاً، منفصلاً عن مزوّد المحادثة الرئيسي المُسنَد لكل مساعد.
Indexing
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Reindex interval (hours) | reindex_hours |
رقم | 24 |
| Pages per cron tick | — | رقم | 8 |
| Allow self-signed TLS when crawling (dev only) | — | مفتاح تبديل | معطَّل |
Warning
فعّل Allow self-signed TLS when crawling فقط في بيئات محلية/تطويرية (مثل MAMP) بشهادة موقَّعة ذاتياً. يؤدي تركه مفعَّلاً في الإنتاج إلى تقليل أمان عملية زحف المحتوى.
Rate Limits
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Messages per IP / 5 min | rate_ip_max |
رقم | 30 |
| Messages per session / min | rate_session_max |
رقم | 10 |
| Embed: requests per IP / 5 min | — | رقم | 20 |
| Embed: messages per session / min | — | رقم | 8 |
| Auto-ban IP on rate-limit breach | ip_block_enabled |
مفتاح تبديل | معطَّل |
| Auto-ban duration (seconds) | ip_block_duration |
رقم (الحد الأدنى 60) | 3600 |
تنطبق حدود Embed فقط على حركة embed_api.php (ويدجت التضمين الخارجي) وهي أكثر صرامة، لأن تلك الحركة من الزوّار فقط. عند تفعيل Auto-ban IP on rate-limit breach، يؤدي تجاوز حد معدل IP إلى إضافة العنوان إلى قائمة الحظر للمدة المحددة. راجع الأمان وحدود المعدل لقائمة عناوين IP المحظورة وإجراء إلغاء الحظر.
Engagement
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Guest lead capture (name + email) | lead_capture_enabled |
مفتاح تبديل | معطَّل |
| Proactive re-engagement | reengagement_enabled |
مفتاح تبديل | معطَّل |
| Inactivity timeout (seconds) | reengagement_idle_seconds |
رقم | 120 |
| Follow-up message (English) | — | نص | "Are you still there? Need any more help?" |
| Follow-up message (Arabic) | — | نص | هل ما زلت هنا؟ هل تحتاج مساعدة إضافية؟ |
| Auto-close idle conversations (hours) | conversation_auto_close_hours |
رقم، 0 = معطَّل |
0 |
يتطلب Guest lead capture من الزوّار إرسال اسمهم وبريدهم الإلكتروني قبل الدردشة؛ وتُرفَق تلك البيانات بأي تصعيد لاحق. يرسل Proactive re-engagement رسالة المتابعة إلى العميل الذي ترك لوحة الدردشة مفتوحة دون رد لفترة الخمول المحددة. يعمل Auto-close idle conversations عبر cron ويغلق المحادثات النشطة التي لا نشاط فيها للعدد المحدد من الساعات.
Access control
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| مجموعات العملاء المستثناة من المساعد | disable_ai_client_groups[] |
قائمة مربعات اختيار لمجموعات عملاء WHMCS | لا شيء محدد |
"Checked groups will not see the chat widget or API (logged-in clients only)." إذا لم يحتوِ تثبيت WHMCS لديك على مجموعات عملاء مهيَّأة بعد، تعرض هذه اللوحة عبارة "No client groups found in WHMCS." بدلاً من قائمة مربعات الاختيار.
RAG retrieval
RAG اختصار لـ Retrieval-Augmented Generation — عملية البحث في قاعدة معرفتك عن محتوى ذي صلة قبل أن يصوغ الذكاء الاصطناعي إجابة. تضبط هذه اللوحة كيفية استرجاع أجزاء المعرفة لردود الويدجت ومساعد التذاكر.
| الاسم الودّي | الاسم النظامي | النوع | الافتراضي |
|---|---|---|---|
| Top K chunks | rag_top_k |
رقم (1–20) | 4 |
| Minimum similarity | rag_min_similarity |
عدد عشري (0.05–0.95) | 0.3 |
| Lexical weight | rag_lexical_weight |
عدد عشري (0 = اعتماد على المتجهات فقط) | 0.25 |
| الامتناع عند فراغ الاسترجاع | rag_abstain_when_empty |
مفتاح تبديل | مفعّل |
| اقتباس المصادر في الردود | rag_cite_sources |
مفتاح تبديل | مفعّل |
| Enable retrieval test panel | rag_debug_enabled |
مفتاح تبديل | معطَّل |
Top K chunks هو عدد أجزاء المعرفة المُدرَجة في كل رد مستند إلى المعرفة. Lexical weight يمزج تطابق الكلمات/العناوين مع التشابه المتجهي. عند تفعيل الامتناع عند فراغ الاسترجاع يرفض المساعد اختلاق إجابات للزوار بلا مصدر معرف (نوايا الحساب لمستخدم مسجّل قد تستمر عبر الأدوات). عند تفعيل اقتباس المصادر تُلحق الردود المستندة بقائمة مصادر قصيرة.
تعديلات المنتجات والإعلانات في WHMCS تطلق hooks إعادة فهرسة موجّهة لإبقاء الإجابات أحدث دون انتظار دورة cron الكاملة.
Note
تفعيل Enable retrieval test panel يُظهر نموذج استعلام اختباري في شاشة Knowledge، ما يتيح لك رؤية المصادر التي تطابق سؤالاً تجريبياً بالضبط ودرجة صلتها.
الإجراء
اضغط Save أسفل كل قسم لتطبيق التغييرات.
استكشاف الأخطاء
| المشكلة | الحل |
|---|---|
| المساعد يجيب عن أسئلة خارج النطاق | ارفع Scope strength |
| المساعد يرفض أسئلة ذات صلة | اخفض Scope strength؛ تحقق من أن الموضوع مشمول بمصدر معرفة مفهرَس |
| قاعدة المعرفة تبدو قديمة | خفّض Reindex interval (hours)، أو شغّل إعادة فهرسة يدوية من Knowledge |
| الاسترجاع يفوّت محتوى واضح الصلة | ارفع Top K chunks أو اخفض Minimum similarity في RAG retrieval |