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

التكويد باستخدام مفاتيح API

مع مفتاح Coderen API يمكنك استخدام أدوات البرمجة التي تعمل مع واجهة OpenAI-compatible API. الأداة ترسل الطلبات إلى AI-School. AI-School تتحقق من المفتاح، الميزانية، فترة الصلاحية، والنماذج المسموح بها.

بعد ذلك تعالج AI-School الطلب عبر الارتباط التقني للبيئة.

what you need? (in Arabic)​

أنت بحاجة إلى ثلاث بيانات:

المعطىأين تجد هذا؟
مفتاح APIتحصل عليه من مسؤول أو معلم
النهاية (Endpoint)https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
اسم النموذجعلى سبيل المثال gpt-5.4-mini, gpt-5.4 أو gpt-5.5

يبدأ مفتاح API بـ ais.. تعامل مع هذا المفتاح ككلمة مرور.

أي نموذج تختار؟​

بالنسبة لمعظم الطلاب، يعتبر GPT-5.4 mini أفضل بدء. هذا النموذج أرخص ومناسب للمساعدة في البرمجة أثناء الدرس.

بالنسبة للمعلمين أو الطلاب المتقدمين قد يكون GPT-5.4 أو GPT-5.5 أنسب، مثلاً في مشاريع أكبر أو شفرة أكثر تعقيداً.

أي أداة تختار؟​

AI-School يوصي بأداتين:

الأداةمناسبة لـلماذا
Aiderالطلاب وبرمجة الصف بشكل جماعييعمل بشكل صريح، واضح وأقل اعتمادًا على الوكالة
OpenCodeالمعلمون والمستخدمون المتقدمونأداة CLI ذات وكيل وتطبيق مكتبي أيضاً

Aider للطلاب​

يعمل Aider كأداة برمجة زوجية في الطرفية. يطلب المستخدم المساعدة، يرى التغييرات ويظل قريبًا من الشفرة. هذا يتناسب جيداً مع تعلم البرمجة: يحصل الطالب على دعم، ولكنه يبقى مشاركاً فيما يحدث.

انظر أيضاً توثيق Aider الرسمي.

OpenCode للاستخدام المتقدم​

OpenCode أكثر وكيلية. يمكن للأداة تنفيذ خطوات بشكل مستقل، وتعديل الملفات وتطوير المهام. هذا قوي، ولكنه يتطلب فهماً أكبر للشفرة، وGit وبيئات التطوير المحلية.

انظر أيضاً توثيق OpenCode الرسمي.

التعامل الآمن مع المفاتيح​

لا تشارك مفتاح API علناً ولا تضعه في الشفرة التي تشاركها.

يفضل استخدام:

  • متغيرات البيئة
  • ملف .env محلي لا يتم رفعه إلى Git
  • الإعدادات المدمجة للأداة

على سبيل المثال يمكنك استخدام .env في مجلد المشروع لـ OpenCode:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

تأكد من أن الأداة تحمل هذا الملف .env بالفعل. في PowerShell يمكنك أيضاً تعيين المتغير مؤقتاً للطرفية الحالية:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"
ملاحظة

لا تضع مفاتيح API في مستودع عام، أو دردشة Teams، أو مستند مشترك، أو لقطة شاشة.

إذا لم يعمل المفتاح​

تحقق من التالي:

  • هل تم تشغيل Coderen للبيئة
  • هل مفتاحك ما زال نشطاً
  • هل الميزانية نفدت
  • هل المفتاح يقع ضمن فترة الصلاحية المقررة
  • هل تستخدم نموذجاً مسموحاً به
  • هل الإعداد النهائي صحيح
  • هل أداة ترسل مفتاح API كـ Authorization: Bearer ...
  • هل الأداة لا ترسل معلمات خاصة بمزود محدد لا تدعمه AI-School Coderen

في حال الشك استشر مسؤولاً أو مع مدرس للتحقق من المفتاح.