ادعُ أصدقاء واحصل على رموز مجانية!اعرف المزيد

🚀 تكامل n8n: برنامج تعليمي لـ CodingPlanX Custom LLM

في n8n، يمكنك بسهولة الاتصال بالنماذج اللغوية الكبيرة (LLMs) التابعة لجهات خارجية من خلال تكوين نطاق API مخصص (Custom API Domain) و مفتاح API (API Key).

يوضح هذا البرنامج التعليمي كيفية تكوين واستخدام نماذج الذكاء الاصطناعي المخصصة في n8n باستخدام https://api.codingplanx.ai كمثال.

📋 المتطلبات الأساسية

قبل أن تبدأ، تأكد من أن لديك:

  1. نسخة قيد التشغيل من n8n (استضافة ذاتية أو نسخة سحابية).
  2. مفتاح API الخاص بـ CodingPlanX (عادةً يبدأ بـ sk- أو cr_).
  3. اسم النموذج المحدد الذي ترغب في استدعائه (مثل gpt-4o، claude-3-5-sonnet، إلخ).

🛠️ الخطوة 1: إنشاء بيانات اعتماد API في n8n

نظرًا لأن معظم واجهات برمجة التطبيقات (APIs) المخصصة متوافقة مع OpenAI، فسنستخدم نوع بيانات اعتماد OpenAI المدمج.

  1. افتح لوحة تحكم n8n وانقر على Credentials (بيانات الاعتماد) في الشريط الجانبي الأيسر.
  2. انقر على زر + Add Credential (إضافة بيانات اعتماد) في أعلى اليمين.
  3. ابحث عن OpenAI وحدد OpenAI API.

⚙️ الخطوة 2: تكوين عنوان URL المخصص لـ API والمفتاح

في نافذة تكوين بيانات الاعتماد، املأ ما يلي:

  1. Name (الاسم): أعط هذه الاعتماد اسمًا مميزًا، مثل CodingPlanX API.

  2. API Key (مفتاح API): أدخل مفتاح API الخاص بك (...sk-xxxxxx).

  3. Base URL (الرابط الأساسي - خطوة بالغة الأهمية):

    • بشكل افتراضي، يستخدم n8n الرابط الرسمي لـ OpenAI. نحن بحاجة إلى تجاوز هذا.
    • ابحث عن حقل Base URL (إذا لم يكن مرئيًا، فتأكد من أن إصدار n8n الخاص بك يدعم روابط Base URL المخصصة أو تحقق من الإعدادات المتقدمة).
    • قم بتغيير العنوان إلى: 
      https://api.codingplanx.ai/v1

    > 💡 ملاحظة: تتطلب معظم واجهات برمجة التطبيقات المتوافقة مع OpenAI اللاحقة /v1. لا تقم بحذفها.

  4. انقر على Save (حفظ). إذا تم التكوين بشكل صحيح، يجب أن ترى رسالة Connection tested successfully (تم اختبار الاتصال بنجاح).

🧩 الخطوة 3: إضافة وتكوين عقدة الذكاء الاصطناعي في سير العمل

الآن، دعنا نستخدم بيانات الاعتماد في سير عمل (Workflow).

  1. اذهب إلى Workflows (سير العمل) وانقر على + Add workflow (إضافة سير عمل).
  2. انقر على أيقونة + على اللوحة، ابحث وأضف عقدة OpenAI (عادةً AI Chat Model).
  3. افتح إعدادات العقدة:
    • Credential to connect with (بيانات الاعتماد للاتصال بها): حدد CodingPlanX API التي أنشأتها للتو.
    • Model (النموذج):
      • نظرًا لأن هذا API مخصص، فقد لا تدرج القائمة المنسدلة النموذج المحدد الخاص بك.
      • انقر فوق ⚙️ (أيقونة الترس) بجوار حقل النموذج أو حدد وضع Expression / Custom.
      • أدخل اسم النموذج يدويًا، مثل gpt-3.5-turbo أو معرف Claude المحدد الخاص بك.

✅ الخطوة 4: اختبار الاتصال

  1. قم بتوصيل عقدة Manual Trigger (مشغل يدوي) بعقدة الذكاء الاصطناعي الخاصة بك.
  2. أدخل مطالبة اختبار (Prompt) في عقدة الذكاء الاصطناعي، مثل "مرحبًا، يرجى تقديم نفسك.".
  3. انقر فوق Execute Node (تنفيذ العقدة) أو Test step (اختبار الخطوة).
  4. تحقق من لوحة Output (المخرجات) على اليمين. إذا رأيت استجابة من الذكاء الاصطناعي، تهانينا! تم دمج نموذجك المخصص بنجاح! 🎉

❓ استكشاف الأخطاء وإصلاحها (الأسئلة الشائعة)

س1: خطأ Invalid API Key أو AuthenticationError؟

  • تحقق مما إذا كان قد تم نسخ مفتاح API بشكل صحيح دون مسافات إضافية.
  • تأكد من أن حساب CodingPlanX الخاص بك يحتوي على رصيد كافٍ.

س2: خطأ Resource not found أو 404؟

  • أعد التحقق من Base URL في الخطوة 2. تأكد من أنه يتضمن https://api.codingplanx.ai/v1 (تحقق من عدم وجود /v1 مفقودة أو شرطات مائلة إضافية في النهاية).

س3: خطأ Model not found؟

  • تحقق من أن اسم النموذج (Model Name) الذي كتبته يدويًا صحيح. ارجع إلى قائمة نماذج CodingPlanX للحصول على المعرفات الدقيقة.