توثيق نماذج الذكاء الاصطناعي

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

وللحوكمة، يربط التوثيق النموذج بالنظام الذي يستخدمه. فقد تتحول المدخلات وتُصفى المخرجات وينفذ مكوّن آخر إجراءً بناء على التنبؤ. يجب فصل حقائق النموذج عن حقائق المسار المنشور، خاصة عند نقل تجربة ناجحة إلى بيئة أخرى.

يساعد الدليل الملاك التقنيين وفرق الجودة ومراجعي الحوكمة في السعودية على التوثيق ضمن تأسيس حوكمة الذكاء الاصطناعي. ويقدم بنية أصلية ومثال فحص عبوات يوضح كيف تخفي نتيجة إجمالية قوية قيداً خاصاً بالاستخدام.

افصل توثيق النموذج والنظام وبيئة التشغيل

يصف سجل النموذج المهمة والنسخة ومعلومات التدريب أو المورد المتاحة ومواصفات الإدخال والإخراج والتقييم والقيود. ويشرح سجل النظام تفاعل المكون مع المعالجة الأولية والاسترجاع والقواعد والواجهات والأشخاص. وتحدد وثيقة البيئة الإعداد الفعلي والمستخدمين والصلاحيات والمالك.

اربط السجلات بدلاً من تكرار كل شيء. قد يخدم نموذج مشترك أنظمة عدة، ويعمل النظام نفسه في ظروف مختلفة. لا يصبح معيار أداء منشور دليلاً لكل استخدام تابع تلقائياً. احفظ المسار من معلومات المكون إلى الخلاصة المحلية.

تقترح الورقة الأصلية لبطاقات النماذج توثيق الاستخدام المقصود وظروف التقييم. وتمتد البنية هنا إلى قرارات النظام والبيئة المحلية، ولا تعيد إنتاج بطاقات أمثلة الورقة.

اكتب الاستخدام المقصود بحيث يُعرف المستبعد

صف المهمة ومستفيد الناتج ودوره في القرار. «كشف عيوب العبوة» أقل فائدة من «إظهار عيوب محتملة في وصلة الكرتون لمراجع جودة مدرب على خط محدد». يميز الوصف المساعدة في الفرز من الإفراج الآلي عن المنتج أو إيقاف العملية أو اعتماد السلامة.

احصر الاستخدامات المتوقعة التي لا يدعمها الدليل، مثل مادة أو موضع كاميرا أو عائلة منتج أو لغة أو مجتمع جديد. اشرح سبب الاستبعاد حيث يُعرف: غياب تقييم أو مدخل غير متوافق أو أثر غير مفحوص أو فشل مشاهد. تجنب صياغة تستبعد كل شيء دون حد عملي.

اربط الغرض بـتصنيف الحالة والاعتماد. بطاقة النموذج تقدم معلومات ولا تمنح صلاحية التشغيل بذاتها. يسمي الإذن نسخة التوثيق وشروطها.

وثّق الهوية والأصل دون اختلاق حقائق غير متاحة

سجّل المعرّف والنسخة أو مرجع الإصدار والمطور أو المورد ومصدر المكون ومرجع الترخيص أو العقد والتعديلات المحلية. أدرج تاريخ وأساس إفادات المورد. وإذا غابت الأوزان أو بيانات التدريب أو النسخة الدقيقة، فصرّح بالقيد.

افصل الحقيقة المعروفة وادعاء المورد والملاحظة المحلية. قد يحتاج نموذج معلن متعدد اللغات إلى تقييم محلي للمهمة العربية. والادعاء بشأن التدريب ليس الدليل نفسه الذي يقدمه التزام تعاقدي أو إعداد مثبت. أظهر الفروق لصاحب قرار النشر.

للنموذج المعدل، دوّن ما تغير وما يلزم تجديد دليله. يؤثر الضبط الدقيق أو التكميم أو تعليمات النظام المحيط أو المعالجة الأولية بطرق مختلفة. لا تجمعها في تسمية عامة «مخصص».

