إدارة التشفير
مع التشفير يمكن للمشرفين إنشاء مفاتيح API خاضعة للتحكم لأدوات البرمجة مثل Aider وOpenCode. لا يعمل المستخدمون بمفتاح OpenAI خاص بهم، بل بمفتاح تتم إدارته من AI-School.
هذا يجعل التشفير مناسبًا للدروس البرمجية، المشاريع، والمستخدمين المتقدمين الذين يريدون استخدام المساعدة الذكية في بيئة تطوير محلية.
لماذا مفاتيح API الخاضعة للتحكم؟
عادةً ما يمنح مفتاح API عادي وصولاً واسعاً إلى منصة ذكاء اصطناعي خارجية. في التشفير، يتم استخدامه عبر AI-School. وبهذا تبقى الإدارة والتكاليف والتقارير ضمن المدرسة.
فوائد مهمة:
- التكاليف تحت السيطرة: اضبط ميزانية لكل مفتاح.
- الاستخدام قابل للت تبّع: يربط الاستهلاك والتكاليف والدردشات بالمستخدم.
- الإدارة المركزية: أنشئ وحدّ، وقم بسحب المفاتيح من خلال بيئة الإدارة.
- مناسب للصفوف: أنشئ مفاتيح لمجموعة من الطلاب دفعة واحدة.
تفعيل التشفير
يتم تشغيل التشفير على مستوى البيئة. وهذا يمكن أن يتم من قِبل مدير إداري.
- اذهب إلى بيئة الإدارة → التشفير.
- انقر على تشغيل التشفير.
- اقرأ التحذير المتعلق بتكاليف الاشتراك وتكاليف API.
- انقر على الموافقة والتشغيل.
بعد تشغيله، يقوم AI-School بمعالجة الربط الفني في الخلفية. لا يحتاج المدراء لإدارة إعدادات مشروع خارجية لهذا الغرض.
قد تكون هناك تكاليف اشتراك إضافية متعلقة بالتشفير. يتم احتساب تكالي ف API مع عامل هامش. وللإسئلة تواصل مع AI-School.
منح الوصول للمدارس
بعد التشغيل، حدد أي المدارس يمكنها استخدام التشفير.
- افتح تبويب الإدارة.
- اختر المدارس التي يجوز لها استخدام التشفير.
- انقر على حفظ الوصول.
يرى مدير المدرسة فقط المدارس المسموح لها بالتشفير والتي لديه صلاحيات الإدارة. بالنسبة لمدير المدرسة، تُخفى لوحات المدرسة غير الضرورية.
اختيار النماذج
في تبويب الإدارة اختر نماذج OpenAI المتاحة للتشفير.
AI-School يستخدم هذه النماذج:
| النموذج | الاستخدام |
|---|---|
| GPT-5.6 Luna | نموذج سريع ومرن للطلاب ومساعدة البرمجة اليومية |
| GPT-5.6 Terra | نموذج قوي للمعلمين والطلاب المتقدمين ومهام البرمجة المعقدة |
| GPT-5.6 Sol | النموذج الأكثر تقدمًا لأعمال البرمجة المتطلبة والاستخدام المهني |
للإستخدام الصفّي، يعتبر GPT-5.6 Luna بداية سريعة وميسورة. اختر Terra أو Sol عندما تتطلب المهمة مزيداً من التحليل والتفكير وخطوات برمجة مستقلة.
أدوات البرمجة المتوافقة
يعمل التشفير مع أدوات يمكن أن تستخدم نقطة نهاية متوافقة مع OpenAI. يحتاج المستخدم إلى ثلاثة أشياء:
- مفتاح API الخاص بالتشفير
- عنوان نهاية AI-School التشفير:
https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 - نموذج مسموح به، مثل
gpt-5.6-luna
يوصي AI-School في معظم الحالات باستخدام هاتين الأداتين:
| الأداة | موصى بها لـ | ملاحظة |
|---|---|---|
| Aider | الطلاب والتشفير الصفّي | أداة pair-programming صريحة في المحطة الطرفية. أقل اعتمادًا على الوكيل وبالتالي مناسبة أكثر لتعلم البرمجة. |
| OpenCode | المعلمون والطلاب المتقدمون | أداة تشفير آلية للـ terminal، سطح المكتب وIDE. أقوى، لكنها تتطلب خبرة أكثر. |
هناك أدوات تشفير أخرى يمكنها العمل تقنيًا مع نقطة نهاية متوافقة مع OpenAI:
| الأداة | النوع | نقطة الانتباه |
|---|---|---|
| Continue | مساعد IDE لـ VS Code وJetBrains | يدعم تكوين OpenAI مع apiBase مخصص. مناسب عندما يرغب المستخدمون في العمل من داخل IDE. |
| Cline | إضافة VS Code وCLI | اختر موفِّر OpenAI Compatible وادخل عنوان الأساس ومفتاح API والنموذج. قوي كوكيل؛ ليس مناسباً للمبتدئين بدون توجيه. |
| Roo Code | إضافة VS Code | يمكن أن يعمل مع مزود متوافق مع OpenAI. تحقق من الإجراءات التي ينفذها الوكيل بعناية. |
| Sourcegraph Cody Enterprise | مساعد تشفير للمؤسسات | ذو صلة خاصة بالمنظمات التي لديها Sourcegraph Enterprise. يدعم تكوين نموذج openaicompatible على مستوى المؤسسة. |
الأداة مناسبة فقط إذا كان بإمكانك تعيين عنوان قاعدة OpenAI-compatible خاص بك. أدوات مثل Claude Code وCodex CLI لا تناسب التشفير: Claude Code لا يستخدم API متوافق مع OpenAI وCodex CLI لا يوفر إعدادًا مناسبًا لنقطة النهاية الخاصة بالتشفير. كما أن أدوات مثل Cursor أو Windsurf تكون مفيدة فقط إذا كانت النسخة المستخدمة تدعم عنوان قاعدة OpenAI-compatible قابل للتعديل.
ابدأ باستخدام Aider للطلاب أولاً. أضف أدوات الوكلاء مثل OpenCode، Cline أو Roo Code فقط عندما يكتسب المستخدمون خبرة كافية في المحطة الطرفية، وGit، والفروقات، وإدارة الملفات محلياً.
التقارير
تظهر صفحة التقارير الاستخدام والتكاليف للفترة المختارة. بشكل افتراضي، تُعرض آخر 7 أيام.
تتضمن التقارير:
- إجمالي عدد الطلبات
- التكاليف الإجمالية
- عدد الرمزات
- تفصيل حسب المجموعة
- تفصيل حسب المستخدم
يرى مدير المدرسة التقارير فقط ضمن النطاق المسموح به للمؤسسة. يرى مدير الإدارة التقرير لأجل البيئة ككل.
إيقاف التشفير
يمكنك إيقاف التشفير مؤقتًا عبر الزر في شريط الأدوات.
عند إيقاف التشفير:
- لا يمكن استخدام مفاتيح API الحالية
- تبقى التقارير والبيانات التاريخية محفوظة
- يمكن إعادة تشغيل التشفير لاحقًا
الإيقاف لا يحذف التقارير الموجودة.
