الانتقال إلى المحتوى
AR
احصل على NexCMP مجاناً

دليل

كيفية إضافة روبوت دردشة للدعم بالذكاء الاصطناعي ووكيل SSH إلى سحابة CloudStack

NexCMP هو نظام فوترة وبوابة عملاء ذاتي الاستضافة لـ Apache CloudStack وProxmox VE، ويأتي الإصدار 1.2.0 بوحدتين للذكاء الاصطناعي: AI Chat، وهو مساعد داخل بوابة العملاء، وAI Agent، الذي ينفذ المهام على خادم العميل الافتراضي عبر SSH. يوضح هذا الدليل كيفية إعدادهما باستخدام مفتاح API متوافق مع OpenAI، مع لقطات شاشة لبوابة العملاء ولوحة تحكم المشرف.

احصل على NexCMP مجاناًمشاهدة العرض التوضيحي

الوقت المطلوب: حوالي 15 دقيقة على تثبيت حالي لـ NexCMP.

الحزمة التقنية

أربعة مكونات، على الأرجح أنك تشغّل ثلاثة منها بالفعل.

  • NexCMP 1.2.0

    اللوحة التي يستخدمها عملاؤك بالفعل، مثبتة على Ubuntu 22.04 أو 24.04. يُعد كل من AI Chat و AI Agent جزءاً من الترخيص — دون أي رسوم إضافية.

  • نقطة نهاية متوافقة مع OpenAI

    أي API لـ chat-completions يدعم استدعاء الأدوات (الوظائف): سواء كان مزوداً مستضافاً، أو بروكسي تديره أمام عدة مزودين.

  • مفتاح مع سقف للإنفاق

    خصص للوحة مفتاحاً خاصاً بها وحدد له ميزانية شهرية لدى المزود أو في البروكسي، لتفادي تجاوز تكاليف الاستخدام.

  • أجهزتك الافتراضية على CloudStack

    يتصل AI Agent بالجهاز الافتراضي للعميل عبر SSH من خادم اللوحة، مستخدماً بيانات تسجيل الدخول التي حفظها العميل لذلك الجهاز.

خطوة بخطوة

  1. تحديث اللوحة إلى 1.2.0

    في لوحة تحكم المشرف، افتح License واضغط على Update، أو شغّل الأمر sudo nexcmp update على الخادم. يتم التحقق من التوقيع الرقمي للتحديث وفحصه قبل تثبيته.

  2. إنشاء مفتاح API بسقف محدد

    لدى مزود الذكاء الاصطناعي (أو في البروكسي الخاص بك)، أنشئ مفتاحاً مخصصاً لهذه اللوحة وحدد له ميزانية شهرية. يكفي استخدام نموذج سريع ومنخفض التكلفة لدردشة الدعم الفني.

  3. أدخله في Admin › Settings › AI provider

    الصق عنوان URL لنقطة النهاية، والمفتاح، واسم النموذج، ثم اضغط على Test connection. يُخزَّن المفتاح مشفراً في قاعدة بيانات اللوحة ولا يُعرض مرة أخرى مطلقا.

  4. تفعيل وحدة AI

    في License › Modules، قم بتفعيل AI. سيظهر كل من AI Chat وAI Agent في قائمة بوابة العملاء بعد إعادة تحميل الصفحة؛ وسيؤدي إيقاف تشغيل الوحدة إلى إخفائهما مجدداً.

  5. العملاء يسألون AI Chat

    يجيب AI Chat عن الأسئلة المتعلقة بخططك وأسعارك والخدمات الخاصة بالعميل. وعندما يتطلب السؤال تدخلاً بشرياً، يمكن للعميل تحويل المحادثة إلى فريق الدعم لديك.

    بوابة العملاء، AI Chat يجيب عن سؤال حول خوادم العميل

  6. العملاء يشغّلون AI Agent على جهاز افتراضي

    يختار العميل أحد أجهزته الافتراضية (VMs) ويصف المهمة بلغة واضحة. يقوم الوكيل بتنفيذ الأوامر عبر SSH ويعرض كل أمر مع مخرجاته.

    بوابة العملاء، AI Agent ينفذ الأوامر على خادم افتراضي ويعرض مخرجاتها

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

    تتم فوترة الاستخدام من قِبل مزود AI الخاص بك، وليس بواسطة NexCMP. تحقق من الإنفاق عبر لوحة تحكم المزود أو الوكيل، واضبط ميزانية المفتاح مع زيادة استخدام عملائك لهذه الميزة.