استخدم حقولاً تؤثر في القرار

بنية أصلية لتوثيق النموذج واستخدامه المحلي

القسم	المحتوى المفيد
الهوية	النموذج والنسخة والأصل وحالة الدليل
المهمة والدور	الناتج المقصود وكيف يستخدمه الشخص أو النظام
المدخلات	الحقول والصيغ والوحدات والمعالجة الأولية
المخرجات	المعنى والحدود وعدم اليقين ومعالجة الناتج غير الصالح
معلومات التطوير	حقائق التدريب أو التكييف المتاحة والفجوات
التقييم	غرض البيانات ومجتمعها وظروفها ومقاييسها ونتائجها
القيود	الظروف غير المدعومة وأنماط الفشل
سياق النظام	القواعد والواجهات والمراجعة البشرية والإجراءات التابعة
البيئة	الإعداد والوصول والظروف والمالك
التشغيل	المراقبة ومحفزات التغيير والبديل والإنهاء

يساعد كل حقل على الحكم أو التشغيل. لا تملأ الفجوات بلغة عامة تصف أي نموذج. عند غياب المعلومة، حدد صاحب السؤال والقرار المتأثر. القيد الشفاف أنفع من وصف واثق بلا مصدر.

اربط الأدلة المضبوطة دون نسخ البيانات الخام. قد يحتاج السجل إلى تقييد إذا كشف خصائص مصادر أو تصميماً أمنياً أو معلومات مورد سرية. وفر ملخصاً للمشغل يحفظ الحدود العملية دون كشف غير لازم.

صف مجتمعات التقييم ومقامات القياس

اذكر سبب إنشاء مجموعة التقييم وطريقة اختيارها والظروف التي تغطيها. افصل أمثلة التطوير وحالات الضبط والتشخيص وأدلة القبول. تجيب مجموعة صعبة مختارة عمداً عن سؤال مختلف عن عينة تشغيل ممثلة.

عرّف المقياس وفق القرار. في فرز العيوب، تختلف نتائج العيب الفائت عن الإحالة غير الضرورية. قد تخفي نسبة التصنيف الصحيح الإجمالية أياً منهما. اعرض الأعداد والشرائح المناسبة لفهم المفاضلة.

سجّل الحدود والحالات المستبعدة أو الفاشلة. قد تبالغ نتيجة تحذف الصور غير المقروءة أو انتهاء المهلة في الفائدة التشغيلية. بيّن هل تُحال هذه الحالات للبشر أو تعاد أو تدخل المقام. يتيح التوثيق للمراجع المخول إعادة فحص النتيجة والطعن في أساسها.

مثال تطبيقي: نقل فحص العبوات إلى خط بملصقات عاكسة

لنفترض مصنعاً يستخدم نموذجاً لإظهار عيوب محتملة في وصلة الكرتون لمراجع الجودة. قُيّم الإعداد الأصلي على الخط A، ويريد الفريق نقله إلى B حيث تختلف ظروف الكاميرا والملصقات العاكسة. تبقى هوية النموذج، لكن الدليل المحلي قد لا ينتقل.

للتوضيح، تضم كل مجموعة تشخيصية 120 صورة موسومة: عشرين معيبة ومئة سليمة. على A يحدد النموذج 18 صورة معيبة وأربع صور سليمة خطأ، ويفوته عيبان ويترك 96 صورة سليمة دون إشارة على نحو صحيح. فيكون الصحيح 114 من 120، أي 95%.

على B يحدد 12 معيبة وصورتين سليمتين خطأ، ويفوته ثمانية عيوب ويترك 98 صورة سليمة دون إشارة على نحو صحيح. الإجمالي 110/120، نحو 91.7%، لكن كشف العيوب ينخفض من 18/20، أي 90%، إلى 12/20، أي 60%. هذه نتائج تشخيصية افتراضية وليست نتائج عميل مقاسة أو تقديراً للإنتاج.

تكشف الأعداد حدود الدقة الإجمالية

