كتابة بطاقات النماذج وتقارير التجارب

الكتابة التقنية الواضحة أساسية لمهندسي الذكاء الاصطناعي / تعلم الآلة. ستكتب بطاقات النماذج وتقارير التجارب ومستندات التصميم والمقترحات.

كتابة بطاقة نموذج

بطاقة النموذج توثّق كل ما يحتاج شخص ما معرفته عن نموذجك.

القالب

# Model Card: [اسم النموذج]

## Model Details (تفاصيل النموذج)
- Model type: نوع النموذج
- Training data: بيانات التدريب
- Model size: حجم النموذج

## Intended Use (الاستخدام المقصود)
- Primary use case: حالة الاستخدام الرئيسية
- Out-of-scope uses: الاستخدامات خارج النطاق

## Performance (الأداء)
- Evaluation metrics: مقاييس التقييم
- Results: النتائج

## Limitations (القيود)
- Known failure cases: حالات الفشل المعروفة
- Biases: التحيزات

عبارات رئيسية لبطاقات النماذج

"This model is a fine-tuned version of [base model] optimized for [task]."
هذا النموذج إصدار مضبوط دقيقاً من [النموذج الأساسي] محسّن لـ [المهمة]

"This model should NOT be used for [application] without human oversight."
يجب عدم استخدام هذا النموذج لـ [التطبيق] بدون إشراف بشري

كتابة تقرير تجربة

القالب

# Experiment Report (تقرير التجربة)

## Objective (الهدف)
ما كنا نحاول تحقيقه ولماذا

## Hypothesis (الفرضية)
ما توقعنا حدوثه والمنطق وراءه

## Setup (الإعداد)
- Base model: النموذج الأساسي
- Dataset: مجموعة البيانات
- Hyperparameters: المعاملات الفائقة

## Results (النتائج)
الجداول والمقارنات

## Conclusion (الخاتمة)
هل تأكدت الفرضية والخطوات التالية

عبارات رئيسية لتقارير التجارب

"The objective of this experiment was to determine whether..."
هدف هذه التجربة كان تحديد ما إذا كان...

"Results confirm our hypothesis: [metric] improved by [amount]."
النتائج تؤكد فرضيتنا: [المقياس] تحسن بمقدار [الكمية]

"We recommend adopting this approach for production."
نوصي بتبني هذا النهج للإنتاج

نصائح الكتابة لمهندسي الذكاء الاصطناعي

كن دقيقاً بالأرقام

سيئ: "The model is much better" — النموذج أفضل بكثير
جيد: "The model outperforms the baseline by 4.8% accuracy" — النموذج يتفوق بـ 4.8%

استخدم صيغة المبني للمعلوم

سيئ: "The dataset was preprocessed" — مجموعة البيانات عُولجت
جيد: "We preprocessed the dataset" — عالجنا مجموعة البيانات

اذكر القيود بوضوح

سيئ: "The model works well" — النموذج يعمل جيداً
جيد: "The model achieves 92% on in-domain data but drops to 71%
on out-of-domain examples" — النموذج يحقق 92% على بيانات المجال لكن ينخفض إلى 71%

كن محدداً فيما لا تعرفه

سيئ: "More research is needed" — مزيد من البحث مطلوب
جيد: "We haven't tested whether this generalizes to other languages.
This is a priority for the next experiment." — لم نختبر التعميم على لغات أخرى. هذا أولوية

:::