هندسة برمجيات الذكاء الاصطناعي والتكامل
تحويل النموذج إلى برمجية تستطيع الأنظمة الأخرى استخدامها: كود نظيف، وواجهات برمجية، واختبارات، وإدارة إصدارات، ودمج مكوّنات الذكاء الاصطناعي في تطبيق أوسع.
في هذه الصفحة
- شرح كل قسم
- تمارين تفاعلية بعد كل قسم
- بطاقات سؤال وجواب تُقلب
- اختبار على الموضوع كامل
- سيناريوهات ومصطلحات في آخر الصفحة
1. تقديم النموذج خلف واجهة برمجية
الأنظمة الأخرى توصل نموذجك عبر واجهة برمجية. وتصميمها يقرّر هل التكامل معك سهل ولا مؤلم.
النموذج في الإنتاج خدمة، والخدمة تُعرَّف بعقدها: وش ترسل، ووش يرجع، ووش يصير لما يخرب شي. واضبط العقد يصير كل ما بعده أسهل.
و REST هي الخيار الشائع، واصطلاحاتها مهمة. POST للتنبؤ (لأنك ترسل بيانات، مو تجيب موردًا ثابتًا)، و JSON دخولًا وخروجًا، ورموز حالة ذات معنى: 200 للنجاح، و400 لما يرسل العميل شيئًا غير صالح، و401 لما ما يكون موثّقًا، و429 عند تجاوز المعدّل، و500 لما تتعطّل خدمتك.
والتقسيم بين 4xx و5xx يستحق تستوعبه: 4xx يعني إن المستدعي أخطأ، و5xx يعني إنك أنت أخطأت. وإرجاع 500 لمُدخل مستخدم سيّئ يرسل مهندس المناوبة يطارد عطلًا وهميًا.
وتحقّق دائمًا من المُدخل قبل ما يوصل النموذج. افحص المخطط، والأنواع، والنطاقات، والحقول المطلوبة. فالنموذج اللي يُعطى هراءً ما يرمي خطأ — بل يرجّع تنبؤًا واثقًا بلا معنى، وهذا أسوأ بكثير من رفض واضح.
وصدِّر واجهتك من اليوم الأول — /v1/predict مو /predict. فسلوك النموذج يتغيّر مع الوقت، ويحتاج المستدعون يقدرون يبقون على إصدار معروف وهم ينتقلون. وكسر تكامل حيّ بلا إنذار هو كيف تُهجَر التكاملات.
وشأنان عمليان آخران. أرجع إصدار النموذج مع كل تنبؤ عشان تُتتبَّع تذكرة الدعم للنموذج اللي أنتجها بالضبط. ولأي شي ياخذ أكثر من ثانية أو ثنتين، استخدم نمطًا غير متزامن: اقبل المهمة، وأرجع معرّفًا فورًا، وخلّ المستدعي يستعلم أو يستقبل خطّافًا (Webhook).
تخيّلها كذا
الواجهة البرمجية مثل منيو مطعم. تقول لك بالضبط وش تقدر تطلب، وبأي صيغة، ووش بيوصل. والمنيو الجيد يعني ما أحد يحتاج يدخل المطبخ ويسأل. وتغيير طبق بلا تغيير المنيو هو بالضبط كيف تحصل على زبائن غاضبين.
| الرمز | المعنى | خطأ مين |
|---|---|---|
| 200 | نجاح | — |
| 400 | جسم طلب غير صالح | المستدعي |
| 401 / 403 | غير موثّق / غير مسموح | المستدعي |
| 429 | تجاوز حدّ المعدّل | المستدعي |
| 500 | خطأ خادم | أنت |
نقاط أساسية للحفظ
- استخدم POST للتنبؤات، و JSON دخولًا وخروجًا، ورموز حالة ذات معنى.
- 4xx يعني إن المستدعي أخطأ؛ و5xx يعني إن خدمتك أخطأت.
- تحقّق من المُدخل قبل ما يشوفه النموذج — فالمُدخل السيّئ ينتج جوابًا خاطئًا واثقًا.
- صدِّر الواجهة من البداية، وأرجع إصدار النموذج مع كل تنبؤ.
- استخدم نمط المهام غير المتزامنة لأي شي أبطأ من ثانيتين.
مصطلحات مهمة
- API contract
- الشكل المتفق عليه للطلبات والردود — وش يجوز للمستدعين يرسلون وعلى وش يقدرون يعتمدون في الاستقبال.
- Idempotency
- خاصية إن تكرار نفس الطلب ينتج نفس النتيجة، فما تقدر إعادة المحاولة تسبّب إجراءً مكرّرًا.
تمرّن على هذا القسم
0 / 6بطاقات مراجعة سريعة
1 / 3هذي معاينة مجانية
فتحنا لك القسم الأول عشان تشوف بالضبط كيف مكتوبة الشروحات. وبقية أقسام هذا الموضوع (4) بتمارينها وبطاقاتها تُفتح بالاشتراك.
اللي يبقى مقفلًا في هذا الموضوع:
- 2. اختبار أنظمة التعلم الآلي
- 3. أنماط التكامل والموثوقية
- 4. إدارة الإصدارات وجودة الكود
- 5. معالجة الأخطاء وعقود البيانات
الاشتراك يفتح هذا في المواضيع الثمانية كلها — كل الأقسام، وبنك الأسئلة الكامل، وتمارين السيناريوهات والمصطلحات، والاختبار الشامل.
افتح كل المحتوىتدريب إضافي على هذا الموضوع
الاثنان يسحبان من كل الأقسام أعلاه، بترتيب عشوائي جديد كل مرة.