هل تريد تحكمًا كاملاً في نموذج الذكاء الاصطناعي الذي يشغل مساعد البرمجة الخاص بك؟ يوضح لك هذا الدليل الشامل كيفية نشر النموذج المخصص الخاص بك على بنية GPU الخاصة بـ Novita AI ودمجه بسلاسة مع بيئة تطوير Cursor IDE. على عكس استخدام نقاط نهاية API المعدة مسبقًا، يمنحك نشر المثيل الخاص بك تحكمًا كاملاً في اختيار النموذج، والتكوين، وتحسين الأداء.
مثال عملي: DeepSeek-R1-Distill-Qwen-1.5B
الخطوة 1: تحديد بنية النموذج الأساسية
تفضل بزيارة https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B. انسخ اسم النموذج لاستخدامه لاحقًا.
الخطوة 2: العثور على المحلل (Parser) المقابل
راجع وثائق vLLM tool calling. بالنسبة لنماذج عائلة Qwen-2.5، استخدم محلل hermes.
لماذا يعد استدعاء الأدوات مهمًا لوكلاء البرمجة
لا يرسل Cursor فقط مطالبات ويستقبل ردود نصية. بل يحتاج إلى نماذج يمكنها التفاعل مع بيئة التطوير الخاصة بك، وفهم السياق عبر ملفات متعددة، وتنفيذ إجراءات محددة. يعد استدعاء الأدوات هو الجسر الذي يتيح هذه الإمكانيات.
تتطلب عائلات النماذج المختلفة محللات مختلفة. طابق نموذجك بنوع المحلل الصحيح بالرجوع إلى وثائق استدعاء أدوات vLLM.
الخطوة 3: إنشاء حسابك على Novita AI
- تفضل بزيارة منصة Novita AI
- انقر على “إنشاء حساب” للوصول الفوري
- احصل على رصيد مجاني بقيمة 1 دولار تلقائيًا عند التسجيل
الخطوة 4: اختيار القالب
اختر نموذج DeepSeek-R1-Distill-Qwen-1.5B من مكتبة النماذج أو أنشئ قالبك الخاص.
الخطوة 5: تأكيد المعلمات
راجع معلمات النشر المعروضة على شاشة التكوين. تحقق من صحة جميع الإعدادات وانقر على التالي للمتابعة.
في حقل معلمات بدء تشغيل الحاوية، أضف:
--enable-auto-tool-choice --tool-call-parser hermes
هام: يجب أن يتطابق المحلل مع عائلة النموذج الخاصة بك. راجع وثائق vLLM للحصول على المحلل الصحيح.
الخطوة 6: نشر المثيل
انقر على نشر لبدء عملية إنشاء المثيل. سيبدأ النظام في توفير مثيل GPU الخاص بك.
الخطوة 7: مراقبة تقدم النشر
انتقل إلى إدارة المثيلات للوصول إلى وحدة التحكم. تتيح لك هذه اللوحة تتبع حالة النشر في الوقت الفعلي.
الخطوة 8: عرض حالة سحب الصورة
انقر على المثيل المحدد الخاص بك لمراقبة تقدم تنزيل صورة الحاوية. قد تستغرق هذه العملية عدة دقائق حسب ظروف الشبكة.
الخطوة 9: التحقق من نجاح النشر
ابحث عن الرسالة "Application startup complete." في سجلات المثيل. يشير هذا إلى أن عملية النشر قد اكتملت بنجاح.
الخطوة 10: الحصول على عنوان URL للوصول
انقر على “اتصال”، ثم انقر على → “الاتصال بخدمة HTTP [المنفذ 8000]”. بما أن هذه خدمة API، ستحتاج إلى نسخ العنوان.
دليل تكامل كامل لـ Cursor IDE
الخطوة 1: تثبيت Cursor والاشتراك فيه
- قم بتنزيل Cursor IDE من cursor.com
- أكمل شراء خطة Pro (20 دولارًا شهريًا)
- تشغيل التطبيق
هام: تتطلب وضع الوكيل ووظيفة التحرير اشتراك Cursor Pro (20 دولارًا شهريًا).
الخطوة 2: الوصول إلى إعدادات النموذج
- افتح إعدادات Cursor (Ctrl+, أو Cmd+,)
- انتقل إلى قسم “النماذج”
- ابحث عن منطقة “تكوين API”
الخطوة 3: تكوين المثيل المخصص الخاص بك
- ✅ تفعيل مفتاح تبديل “مفتاح API لـ OpenAI”
- ✅ تفعيل مفتاح تبديل “تجاوز عنوان URL الأساسي لـ OpenAI”
الخطوة 4: إدخال بيانات اعتماد المثيل الخاص بك
في حقل “مفتاح API لـ OpenAI”: أدخل أي قيمة (لا يمكن أن تكون فارغة)
في حقل “تجاوز عنوان URL الأساسي لـ OpenAI”: الصق عنوان URL الخاص بك مع لاحقة /v1:
https://your-instance-id.novita.ai/v1
⚠️ حرج: لاحقة /v1 إلزامية. بدونها، لا يمكن لـ Cursor التواصل مع مثيلك.
الخطوة 5: إضافة النموذج المخصص الخاص بك
- انقر على “+ إضافة نموذج مخصص”
- أدخل اسم النموذج المطابق تمامًا الموجود على Huggingface
- هام: يجب أن يتطابق اسم النموذج تمامًا - حساس لحالة الأحرف
الخطوة 6: حفظ وتحديد النموذج الخاص بك
- احفظ التكوين الخاص بك
- حدد النموذج المخصص الخاص بك في القائمة المنسدلة لـ Cursor
الاختبار والتحقق
الاختبار في وضع الأسئلة (Ask Mode)
- ابدأ محادثة جديدة في وضع الأسئلة (Ask Mode)
- أرسل سؤال برمجة بسيط
- تحقق من استلامك لرد
الاختبار في وضع الوكيل (Agent Mode)
- قم بالتبديل إلى وضع الوكيل (Agent Mode)
- اطلب مهمة برمجة متعددة الخطوات
- تحقق من عمل وظيفة استدعاء الأدوات
الأخطاء الشائعة في الإعداد وحلولها
❌ النموذج لا يستجيب
الحلول:
- ✅ تحقق من تفعيل مفتاحي التبديل الخاصين بـ API
- ✅ تحقق من أن عنوان URL الأساسي يتضمن لاحقة
/v1 - ✅ تحقق من أن حالة المثيل تعرض “قيد التشغيل”
- ✅ تحقق من وجود رصيد كافٍ
❌ تم رفض الاتصال
الحلول:
- ✅ تحقق من عدم وجود شرطة مائلة في نهاية عنوان URL الأساسي بعد
/v1 - ✅ تأكد من عدم وجود مسافات إضافية في عنوان URL
- ✅ تحقق من الاتصال بالإنترنت
❌ لم يتم العثور على اسم النموذج
الحلول:
- ✅ انسخ اسم النموذج المطابق تمامًا من لوحة التحكم
- ✅ تحقق من حساسية حالة الأحرف
- ✅ تحقق من عدم وجود مسافات إضافية
❌ وظائف محدودة
الحلول:
- ✅ تحقق من إضافة معلمات استدعاء الأدوات أثناء النشر
- ✅ تحقق من تحديد المحلل الصحيح
- ✅ أعد تشغيل تطبيق Cursor
الخاتمة
يتيح لك نشر النموذج الخاص بك على Novita AI لـ Cursor التحكم الكامل في مساعد البرمجة الذكي الخاص بك.
من خلال اتباع هذا الدليل والانتباه بعناية إلى تكوين استدعاء الأدوات ومعلمات الاتصال، يمكنك دمج نماذج الذكاء الاصطناعي المخصصة بنجاح مع Cursor والتحكم الكامل في مساعد البرمجة الخاص بك.
تعد Novita AI منصة سحابية للذكاء الاصطناعي توفر للمطورين طريقة سهلة لنشر نماذج الذكاء الاصطناعي باستخدام API البسيط الخاص بنا، بالإضافة إلى توفير سحابة GPU بأسعار معقولة وموثوقة للبناء والتوسع.
