انتقل إلى المحتوى الرئيسي

كيفية استخدام النماذج المخصصة في Cursor

يشرح هذا الدليل كيفية دمج واستخدام نماذج الذكاء الاصطناعي المخصصة في Cursor، مما يتيح لك الاستفادة من قدرات الذكاء الاصطناعي المختلفة لسير عمل التطوير الخاص بك.

أنواع النماذج المدعومة​

يدعم Cursor تكاملات متنوعة لنماذج الذكاء الاصطناعي:

  1. نماذج متوافقة مع OpenAI

    • Anthropic Claude
    • DeepSeek
    • Mistral
    • نماذج LLM المحلية

  2. نقاط نهاية API مخصصة

    • نماذج مستضافة ذاتياً
    • خدمات API السحابية
    • تنفيذات مخصصة

التكوين الأساسي​

إعداد النماذج المخصصة​

  1. افتح إعدادات Cursor
  2. انتقل إلى قسم نماذج الذكاء الاصطناعي
  3. أضف تكوين نموذج جديد:
{
  "models": {
    "custom-model": {
      "name": "اسم النموذج الخاص بك",
      "apiKey": "مفتاح-api-الخاص-بك",
      "baseUrl": "https://api.your-model-endpoint.com/v1",
      "contextLength": 8192,
      "temperature": 0.7
    }
  }
}

معلمات التكوين​

المعلمةالوصفالافتراضي
nameاسم العرض للنموذجمطلوب
apiKeyمفتاح مصادقة APIمطلوب
baseUrlعنوان URL لنقطة نهاية APIمطلوب
contextLengthالحد الأقصى لنافذة السياق4096
temperatureعشوائية الاستجابة0.7

تكامل النموذج​

نماذج متوافقة مع OpenAI​

{
  "models": {
    "custom-gpt": {
      "name": "GPT مخصص",
      "apiKey": "${OPENAI_API_KEY}",
      "baseUrl": "https://api.openai.com/v1",
      "model": "gpt-4",
      "contextLength": 8192
    }
  }
}

إعداد Anthropic Claude​

{
  "models": {
    "claude": {
      "name": "Claude",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "baseUrl": "https://api.anthropic.com/v1",
      "model": "claude-2",
      "contextLength": 100000
    }
  }
}

تكوين النموذج المحلي​

{
  "models": {
    "local-llm": {
      "name": "LLM محلي",
      "baseUrl": "http://localhost:8000",
      "contextLength": 4096,
      "useDocker": true
    }
  }
}

الإعدادات المتقدمة​

سلوك النموذج​

تكوين سلوك النموذج:

{
  "models": {
    "custom-model": {
      "settings": {
        "temperature": 0.7,
        "topP": 0.9,
        "frequencyPenalty": 0.0,
        "presencePenalty": 0.0,
        "stopSequences": ["```", "###"]
      }
    }
  }
}

تنسيق الاستجابة​

{
  "models": {
    "custom-model": {
      "formatting": {
        "trimWhitespace": true,
        "removeNewlines": false,
        "maxTokens": 1000
      }
    }
  }
}

ميزات خاصة بالنموذج​

إكمال الكود​

{
  "models": {
    "code-model": {
      "features": {
        "codeCompletion": true,
        "contextAware": true,
        "multiFile": true
      }
    }
  }
}

قدرات الدردشة​

{
  "models": {
    "chat-model": {
      "features": {
        "chat": true,
        "systemPrompts": true,
        "streaming": true
      }
    }
  }
}

تحسين الأداء​

إعدادات التخزين المؤقت​

{
  "models": {
    "custom-model": {
      "cache": {
        "enabled": true,
        "maxSize": "1GB",
        "ttl": 3600
      }
    }
  }
}

تحديد معدل الاستخدام​

{
  "models": {
    "custom-model": {
      "rateLimit": {
        "requestsPerMinute": 60,
        "tokensPerMinute": 90000,
        "concurrent": 5
      }
    }
  }
}

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

المشكلات الشائعة​

  1. مشاكل الاتصال

    • تحقق من نقطة نهاية API
    • تحقق من اتصال الشبكة
    • تحقق من صحة مفتاح API

  2. أخطاء الاستجابة

    • تحقق من توافق النموذج
    • تحقق من تنسيق الطلب
    • راجع رسائل الخطأ

  3. مشاكل الأداء

    • تحسين طول السياق
    • ضبط إعدادات التخزين المؤقت
    • مراقبة حدود المعدل

أفضل الممارسات​

الأمان​

  1. إدارة مفاتيح API

    • استخدام متغيرات البيئة
    • تدوير المفاتيح بانتظام
    • تنفيذ ضوابط الوصول

  2. التحقق من صحة الطلبات

    • تنظيف المدخلات
    • التحقق من صحة الاستجابات
    • معالجة الأخطاء بأناقة

الأداء​

  1. تحسين السياق

    • تقليل حجم السياق
    • ترتيب أولويات المعلومات ذات الصلة
    • استخدام التخزين المؤقت بكفاءة

  2. إدارة الموارد

    • تحديد الطلبات المتزامنة
    • مراقبة استخدام الذاكرة
    • تحسين أوقات الاستجابة