مزود الذكاء الاصطناعي

المكان في لوحة المشرف: System › Settings › AI provider (/settings/ai). مفتاح وحدة الذكاء الاصطناعي موجود هناك وأيضاً في System › Admin › License & updates (/license)، في بطاقة Module.

الوظيفة

إن ميزة AI Chat (دردشة الدعم التلقائي) وAI Agent (إدارة الأجهزة الافتراضية بلغة بسيطة) لا تأتيان مع نموذج مدمج. أنت تختار مزودك الخاص: أي خدمة توفر واجهة chat/completions API متوافقة مع OpenAI — مثل OpenAI أو OpenRouter أو بوابة LiteLLM أو خادم vLLM الخاص بك. يقوم نظام NexCMP بتخزين نقطة النهاية ومفتاح API (مشفرين) واستخدامهما لكل ميزة ذكاء اصطناعي. أنت تدفع للمزود مباشرة.

المتطلبات

العنصر	المتطلب
نقطة النهاية	عنوان URL أساسي متوافق مع OpenAI (https://api.openai.com/v1، https://ai.example.com/v1). يضيف NexCMP /chat/completions إلى عنوان URL ينتهي بـ /v1؛ ولأي عنوان URL آخر يضيف /v1/chat/completions؛ بينما يُستخدم عنوان URL الذي ينتهي بالفعل بـ /chat/completions كما هو.
Model	نموذج يدعم استدعاء الأدوات (الوظائف). يعتمد كل من AI Chat و Agent عليه.
مفتاح API	مفتاح لتلك النقطة النهائية. يُفضل مفتاح ذو حد إنفاق من جانب المزود (مثل مفتاح افتراضي لـ LiteLLM بميزانية شهرية).
الشبكة	يجب أن يتمكن خادم اللوحة من الوصول إلى نقطة النهاية عبر HTTP(S). يُسمح للعنوان المدخل في النموذج بالإشارة إلى الإنترنت فقط عبر المنافذ 80 أو 443 أو 8080 أو 8443؛ ولاستخدام عنوان داخلي، احفظ المزود أولاً ثم اختبره.
الاعتمادات	وحدة AI مفعلة. بالنسبة لـ Agent، راجع AI Agent.

تجهيز البنية التحتية

1. قم بالتسجيل لدى المزود وإنشاء مفتاح API. إذا كان المزود يدعم الميزانية أو حدود المعدل، فقم بتعيين حد شهري.

2. لاحظ عنوان URL الأساسي واسم النموذج بدقة (واختيارياً، ما يصل إلى أربعة نماذج احتياطية).

3. قم باختباره من خادم NexCMP قبل إدخاله:

   curl -s https://ai.example.com/v1/chat/completions \
     -H "Authorization: Bearer XXXX" -H "Content-Type: application/json" \
     -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply with one word: OK"}]}'

   إجابة بتنسيق JSON مع choices[0].message.content تعني أن نقطة النهاية تعمل.

الربط في NexCMP

1. Open System › Settings › AI provider.

2. في بطاقة Module AI، قم بتبديل الوحدة إلى وضع الـتشغيل (on). إلى أن يتم تفعيلها، لن يرى العملاء ميزة AI Chat أو AI Agent في البوابة. (يمكنك أيضاً تبديلها في License & updates.)

3. في بطاقة Connection، املأ الآتي:

   الحقل	مثال	ملاحظات
   Use this provider	مفعّل	يتطلب عنوان URL أساسياً ونموذجاً ومفتاحاً لكي يتم تفعيله.
   الاسم المعروض	LiteLLM	Up to 60 characters.
   Base URL (OpenAI-compatible)	https://ai.example.com/v1	http:// أو https://، بحد أقصى 300 حرف، بدون مسافات.
   Provider API key	sk-XXXX	يتم تخزينه مشفراً؛ وبعد ذلك يتم عرض آخر 4 أحرف فقط. اتركه فارغاً للحفاظ على المفتاح المخزن.
   Default model	gpt-4o-mini	حروف وأرقام و- _ . / : @.
   Fallback models	gemini-2.5-flash	مفصولة بفاصلة، بحد أقصى 4. تُستخدم عندما يفشل النموذج الافتراضي.
   Reasoning effort	Default (not sent)	Minimal أو Low أو Medium أو High. بالنسبة لنماذج الاستدلال (Gemini و o-series)، يجيب المستوى المنخفض بشكل أسرع بكثير. اتركه على Default للنماذج العادية.

4. انقر فوق Save، ثم Test connection. يرسل الاختبار سؤالاً قصيراً واحداً ويعرض Connected — <model>, <ms> ms أو الخطأ الذي أرجعه المزود.

What saving does

• يتم حفظ إعدادات المزود كعنصر تكوين واحد ويتم تشفير المفتاح باستخدام AES-256-GCM، المرتبط بهذا الغرض، باستخدام المفتاح الرئيسي للتثبيت.
• تم تعيين إعدادات الدعم Primary model و Fallback model (التي تستخدمها AI Chat) إلى نموذجك الافتراضي ونموذجك الاحتياطي الأول تلقائياً.
• يتم تسجيل التغيير في سجل التدقيق (نقطة النهاية، النموذج، وما إذا كان المفتاح قد تغير — ولكن ليس المفتاح أبداً).

التحقق

1. يظهر Test connection باللون الأخضر.
2. سجل الدخول إلى البوابة كعميل تجريبي: تعرض القائمة الآن AI Chat (أو فقاعة الدردشة) و AI Agent.
3. اسأل AI Chat "ما هو رصيدي؟". الإجابة التي تذكر رصيدك الحقيقي تُظهر أن المزود يتعامل مع استدعاءات الأدوات بشكل صحيح.

الحدود والملاحظات

• مزود واحد. يستخدم NexCMP مزوداً واحداً مهيئاً للدردشة، والوكيل، والتحقيق في التذاكر. توفر نماذج الاحتياط مرونة ضمن هذا المزود.
• أمان المفتاح. يُرسل المفتاح المحفوظ إلى نقطة النهاية المحفوظة فقط. إذا قمت بتغيير عنوان Base URL، فيجب عليك كتابة المفتاح مرة أخرى قبل الاختبار.
• الحدود لكل عميل. مخصصة للعملاء المسجلين الدخول فقط، مع حدود رسائل لكل دقيقة ولكل دردشة. يمتلك الوكيل حد استدعاء يومي لكل حساب. راجع AI Chat و AI Agent.
• الخصوصية. تُرسل أسئلة العميل والبيانات التي تقرؤها الذكاء الاصطناعي لذلك العميل (للعرض فقط) إلى مزودك. اذكر ذلك في privacy policy الخاص بك.
• التحكم في التكاليف. لا يقوم NexCMP بقياس تكلفة الذكاء الاصطناعي؛ استخدِم ميزات الميزانية الخاصة بالمزود.
• يمكن إيقاف تشغيل الوحدة في أي وقت: تختفي عناصر قائمة الذكاء الاصطناعي وتستجيب مسارات الذكاء الاصطناعي بالرمز 404 module_disabled. تلتقط بعض مهام الخلفية الخاصة بـ AI Chat (التحقيق في التذاكر، الردود المؤجلة) التغيير عند إعادة تشغيل اللوحة التالية.

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

العَرَض	السبب	الحل
base_url must be an http(s) URL	مخطط مفقود أو مسافات	استخدم https://host/v1.
api_key is required to enable the provider	No key stored	أدخل المفتاح واحفظ.
base_url and model are required to enable the provider	Empty field	قم بتعبئة كلاهما.
"تم حظر Base URL: بروتوكول http(s) العام فقط، والمنافذ 80/443/8080/8443"	اختبار عنوان داخلي غير محفوظ أو منفذ آخر	احفظ المزود أولاً ثم اختبره.
api_key is required (enter the key again when you change the endpoint)	عنوان Base URL يختلف عن العنوان المحفوظ	Retype the key.
model: letters, digits and - _ . / : @	Invalid character	استخدم معرف النموذج الدقيق للمزود.
fallback_models: up to 4 model names	Too many	احتفظ بأربعة أو أقل.
فشل الاختبار بالرمز 401	مفتاح خاطئ	تحقق من المفتاح ونقطة النهاية.
فشل الاختبار بالرمز 404 أو "model not found"	مسار أو نموذج خاطئ	تحقق من عنوان الأساس (/v1) ومعرف النموذج.
Too many tests — wait a minute (429)	أكثر من 10 اختبارات في الدقيقة	Wait.
لا تزال البوابة لا تظهر أي قائمة ذكاء اصطناعي	الوحدة متوقفة، أو المزود ليس "in use"	قم بتشغيل الوحدة وتفعيل المزود.