AI Agent

أين في لوحة التحكم: System › Settings › AI provider (/settings/ai) — مفتاح الوحدة والمزود؛ System › Admin › License & updates (/license) — مفتاح الوحدة. أين في البوابة: AI Agent (/ai/agent) والصفحة /chat/agent، أو وضع Agent داخل المحادثة.

الوظيفة

يتصل AI Agent بـ Linux VM الخاص بالعميل عبر SSH ويقوم بتنفيذ المهام الموصوفة بلغة بسيطة: "check system health"، "install Docker"، "find recent errors"، "free up disk space". يعرض كل أمر يقترحه ونتيجته. يمكن تشغيل الأوامر التي للقراءة فقط تلقائيًا؛ أي شيء يغير الخادم ينتظر العميل للضغط على Run.

المتطلبات

العنصر	المتطلب
وحدة ومزود الـ AI	وحدة AI قيد التشغيل وAI provider فعال. يحتاج Agent أيضًا إلى نموذج يدعم استدعاء الأدوات.
openssh-client على خادم اللوحة	يقوم Agent بتنفيذ الأوامر باستخدام برنامج اللوحة الخاص ssh (/usr/bin/ssh). يقوم المثبت بتثبيت openssh-client؛ تحقق باستخدام ssh -V. بدون ذلك، يبلغ Agent بأن "ssh client is not installed on the panel server".
لا توجد بوابة SSH منفصلة	في التثبيت الافتراضي، يتم استخدام SSH المدمج ولا يلزم استخدام طرفية الويب ssh-proxy أبدًا. فقط عندما يتم تمكين ميزة web SSH الاختيارية (feature_ssh_web) وتثبيت خدمة ssh-proxy، يمر Agent عبر ssh-proxy بدلاً من ذلك.
الشبكة	يجب أن يتمكن خادم اللوحة من الوصول إلى عنوان IP الخاص بـ VM على منفذ SSH الخاص به (22 افتراضيًا). تحقق من جدران الحماية ومجموعات الأمان بين اللوحة وشبكة الضيف.
VM	مملوك للعميل، قيد التشغيل، غير مقفل، Linux (يتم رفض أجهزة Windows VMs)، مع عنوان IP عام أو قابل للوصول.
بيانات اعتماد SSH	اسم مستخدم وكلمة مرور تسجيل الدخول لـ VM المخزنة بواسطة NexCMP (تم حفظها عند إنشاء VM أو إعادة تعيين كلمة المرور الخاصة بها، مشفرة)، أو مفتاح عمليات اللوحة إذا كان مثبتًا. إذا لم يتوفر أي منهما، يقول Agent إنه لا يمكنه تسجيل الدخول.

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

1. تحقق من عميل SSH على خادم اللوحة:

   ssh -V
   sudo apt-get install -y openssh-client   # only if missing

2. تحقق من قدرة خادم اللوحة على فتح SSH إلى جهاز ضيف VM:

   nc -vz 198.51.100.10 22

   استبدل العنوان بعنوان IP الخاص بـ VM تجريبي. إذا فشل ذلك، قم بإصلاح التوجيه أو جدار الحماية أولاً.

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

الربط في NexCMP

1. أكمل AI provider: تم تشغيل الوحدة، وحفظ المزود، وظهرت Test connection باللون الأخضر.
2. لا شيء آخر يتم إعداده من جانب المشرف. مفتاح الوحدة يجعل إدخالات AI Agent تظهر في بوابة العميل.
3. بصفة عميل: افتح AI Agent، واختر خادماً قيد التشغيل وانقر على Choose server. تختبر الصفحة أولاً اتصال SSH باستخدام أمر ثابت غير ضار (دون استخدام استدعاء الذكاء الاصطناعي) وتظهر عبارة SSH connected أو سبب الفشل.
4. اكتب مهمة أو اختر بداية سريعة (Check system health، Install Docker، Install Nginx، Find recent errors، Security check، Free up disk space).

كيف تُنفّذ الأوامر

• من أين: خادم اللوحة، باستخدام عميل النظام ssh، بأمر واحد غير تفاعلي في كل مرة. الهدف هو دائماً عنوان IP الخاص بالجهاز الافتراضي من قاعدة البيانات، وليس أبداً من الطلب؛ ولا يمكن الوصول إلا إلى الجهاز الافتراضي الخاص بالمالك والذي يعمل وغير مقفل.

• المصادقة: تُمرَّر كلمة المرور المخزنة عبر مساعد أحادي التشغيل SSH_ASKPASS في بيئة العملية — ولا يُكتب على القرص أو يوضع في سطر الأوامر. مفاتيح المضيف غير مثبتة (يتم إعادة تثبيت الأجهزة الافتراضية بمفاتيح جديدة). يقتصر الناتج لكل أمر على 200 كيلوبايت ولكل أمر حد زمني (60 ثانية).

• حلقة الوكيل: يقترح الذكاء الاصطناعي الأوامر ويقرأ المخرجات؛ وتنتهي الجولة الواحدة بعد 10 خطوات على الأكثر.

• الوضعيات:

  Mode	السلوك
  Confirm	كل أمر ينتظر Run.
  Auto	فقط الأوامر التي تجتاز قائمة سماح صارمة للقراءة فقط هي التي تُنفَّذ تلقائياً (على سبيل المثال df -h وps وjournalctl). أي شيء آخر، وأي شيء لا يستطيع المحلل التحقق منه بيقين (المتغيرات، استبدال الأوامر، إعادة التوجيه إلى الملفات)، ينتظر Run.

• تصنيفات المخاطر: الأوامر التي تستبدل الملفات أو تحذفها، أو تكتب على الأقراص، أو تغيّر الحسابات أو مفاتيح SSH، أو ترسل بيانات إلى خادم خارجي، أو تفتح اتصالات شبكة خام، أو تشغل تعليمة برمجية مبهمة، أو تنزل نص برمجي وتشغله، أو توقف تشغيل الجهاز أو تعيد تشغيله، أو تصل إلى خوادم أخرى، تُظهر دائماً Needs confirmation، حتى في وضع Auto.

• المخرجات غير الموثوقة: يتم عرض مخرجات الأوامر للنموذج كبيانات غير موثوقة؛ ولا يتم اتباع التعليمات الموجودة بداخلها.

التحقق

1. اختر خادم اختبار قيد التشغيل. تعرض الصفحة SSH connected.
2. اطلب "Check CPU, RAM and disk". في وضع Auto، تُنفَّذ أوامر القراءة فقط وتلخص الإجابة نتائجها.
3. اطلب "Install Nginx". يظهر أمر التثبيت مع Run وSkip؛ ولا يُنفَّذ أي شيء حتى تضغط على Run.
4. يُظهر العداد في الأعلى عدد استدعاءات الذكاء الاصطناعي المستخدمة اليوم (على سبيل المثال 3/300).

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

• الحد اليومي: 300 استدعاء ذكاء اصطناعي لكل عميل يومياً (التوقيت العالمي المنسق UTC)؛ ويتم إعادة تعيينه عند 00:00 بالتوقيت العالمي المنسق. عند استنفاده، يجيب الوكيل بـ "Daily AI quota reached".
• التزامن: حد أقصى لتشغيل 2 Agent لكل عميل في نفس الوقت؛ وتنفذ الجلسة خطوة واحدة في كل مرة.
• الجلسات: حتى 100 رسالة لكل جلسة، 4,000 حرف لكل رسالة. تنتمي الجلسة إلى جهاز افتراضي واحد؛ وفي حال حذف الجهاز الافتراضي أو نقله، تصبح الجلسة القديمة للقراءة فقط.
• جهاز افتراضي مقفل أو متوقف، أو ويندوز: يظهر الجهاز الافتراضي كـ Locked أو Stopped أو Windows أو No address ولا يمكن اختياره.
• انتحال الشخصية: لا يمكن للمشرف الذي ينتحل صفة عميل استخدام ميزات بيانات اعتماد الوكيل (انظر Log in as a customer).
• المسؤولية: يمكن للوكيل ارتكاب الأخطاء. تخبر البوابة العملاء بمراجعة الأوامر قبل تشغيلها. أبلغ العملاء في الشروط والأحكام الخاصة بك بأنهم مسؤولون عن الأوامر التي يوافقون عليها.
• إيقاف تشغيل وحدة الذكاء الاصطناعي يزيل إدخالات الوكيل وترجع المسارات الخطأ 404 module_disabled.

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

العَرَض	السبب	الحل
"عميل ssh غير مثبت على خادم اللوحة (apt install openssh-client)"	No ssh binary	sudo apt-get install -y openssh-client.
"تعذر على الوكيل تسجيل الدخول" / ssh: no saved credentials for this VM	لا توجد كلمة مرور مخزنة ولا مفتاح عمليات	أعد تعيين كلمة مرور الجهاز الافتراضي في البوابة لكي يتم حفظها مرة أخرى، أو ثبّت مفتاح العمليات.
"لم يستجب الخادم في الوقت المناسب"	جدار الحماية، أو SSH لا يستمع، أو الجهاز الافتراضي مشغول	اختبر nc -vz <ip> 22 من خادم اللوحة؛ وابدأ sshd في الجهاز الافتراضي.
"تعذر الوصول إلى SSH على هذا الخادم"	التوجيه أو مجموعة الأمان	اسمح لخادم اللوحة بالوصول إلى الجهاز الافتراضي عبر المنفذ 22.
"الجهاز الافتراضي لا يعمل" / "ممنوع"	الجهاز الافتراضي متوقف، أو مقفل، أو محذوف، أو لا ينتمي للعميل	قم بتشغيله، أو إلغاء قفله، أو اختر جهاظاً آخر.
"غير متوفر: N (متوقف، مقفل أو ويندوز)"	Reasons listed above	يجب أن يكون الجهاز الافتراضي يعمل بنظام Linux وفي حالة تشغيل.
"بوابة SSH غير متوفرة مؤقتاً"	ميزة ويب SSH ممكنة ولكن ssh-proxy متوقف عن العمل	قم بتشغيل ssh-proxy، أو عطل ميزة ويب SSH لاستخدام SSH المدمج.
"الذكاء الاصطناعي يستجيب ببطء شديد (أكثر من 90 ثانية)"	Provider slow	استخدم نموذجاً أسرع أو Reasoning effort أقل.
"تم بلوغ حصة الذكاء الاصطناعي اليومية"	300 calls used	Wait until 00:00 UTC.
"هذه الجلسة لا تزال قيد التشغيل"	دورة أخرى قيد التنفيذ	Wait or press Stop.