النتيجة	الخط A	الخط B
عيوب مكتشفة صحيحاً	18	12
عيوب فائتة	2	8
صور سليمة أُشير إليها خطأ	4	2
صور سليمة تُركت دون إشارة بصورة صحيحة	96	98
إجمالي الصور	120	120
التصنيف الصحيح	114/120 = 95%	110/120 ≈ 91.7%
العيوب المكتشفة	18/20 = 90%	12/20 = 60%

يحفظ التوثيق المجموعتين وظروفهما. الملصقات العاكسة فرق محتمل التأثير، لكن المقارنة وحدها لا تثبت السببية. قد يفحص التحقيق موضع الكاميرا والإضاءة وتنوع العبوة وجودة الوسوم. ميّز تراجع الأداء المشاهد عن فرضية تفسيره.

يمكن مواصلة تقييم إعداد معدل للخط B دون إعلان عدم صلاحية النموذج عموماً. ويجب أيضاً عدم اعتبار قبول A إذناً لـB. يتعلق القرار بمسار الفرز المحلي والدليل اللازم لفائدته داخل دوره المعتمد.

وثّق معنى الدرجات والحدود

اشرح معنى درجة المخرج في النظام المعين. لا تسمّها احتمال صحة ما لم يدعم الدليل ذلك. قد تفيد قيمة تشبه الثقة في التوجيه دون أن تكون احتمالاً معايراً. يعرف المشغل كيف اختير الحد وما المفاضلة التي ينشئها.

سجّل اختلاف الحدود بحسب البيئة ومن يغيرها. قد يكشف خفض الحد عيوباً أكثر ويزيد مراجعات غير لازمة. إنها مفاضلة تشغيلية تحتاج دليلاً على قدرة المراجع ونتيجة العيب الفائت، لا تفضيلاً تقنياً فقط.

غطِّ المدخل غير الصالح أو الخارج عن النطاق. للصورة الفارغة أو الوصلة المحجوبة أو المنتج غير المدعوم معالجة محددة. توثيق درجات الحالات الناجحة فقط يترك المشغل يرتجل عند أكثر الظروف إرباكاً.

اربط القيود بسلوك المشغل

يحدد القيد ما يفعله المستخدم بصورة مختلفة. «قد يتغير الأداء» لا يوجه العمل. أما «استخدم إعداد الخط الذي جرى تقييمه فقط وأحل الصورة ذات الوصلة المحجوبة للفحص اليدوي» فيحدد حداً مشهوداً إذا كان هو التصميم المصرح به فعلاً.

حدد من يتلقى القيد وكيف يُتحقق من فهمه. قد يحتاج مراجع الجودة ومالك الإطلاق والصيانة إلى تفاصيل مختلفة. لا يضمن ملحق طويل رؤية الشرط عند الاستخدام.

اربط القيود بـخريطة المسؤوليات. يملك شخص فحص جودة المدخل وقدرة المراجعة وتغير المصدر أو الكاميرا وقرار التوقف. لا يُفترض أن مطور النموذج يملك كل واجبات التشغيل التالية.

افصل وثائق المورد عن الأدلة المحلية

احتفظ بوثيقة المورد الحالية والنسخة التي استُخدمت في التقييم المحلي. أضف الأدلة المحلية دون دمج الادعاءات بطريقة تخفي مصدرها. راجع الفرق بين المهمة المعلن عنها والاستخدام الفعلي.

اطلب المعلومات اللازمة للقرار، لا كل سجل تدريب تلقائياً. تحدد متطلبات أدلة المورد التوثيق والقيود والإخطار والدعم المقبولين. وإذا غابت معلومة مهمة، فسجل أثرها في التقييم والإذن.

قد يستلزم تحديث المورد مراجعة الأدلة المحلية رغم ثبات اسم المنتج. وقد يبطل تغير الكاميرا أو المسار النتيجة المحلية رغم ثبات النموذج. يربط التوثيق اتجاهي التغيير.

صن النسخ ومحفزات المراجعة وتاريخ الإنهاء

عيّن مالكاً لكل طبقة واحفظ النسخ المعتمدة. اربط تغير النموذج والنظام بـمحفزات التغيير، بما يشمل المدخل والحدود والمستخدم والإجراء التالي. يكشف التحديث الدوري التقادم لكنه لا يحل محل مراجعة الحدث.

عند الإطلاق، تحقق من مطابقة الإعداد للتوثيق. وعند الإنهاء، احفظ التاريخ اللازم لتفسير المخرجات والالتزامات. إزالة واجهة النموذج لا تزيل التنبؤ المخزن أو القرار المبني عليه بالضرورة.

استخدم حصر الذكاء الاصطناعي لربط السجلات عبر الاستخدامات. يُتتبع تحديث نموذج واحد إلى البيئات المتأثرة، ولا يُعمم قيد محلي على استخدامات أخرى ذات أدلة مختلفة.

احفظ تسلسل أدلة التقييم عند تصحيح وسم مرجعي

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

سجل افتراضي لتسلسل أدلة تقييم الاستخدام المقترح على الخط ب

الحقل	المحتوى أو الدليل المطلوب
الغرض	تشخيص قابلية الانتقال إلى الخط ب، لا تقدير جميع عيوب الإنتاج
مجتمع التقييم	مجموعة الصور التشخيصية المحددة وعددها 120، ومنها عشرون صورة موسومة بوجود عيب
الإعداد	روابط سجلات الكاميرا والمعالجة المسبقة والنموذج وحد القرار
مرجعية الوسم	مراجع الجودة المسؤول عن حسم صور وصلة الكرتون الملتبسة
حصر الحالات	تفسير مصير كل صورة: قُيّمت أو رُفضت أو تعذر الوصول إليها
حد الاستنتاج	عدم استنتاج أن الإذن الخاص بالخط أ يشمل الخط ب

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

ميّز أيضاً بين التقييم واختيار حد القرار. إذا عدّل الفريق الحد مرات متتابعة بالاستناد إلى الصور التشخيصية نفسها، فصف ذلك بأنه تطوير أو تحقيق في الأداء. أما الحجة اللاحقة لقبول الاستخدام فتحتاج إلى أدلة ملائمة للاستنتاج المطلوب، تشمل حالات لا تكرر فقط ما اعتاد الفريق تحسينه. اشرح هذا القيد في السجل دون الادعاء بأن الوصول إلى عدد ثابت من الصور يكفي وحده لضمان تقدير صحيح لأداء الإنتاج.

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

استخرج بطاقة المشغل من القيود التي تغير التصرف

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

اختبر البطاقة مع مشغل لم يشارك في كتابتها. قدم له صورة من الخط المعتمد، وصورة حُجب فيها موضع وصلة الكرتون، وصورة من الخط الثاني المقترح. اسأله عن الدليل المنطبق والإجراء المسموح والجهة التي تتلقى الحالة غير المحسومة. يختبر التمرين صلاحية الوثيقة للاستخدام، لا قدرة الموظف على حفظ ملحق تقني. وإذا استنتج قارئان صلاحيات مختلفة للإفراج عن المنتج، فعدّل العبارة وتحقق من الإذن الفعلي قبل الاعتماد عليها.

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

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

اختبر دعم التوثيق لقرار فعلي

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

اطلب من المشغل شرح التصرف مع مدخل غير مقروء ودرجة غير مؤكدة وبيئة متغيرة. قارن ذلك بالتصميم المعتمد. يدعم التوثيق فعلاً متسقاً ولا يكتفي باستيفاء عناوين قائمة.

ناقش توثيق نماذج الذكاء الاصطناعي مع Open for AI باستخدام نموذج ومساره التشغيلي. المخرج المفيد شرح مترابط ذو نسخ للقدرة والقيود، تدعمه أدلة محلية ويكفي لتوجيه الاعتماد والتشغيل والتغيير.