ما تحتاجه قبل البدء

  • إصدار NexCMP 1.2.0 أو أحدث، مع وحدة AI في License › Modules.
  • مزود AI بنقطة نهاية chat/completions متوافقة مع OpenAI ونموذج يدعم استدعاء الأدوات (الوظائف): مؤهل لذلك كل من OpenAI أو OpenRouter أو بوابة LiteLLM أو خادم vLLM الخاص بك.
  • بالنسبة لـ AI Agent، يلزم وجود openssh-client على خادم اللوحة (يضيفه برنامج التثبيت) ومسار شبكة من خادم اللوحة إلى منفذ SSH لكل VM، وهو 22 افتراضياً.
  • بالنسبة لـ AI Agent، يلزم وجود جهاز افتراضي Linux VM تابع للعميل، قيد التشغيل وغير مقفل، مع بيانات تسجيل دخول مخزنة (تم حفظها عند إنشاء الـ VM أو إعادة تعيين كلمة مروره) أو مفتاح عمليات اللوحة. يتم رفض أجهزة Windows الافتراضية.
  • اختياري لتحويل محادثات AI Chat إلى الموظفين: بوت Telegram ومُعرّف دردشة (chat ID) ضمن Settings › Admin alerts.
ssh -V
nc -vz 198.51.100.10 22

اختبر نقطة النهاية من خادم اللوحة أولاً

يضيف NexCMP المسار /chat/completions إلى أي عنوان URL ينتهي بـ /v1، ويضيف /v1/chat/completions إلى أي عنوان URL آخر؛ أما عنوان URL الذي ينتهي بالفعل بـ /chat/completions فيُستخدم كما هو. قبل إدخال نقطة النهاية، أرسل إليها طلباً واحداً من خادم NexCMP. الحصول على استجابة JSON تحتوي على choices[0].message.content يعني أن نقطة النهاية والنموذج يعملان بشكل سليم.

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"}]}'

كيف ينفذ AI Agent الأوامر، وما لن ينفذه تلقائياً

  • تُنفذ الأوامر من خادم اللوحة باستخدام عميل ssh الخاص به، أمراً واحداً غير تفاعلي في كل مرة. والهدف دائماً هو عنوان IP الخاص بالـ VM من قاعدة البيانات، ولا يؤخذ أبداً من الطلب.
  • تُمرر كلمة المرور المخزنة عبر أداة مساعدة SSH_ASKPASS لمرة واحدة ضمن بيئة العملية: ولا يتم كتابتها على القرص أو إدراجها في سطر الأوامر.
  • يقتصر مخرج كل أمر على 200 KB، وتنتهي الجولة بعد 10 خطوات كحد أقصى، ويمكن للعميل تشغيل 2 من عمليات الوكيل كحد أقصى في الوقت نفسه.
  • في وضع Confirm ينتظر كل أمر أن يضغط العميل على Run. وفي وضع Auto لا يتم تشغيل الأوامر تلقائياً إلا إذا كانت ضمن قائمة مخصصة للقراءة فقط بشكل صارم، مثل df -h أو ps أو journalctl.
  • الأوامر التي تستبدل الملفات أو تحذفها، أو تعدل الحسابات أو SSH Keys، أو ترسل بيانات إلى خادم خارجي، أو تنزل برنامجاً نصياً وتشغله، أو توقف تشغيل الجهاز أو تعيد تشغيله، تعرض دائماً Needs confirmation، حتى في وضع Auto.
  • تُعرض مخرجات الأوامر للنموذج كبيانات غير موثوقة، ولا يتم اتباع أي تعليمات واردة داخلها.

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

الرسائل الأكثر احتمالاً لمواجهتها، وما يجب التحقق منه.

  • فشل Test connection مع الخطأ 401

    السبب المحتمل
    المفتاح غير صحيح لنقطة النهاية هذه.
    الإجراء المطلوب
    تحقق من المفتاح ونقطة النهاية، وأعد إدخال المفتاح إذا قمت بتغيير عنوان URL الأساسي.

  • فشل Test connection مع الخطأ 404 أو model not found

    السبب المحتمل
    مسار غير صحيح أو مُعرّف نموذج خاطئ.
    الإجراء المطلوب
    تأكد من أن عنوان URL الأساسي ينتهي بـ /v1 واستخدم مُعرّف النموذج الدقيق لدى المزود.

  • البوابة لا تعرض قائمة AI

    السبب المحتمل
    الوحدة معطلة، أو لم يتم تفعيل المزود ليكون قيد الاستخدام.
    الإجراء المطلوب
    قم بتفعيل وحدة AI في License › Modules وتفعيل المزود.

  • تعذر على Agent تسجيل الدخول

    السبب المحتمل
    لا توجد كلمة مرور مخزنة ولا مفتاح عمليات لتلك الـ VM.
    الإجراء المطلوب
    أعد تعيين كلمة مرور الـ VM في البوابة لحفظها مجدداً.

  • لم يستجب الخادم في الوقت المحدد

    السبب المحتمل
    جدار حماية، أو عدم استماع SSH، أو انشغال الـ VM.
    الإجراء المطلوب
    شغّل nc -vz <vm-ip> 22 من خادم اللوحة وابدأ sshd داخل الـ VM.

  • استجابة الذكاء الاصطناعي بطيئة للغاية

    السبب المحتمل
    المزود أو النموذج بطيء.
    الإجراء المطلوب
    استخدم نموذجاً أسرع أو حدد إعداد Reasoning effort أقل في Settings › AI provider.

  • سجّل الدخول لاستخدام AI Chat

    السبب المحتمل
    الزائر لم يسجل الدخول.
    الإجراء المطلوب
    أمر متوقع: ميزة AI Chat مخصصة للعملاء المسجلين فقط.

