دليل استخدام CubeCroom
الذكاء الاصطناعي

ربط LM Studio أو Ollama

تشغيل نموذجك واختيار عنوان الخادم المحلي الصحيح.

ثبّت أداة تشغيل النماذج وجهّز نموذجاً فيها قبل الربط. CubeCroom يتصل بالخادم الذي تحدده؛ لا ينزّل نماذج LM Studio أو Ollama ولا يبدأ تشغيل الخادم نيابةً عنك.

المزوّدالعنوان الافتراضي داخل CubeCroom
LM Studiohttp://localhost:1234/v1
Ollamahttp://localhost:11434/v1

localhost يعني جهاز المعلم الذي يشغّل CubeCroom. إذا كانت أداة النماذج على جهاز آخر، استخدم عنوان ذلك الجهاز ومنفذه المتاحين للمعلم. الطلاب يرسلون طلباتهم إلى تطبيق المعلم؛ لا يحتاج كل طالب إلى تثبيت أداة النماذج.

LM Studio

  1. جهّز نموذجاً نصّياً داخل LM Studio وحمّله للتشغيل.
  2. من تبويب Developer شغّل خادم النماذج، واتبع شرح تشغيل الخادم الرسمي.
  3. في CubeCroom افتح «الذكاء الاصطناعي»، ثم «ربط الخادم» في بطاقة LM Studio.
  4. اترك العنوان الافتراضي إذا كان الخادم على جهازك وبالمنفذ 1234. إن غيّرت المنفذ، عدّل «عنوان الخادم».
  5. اترك «مفتاح الوصول — اختياري» فارغاً إذا كان خادمك لا يطلبه. إذا فعّلت المصادقة، أدخل رمز الوصول الذي أنشأته في LM Studio؛ راجع إعداد المصادقة.
  6. اضغط «اختبار الاتصال»، ثم اختر النموذج واضغط «حفظ واستخدام».

CubeCroom يستخدم واجهة LM Studio المتوافقة مع OpenAI. احتفظ بنهاية العنوان /v1؛ لا تضع مسار محادثة أو صفحة الواجهة مكان عنوان الخدمة.

Ollama

  1. ثبّت Ollama وشغّله وفق دليل البدء الرسمي.
  2. نزّل نموذجاً نصّياً مناسباً لجهازك. من الطرفية يمكنك استخدام ollama pull MODEL_NAME بعد استبدال MODEL_NAME باسم النموذج المطلوب، ثم عرض النماذج باستخدام ollama ls. إذا لم يكن الخادم يعمل، يشغّله ollama serve. هذه الأوامر موثّقة في مرجع Ollama.
  3. في بطاقة Ollama اضغط «ربط الخادم»، واستخدم http://localhost:11434/v1 عند التشغيل على جهاز المعلم بالإعداد الافتراضي.
  4. اترك المفتاح فارغاً للاتصال المحلي المعتاد؛ Ollama لا يطلب مصادقة لهذا الاتصال.
  5. اختبر الاتصال، ثم اختر الاسم الكامل للنموذج المتاح لديك واضغط «حفظ واستخدام».

إذا أردت معالجة على جهازك، اختر نموذجاً يُشغَّل محلياً بالفعل. نماذج Ollama السحابية تُعالَج في خدمة Ollama السحابية، حتى لو أرسلت طلبك أولاً إلى عنوان محلي.

عند تغيير الجهاز أو العنوان

افتح «إعداد الاتصال» في بطاقة المزوّد، وعدّل العنوان ثم اختبره. يقبل التطبيق HTTP أو HTTPS دون كلمة مرور داخل الرابط أو معاملات إضافية. ضع رمز الوصول في حقل المفتاح. عند تشغيل الخادم على جهاز آخر، تأكد مع مسؤول الشبكة من إتاحته وتأمين الاتصال.

القائمة فارغة أو الطلب بطيء؟ راجع حل المشكلات.