اختبار عينات الدورة

تحقق من أن دفاتر الدروس وعينات الشيفرة تعمل ضد إعداد Microsoft Foundry / Azure OpenAI مباشر.
يشتمل المستودع على مشغل في
`scripts/validate-notebooks.ps1` الذي
ينفذ كل دفتر ملاحظات بايثون بدون واجهة ويطبع مصفوفة تمر/فشل.

متى تستخدم

• "تحقق من صحة كل دفاتر الملاحظات / العينات مقابل اشتراك Azure الخاص بي."
• "اختبار سريع للدورة بعد تحديث الحزم أو تغيير النماذج."
• "أي الدروس لا تزال تمر / تفشل مباشرة؟"

لا تستخدم هذا لاختبار AI Smoke Test GitHub Action (الذي يتحقق من العملاء النشرين
المستضافين — راجع `tests/README.md`). تقوم هذه المهارة
بتشغيل دفاتر الملاحظات محليًا.

المتطلبات الأساسية (افحص أولاً)

1. بايثون 3.12+ مع تبعيات الدورة: python -m pip install -r requirements.txt
   بالإضافة إلى المشغل: python -m pip install nbconvert ipykernel.
2. .env في جذر المستودع (انسخ من `.env.example`) مع على الأقل:
   • AZURE_AI_PROJECT_ENDPOINT — نقطة نهاية مشروع Foundry
     (https://<account>.services.ai.azure.com/api/projects/<project>)
   • AZURE_AI_MODEL_DEPLOYMENT_NAME — نشر غير مهجور (مثل gpt-5-mini)
   • AZURE_OPENAI_ENDPOINT (https://<account>.openai.azure.com) و AZURE_OPENAI_DEPLOYMENT
     للدروس التي تستدعي Azure OpenAI مباشرة (الدرس 06، 02-azure-openai، 14 التسليم/الحلقة البشرية).
3. إتمام تسجيل الدخول az — تقوم العينات بالمصادقة باستخدام AzureCliCredential (Entra ID، بدون مفتاح).
4. تحقق من وجود نشر النموذج:
   az cognitiveservices account deployment list -g <rg> -n <account> -o table.

تشغيل التحقق

# كل دفاتر بايثون (يتجاوز .NET، .venv، site-packages، الترجمات، موارد المهارات)
pwsh scripts/validate-notebooks.ps1

# درس واحد، مع مهلة أطول لكل خلية
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# فقط عرض ما سيتم تشغيله (دون تنفيذ)
pwsh scripts/validate-notebooks.ps1 -List

# مترجم صريح (إذا لم يكن `python` في PATH، مثلًا اسم مستعار لمتجر ويندوز)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"

تقوم السكربت بكتابة نسخ منفذة، وسجلات لكل دفتر ملاحظات، وresults.json إلى
$env:TEMP\aiab-nbval وتخرج بعدد حالات الفشل.

يتم إعادة محاولة الإخفاقات المؤقتة (حدود سرعة HTTP 429 لاشتراك مشترك، تعطل
عرضي لـ AzureCliCredential، أو انتهاء المهلة) تلقائيًا
(-Retries، الافتراضي 2، مع تأخير الإعادة -RetryDelaySeconds، الافتراضي 20). إذا كان
نشر النموذج يعاني من 429 بشكل منتظم، تحقق من حصة TPM العالمية للاشتراك
(az cognitiveservices usage list -l <region>) — زيادة سعة نشر واحد
لا تساعد عندما يتم استنفاد حصة الاشتراك.

تفسير النتائج

• PASS — تم تشغيل دفتر الملاحظات كاملاً بدون خطأ في أي خلية.
• FAIL — يتم عرض أول سطر *Error / *Exception؛ افتح سطر السجل المطابق
  log_*.txt في مجلد المخرجات للتمشيط الكامل.
• فشل دفتر ملاحظات واحد مقيد بـ -Timeout (لكل خلية)، لذا تظهر خلايا التدخل البشري المتوقفة
  كـStdinNotImplementedError بدلاً من التوقف.

دروس تحتاج إلى موارد إضافية (من المتوقع أن تفشل بدونها)

الدرس	متطلب إضافي
05 Agentic RAG	بحث Azure AI (AZURE_SEARCH_SERVICE_ENDPOINT، المفتاح) — يحتوي على مسار احتياطي في الذاكرة
11 MCP / GitHub	خادم GitHub MCP + PAT
13 memory (cognee)	cognee مهيأ مع مزود نموذج
15 استخدام المتصفح	متصفحات Playwright مثبتة (playwright install) + AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
17 وكيل محلي	بيئة تنفيذ Foundry المحلية + نموذج Qwen محمل (على الجهاز، بدون سحابة)
دفاتر *-dotnet-*	نواة .NET Interactive (مستبعدة افتراضيًا؛ استخدم -IncludeDotnet)

التبليغ

لخّص كجدول PASS/FAIL مجمع حسب الدرس. افصل بين التراجع الحقيقي
(أخطاء الشيفرة / التكوين التي يجب إصلاحها) وفجوات البيئة (فقدان البحث / Foundry المحلية / PAT)،
واستشهد بسجلات log_*.txt للفشل الحقيقي.

---

تنويه:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.