الخصوصية والتكلفة

تُرسل أسئلة العميل والبيانات التي يقرؤها الذكاء الاصطناعي لذلك العميل (للقراءة فقط) إلى مزود الذكاء الاصطناعي الخاص بك. وضّح ذلك في سياسة الخصوصية لديك.

لا يقوم NexCMP باحتساب تكلفة الذكاء الاصطناعي. استخدم ميزات الميزانية لدى مزودك، وخفّض إعداد أدوار الذكاء الاصطناعي يومياً لكل عميل (40 افتراضياً، ضمن Customers › Support › Ticket › AI settings) لوضع حد للإنفاق.

الخطوات التالية

يظل AI Chat وAI Agent غير مفعلين حتى تحفظ مفتاح المزود، لذا لن يتم تحميلك أي تكاليف أو إرسال أي بيانات قبل أن تقرر ذلك. اقرأ النظرة العامة أو استكشف الوحدات الأخرى.

أسئلة حول وحدات الذكاء الاصطناعي

ما هي نماذج الذكاء الاصطناعي المتوافقة؟
أي نموذج متوافق مع نقطة نهاية chat-completions الخاصة بـ OpenAI ويدعم استدعاء الأدوات (الوظائف). يمكنك تحديد نقطة النهاية والمفتاح والنموذج في Admin › Settings › AI provider.
هل يمكن للوكيل الوصول إلى خوادم عملاء آخرين؟
لا. يعمل AI Agent فقط على أجهزة VM التابعة لحساب العميل المسجل، باستخدام بيانات تسجيل الدخول المحفوظة لتلك الـ VM.
هل يفرض NexCMP رسوماً على ميزات الذكاء الاصطناعي؟
لا. وحدات الذكاء الاصطناعي مضمنة في الترخيص. تدفع لمزود الذكاء الاصطناعي فقط مقابل استخدام المفتاح الذي قمت بتهيئته.
كيف أختبر الاتصال بمزود الذكاء الاصطناعي؟
في Admin › Settings › AI provider اضغط على Save ثم Test connection. سيُرسل سؤالاً قصيراً ويعرض Connected مع اسم النموذج والوقت المستغرق، أو رسالة الخطأ التي أرجعها المزود.
هل يحتاج AI Agent إلى بوابة SSH منفصلة؟
لا. في التثبيت الافتراضي، تستخدم اللوحة عميل ssh الخاص بها. ولا يُستخدم terminal الويب ssh-proxy الاختياري إلا عند تمكين ميزة web SSH.
هل يمكن للزوار غير المسجلين استخدام AI Chat؟
لا. ميزة AI Chat مخصصة للعملاء المسجلين فقط؛ ويُطلب من الزائر غير المسجل تسجيل الدخول أولاً.
هل يعمل AI Agent على أجهزة Windows VM؟
لا. يعمل على أجهزة Linux VM قيد التشغيل فقط؛ ويتم رفض أجهزة Windows VM.
هل يمكنني إيقاف تشغيله؟
نعم. أوقف تشغيل وحدة الذكاء الاصطناعي في License › Modules؛ وستختفي ميزتا AI Chat و AI Agent من البوابة وستجيب واجهة API الخاصة بهما بأن الوحدة معطلة.

المراجع

المواصفات المذكورة في هذا الدليل.

أضف الذكاء الاصطناعي إلى سحابتك

تتوفر ميزتا AI Chat و AI Agent في كل ترخيص من NexCMP — مجاناً للسنة الأولى، أو مقابل $499 لمرة واحدة مع الكود المصدري.

احصل على NexCMP مجاناًتواصل مع المبيعاتمشاهدة العرض التوضيحي

آخر تحديث: