العربية | البنغالية | البلغارية | البورمية (ميانمار) | الصينية (مبسطة) | الصينية (تقليدية، هونغ كونغ) | الصينية (تقليدية، ماكاو) | الصينية (تقليدية، تايوان) | الكرواتية | التشيكية | الدنماركية | الهولندية | الإستونية | الفنلندية | الفرنسية | الألمانية | اليونانية | العبرية | الهندية | المجرية | الإندونيسية | الإيطالية | اليابانية | الكنادية | الخميرية | الكورية | الليتوانية | الماليزية | المالايالامية | الماراثية | النيبالية | البيجين النيجيري | النرويجية | الفارسية (اللغة الفارسية) | البولندية | البرتغالية (البرازيل) | البرتغالية (البرتغال) | البنجابية (غورموخي) | الرومانية | الروسية | الصربية (السيريلية) | السلوفاكية | السلوفينية | الإسبانية | السواحلية | السويدية | التاغالوغية (الفلبينية) | التاميلية | التيلوجو | التايلاندية | التركية | الأوكرانية | الأردية | الفيتنامية
تفضل الاستنساخ محليًا؟
يتضمن هذا المستودع أكثر من 50 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. للاستنساخ بدون الترجمات، استخدم الاستنساخ الجزئي:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git cd AZD-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git cd AZD-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"هذا يمنحك كل ما تحتاجه لإكمال الدورة مع تنزيل أسرع بكثير.
لقد توسع Azure Developer CLI ليشمل ما هو أبعد من تطبيقات الويب التقليدية وواجهات برمجة التطبيقات. اليوم، azd هو الأداة الوحيدة لنشر أي تطبيق إلى Azure — بما في ذلك التطبيقات المدعومة بالذكاء الاصطناعي والوكلاء الأذكياء.
إليك ما يعنيه ذلك لك:
- الوكلاء المعتمدون على الذكاء الاصطناعي صاروا الآن أحمال عمل معترف بها في azd. يمكنك تهيئة ونشر وإدارة مشاريع وكلاء الذكاء الاصطناعي باستخدام نفس تدفق العمل
azd init→azd upالذي تعرفه بالفعل. - تكامل Microsoft Foundry يجلب نشر النماذج واستضافة الوكلاء وتكوين خدمات الذكاء الاصطناعي مباشرة إلى نظام قوالب azd.
- لم يتغير تدفق العمل الأساسي. سواءً كنت تنشر تطبيق قائمة مهام، أو خدمة مصغرة، أو حل ذكاء اصطناعي متعدد الوكلاء، فإن الأوامر هي نفسها.
إذا كنت قد استخدمت azd من قبل، فإن دعم الذكاء الاصطناعي هو امتداد طبيعي — وليس أداة منفصلة أو مسارًا متقدمًا. إذا كنت تبدأ من الصفر، ستتعلم تدفق عمل واحد يعمل لكل شيء.
Azure Developer CLI (azd) هي أداة سطر أوامر صديقة للمطور تسهّل نشر التطبيقات إلى Azure. بدلاً من إنشاء وربط العشرات من موارد Azure يدويًا، يمكنك نشر تطبيقات كاملة بأمر واحد.
# هذا الأمر الواحد يقوم بكل شيء:
# ✅ ينشئ جميع موارد Azure
# ✅ يضبط الشبكات والأمان
# ✅ يبني شفرة التطبيق الخاص بك
# ✅ ينشر على Azure
# ✅ يوفر لك رابطًا يعمل
azd upهذا كل شيء! لا نقر على بوابة Azure، لا قوالب ARM معقّدة لتعلّمها أولًا، ولا تكوين يدوي — فقط تطبيقات تعمل على Azure.
هذا هو السؤال الأكثر شيوعًا بين المبتدئين. إليك الإجابة البسيطة:
| Feature | Azure CLI (az) |
Azure Developer CLI (azd) |
|---|---|---|
| الغرض | إدارة موارد Azure الفردية | نشر تطبيقات كاملة |
| النهج | مركّز على البنية التحتية | مركّز على التطبيق |
| مثال | az webapp create --name myapp... |
azd up |
| منحنى التعلم | يجب معرفة خدمات Azure | يكفي معرفة تطبيقك |
| الأفضل لـ | DevOps، البنية التحتية | المطورون، النماذج الأولية |
- Azure CLI مثل امتلاك كل الأدوات لبناء منزل - مطارق، مناشير، مسامير. يمكنك بناء أي شيء، لكن عليك معرفة البناء.
- Azure Developer CLI مثل توظيف مقاول - تصف ما تريد، وهم يتولون البناء.
| Scenario | Use This |
|---|---|
| "أريد نشر تطبيق الويب الخاص بي بسرعة" | azd up |
| "أحتاج لإنشاء حساب تخزين فقط" | az storage account create |
| "أقوم ببناء تطبيق ذكاء اصطناعي كامل" | azd init --template azure-search-openai-demo |
| "أحتاج إلى تصحيح مورد Azure محدد" | az resource show |
| "أريد نشر جاهز للإنتاج في دقائق" | azd up --environment production |
يستخدم AZD Azure CLI تحت الغطاء. يمكنك استخدام كلاهما:
# انشر تطبيقك باستخدام AZD
azd up
# ثم اضبط الموارد المحددة باستخدام Azure CLI
az webapp config set --name myapp --always-on trueلا تبدأ من الصفر! Awesome AZD هو مجموعة المجتمع من القوالب الجاهزة للنشر:
| Resource | Description |
|---|---|
| 🔗 معرض Awesome AZD | تصفح أكثر من 200 قالب مع إمكانية النشر بنقرة واحدة |
| 🔗 إرسال قالب | ساهم بقالبك الخاص للمجتمع |
| 🔗 مستودع GitHub | ضع نجمة واستكشف المصدر |
# دردشة RAG مع نماذج Microsoft Foundry + بحث الذكاء الاصطناعي
azd init --template azure-search-openai-demo
# تطبيق دردشة الذكاء الاصطناعي السريع
azd init --template openai-chat-app-quickstart
# وكلاء الذكاء الاصطناعي مع وكلاء Foundry
azd init --template get-started-with-ai-agentsقبل أن تبدأ، تأكد من أن جهازك جاهز للقالب الذي تريد نشره:
Windows:
.\validate-setup.ps1macOS / Linux:
bash ./validate-setup.shإذا فشل أي فحص مطلوب، أصلح ذلك أولًا ثم تابع البدء السريع.
Windows:
winget install microsoft.azdmacOS:
brew tap azure/azd && brew install azdLinux:
curl -fsSL https://aka.ms/install-azd.sh | bash# اختياري إذا كنت تخطط لاستخدام أوامر Azure CLI مباشرة في هذه الدورة
az login
# مطلوب لتدفقات عمل AZD
azd auth loginإذا لم تكن متأكدًا أي واحد تحتاجه، اتبع سير الإعداد الكامل في التثبيت والإعداد.
# التهيئة من قالب
azd init --template todo-nodejs-mongo
# النشر على أزور (ينشئ كل شيء!)
azd up🎉 هذا كل شيء! تطبيقك الآن متاح على Azure.
# Remove all resources when done experimenting
azd down --force --purgeتم تصميم هذه الدورة للتعلّم التدريجي - ابدأ من حيث تشعر بالراحة وتقدّم تدريجيًا:
| Your Experience | Start Here |
|---|---|
| جديد على Azure تمامًا | الفصل 1: الأساس |
| تعرف على Azure، جديد على AZD | الفصل 1: الأساس |
| تريد نشر تطبيقات ذكاء اصطناعي | الفصل 2: تطوير يركز على الذكاء الاصطناعي |
| تريد ممارسة عملية | 🎓 ورشة عمل تفاعلية - مختبر إرشادي لمدة 3-4 ساعات |
| تحتاج أنماط جاهزة للإنتاج | الفصل 8: أنماط الإنتاج والمؤسسات |
- افتح فورك لهذا المستودع:
- انسخه:
git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git - احصل على المساعدة: مجتمع Azure على ديسكورد
تفضل الاستنساخ محليًا؟
يتضمن هذا المستودع أكثر من 50 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. للاستنساخ بدون الترجمات، استخدم الاستنساخ الجزئي:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git cd AZD-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'هذا يمنحك كل ما تحتاجه لإكمال الدورة مع تنزيل أسرع بكثير.
اتقن Azure Developer CLI (azd) عبر فصول منظمة مصممة للتعلّم التدريجي. تركيز خاص على نشر تطبيقات الذكاء الاصطناعي مع تكامل Microsoft Foundry.
استنادًا إلى رؤى مجتمع Microsoft Foundry على ديسكورد، 45% من المطورين يريدون استخدام AZD لأحمال عمل الذكاء الاصطناعي لكنهم يواجهون تحديات مع:
- هياكل الذكاء الاصطناعي المعقدة متعددة الخدمات
- ممارسات النشر للإنتاج في الذكاء الاصطناعي
- تكامل وتكوين خدمات Azure للذكاء الاصطناعي
- تحسين التكلفة لأحمال عمل الذكاء الاصطناعي
- استكشاف مشكلات النشر الخاصة بالذكاء الاصطناعي وإصلاحها
من خلال إكمال هذه الدورة المنظمة، ستتمكن من:
- إتقان أساسيات AZD: المفاهيم الأساسية، التثبيت، والتكوين
- نشر تطبيقات الذكاء الاصطناعي: استخدام AZD مع خدمات Microsoft Foundry
- تنفيذ البنية التحتية ككود: إدارة موارد Azure بقوالب Bicep
- استكشاف أخطاء النشر وإصلاحها: حل المشكلات الشائعة وتصحيح الأخطاء
- التحسين للإنتاج: الأمان، القابلية للتوسع، المراقبة، وإدارة التكاليف
- بناء حلول متعددة الوكلاء: نشر هياكل ذكاء اصطناعي معقدة
قبل أن تبدأ الفصل 1، تأكد من أن لديك ما يلي. تفترض خطوات التثبيت لاحقًا في هذا الدليل أن هذه الأساسيات قد تم التعامل معها بالفعل.
- اشتراك في Azure: يمكنك استخدام اشتراك موجود من العمل أو من حسابك الشخصي، أو إنشاء نسخة تجريبية مجانية للبدء.
- إذن لإنشاء موارد Azure: بالنسبة لمعظم التمارين، يجب أن يكون لديك على الأقل وصول Contributor على الاشتراك المستهدف أو مجموعة الموارد. قد تفترض بعض الفصول أيضًا أنه يمكنك إنشاء مجموعات موارد، هويات مُدارة، وتعيينات RBAC.
- حساب GitHub: هذا مفيد لإنشاء فورك للمستودع، تتبع تغييراتك، واستخدام GitHub Codespaces للورشة.
- المتطلبات المسبقة لوقت تشغيل القوالب: بعض القوالب تحتاج إلى أدوات محلية مثل Node.js أو Python أو Java أو Docker. شغّل مدقق الإعداد قبل البدء حتى تكتشف الأدوات المفقودة مبكرًا.
- الإلمام الأساسي بالترمنال: لست بحاجة لأن تكون خبيرًا، لكن ينبغي أن تكون مرتاحًا لتشغيل أوامر مثل
git clone,azd auth login, وazd up.
هل تعمل في اشتراك مؤسسي؟ إذا كانت بيئة Azure الخاصة بك تدار بواسطة مسؤول، فاتفق مسبقًا على أنه يمكنك نشر الموارد في الاشتراك أو مجموعة الموارد التي تخطط لاستخدامها. إن لم يكن كذلك، اطلب اشتراك صندوق رمل أو وصول Contributor قبل أن تبدأ.
جديد في Azure؟ ابدأ بنسخة تجريبية خاصة بك من Azure أو اشتراك الدفع حسب الاستخدام على https://aka.ms/azurefreetrial حتى تتمكن من إكمال التمارين من البداية إلى النهاية دون الانتظار لموافقات على مستوى المستأجر.
كل فصل له README مخصص بأهداف التعلم، بدايات سريعة، وتمارين:
| Chapter | Topic | Lessons | Duration | Complexity |
|---|---|---|---|---|
| الفصل 1: الأساسيات | البدء | أساسيات AZD | التثبيت | المشروع الأول | 30-45 دقيقة | ⭐ |
| الفصل 2: تطوير الذكاء الاصطناعي | تطبيقات محورها الذكاء الاصطناعي | تكامل Foundry | وكلاء الذكاء الاصطناعي | نشر النماذج | ورشة العمل | 1-2 ساعة | ⭐⭐ |
| الفصل 3: التكوين | المصادقة والأمن | التكوين | المصادقة والأمن | 45-60 دقيقة | ⭐⭐ |
| الفصل 4: البنية التحتية | IaC والنشر | دليل النشر | التوفير | 1-1.5 ساعة | ⭐⭐⭐ |
| الفصل 5: متعدد الوكلاء | حلول وكلاء الذكاء الاصطناعي | سيناريو التجزئة | أنماط التنسيق | 2-3 ساعة | ⭐⭐⭐⭐ |
| الفصل 6: ما قبل النشر | التخطيط والتحقق | فحوصات ما قبل الإقلاع | تخطيط السعة | اختيار SKU | App Insights | 1 ساعة | ⭐⭐ |
| الفصل 7: استكشاف الأخطاء | التصحيح والإصلاح | المشكلات الشائعة | التصحيح | مشكلات الذكاء الاصطناعي | 1-1.5 ساعة | ⭐⭐ |
| الفصل 8: الإنتاج | أنماط المؤسسات | ممارسات الإنتاج | 2-3 ساعة | ⭐⭐⭐⭐ |
| 🎓 Workshop | مختبر عملي | مقدمة | الاختيار | التحقق | التفكيك | التكوين | التخصيص | إزالة البنية التحتية | الخلاصة | 3-4 ساعات | ⭐⭐ |
إجمالي مدة الدورة: ~10-14 ساعة | تدرج المهارة: مبتدئ → جاهز للإنتاج
اختر مسارك التعليمي بناءً على مستوى الخبرة والأهداف
المتطلبات المسبقة: اشتراك Azure، معرفة أساسية بسطر الأوامر
المدة: 30-45 دقيقة
التعقيد: ⭐
- فهم أساسيات Azure Developer CLI
- تثبيت AZD على منصتك
- نشرك الناجح الأول
- 🎯 ابدأ هنا: ما هو Azure Developer CLI؟
- 📖 النظرية: أساسيات AZD - المفاهيم الأساسية والمصطلحات
- ⚙️ الإعداد: التثبيت والإعداد - أدلة خاصة بالمنصة
- 🛠️ عملي: مشروعك الأول - برنامج تعليمي خطوة بخطوة
- 📋 مرجع سريع: ورقة غش الأوامر
# التحقق السريع من التثبيت
azd version
# انشر تطبيقك الأول
azd init --template todo-nodejs-mongo
azd up💡 نتيجة الفصل: نشر تطبيق ويب بسيط على Azure باستخدام AZD بنجاح
✅ تحقق النجاح:
# بعد إكمال الفصل الأول، يجب أن تكون قادرًا على:
azd version # يعرض الإصدار المثبت
azd init --template todo-nodejs-mongo # يهيئ المشروع
azd up # ينشر إلى Azure
azd show # يعرض عنوان URL للتطبيق قيد التشغيل
# يفتح التطبيق في المتصفح ويعمل
azd down --force --purge # ينظف الموارد📊 الوقت المستغرق: 30-45 دقيقة
📈 مستوى المهارة بعد: قادر على نشر تطبيقات أساسية بشكل مستقل
📈 مستوى المهارة بعد: قادر على نشر تطبيقات أساسية بشكل مستقل
المتطلبات المسبقة: إكمال الفصل 1
المدة: 1-2 ساعة
التعقيد: ⭐⭐
- تكامل Microsoft Foundry مع AZD
- نشر تطبيقات مدعومة بالذكاء الاصطناعي
- فهم تكوينات خدمات الذكاء الاصطناعي
- 🎯 ابدأ هنا: تكامل Microsoft Foundry
- 🤖 وكلاء الذكاء الاصطناعي: دليل وكلاء الذكاء الاصطناعي - نشر وكلاء ذكيين باستخدام AZD
- 📖 الأنماط: نشر نماذج الذكاء الاصطناعي - نشر وإدارة نماذج الذكاء الاصطناعي
- 🛠️ ورشة العمل: مختبر ورشة الذكاء الاصطناعي - جعل حلول الذكاء الاصطناعي جاهزة لـ AZD
- 🎥 دليل تفاعلي: مواد الورشة - تعلم متصفح باستخدام MkDocs * DevContainer Environment
- 📋 قوالب: قوالب Microsoft Foundry
- 📝 أمثلة: أمثلة نشر AZD
# انشر أول تطبيق ذكاء اصطناعي خاص بك
azd init --template azure-search-openai-demo
azd up
# جرّب قوالب ذكاء اصطناعي إضافية
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty💡 نتيجة الفصل: نشر وتكوين تطبيق دردشة مدعوم بالذكاء الاصطناعي مع إمكانيات RAG
✅ تحقق النجاح:
# بعد الفصل الثاني، يجب أن تكون قادرًا على:
azd init --template azure-search-openai-demo
azd up
# اختبار واجهة الدردشة الخاصة بالذكاء الاصطناعي
# طرح أسئلة والحصول على ردود مدعومة بالذكاء الاصطناعي مع المصادر
# التحقق من أن تكامل البحث يعمل
azd monitor # التحقق من أن Application Insights يعرض بيانات القياس عن بُعد
azd down --force --purge📊 الوقت المستغرق: 1-2 ساعة
📈 مستوى المهارة بعد: قادر على نشر وتكوين تطبيقات ذكاء اصطناعي جاهزة للإنتاج
💰 وعي التكلفة: فهم تكاليف التطوير $80-150/شهر، وتكاليف الإنتاج $300-3500/شهر
بيئة التطوير (تقديري $80-150/شهر):
- Microsoft Foundry Models (الدفع حسب الاستخدام): $0-50/شهر (بناءً على استخدام التوكن)
- AI Search (المستوى الأساسي): $75/شهر
- Container Apps (الاستهلاك): $0-20/شهر
- التخزين (قياسي): $1-5/شهر
بيئة الإنتاج (تقديري $300-3,500+/شهر):
- Microsoft Foundry Models (PTU لأداء متسق): $3,000+/شهر أو الدفع حسب الاستخدام مع حجم مرتفع
- AI Search (المستوى القياسي): $250/شهر
- Container Apps (مُخصص): $50-100/شهر
- Application Insights: $5-50/شهر
- التخزين (ممتاز): $10-50/شهر
💡 نصائح لتحسين التكلفة:
- استخدم نماذج Microsoft Foundry في المستوى المجاني للتعلم (Azure OpenAI يتضمن 50,000 توكن/شهر)
- شغّل
azd downلإلغاء تخصيص الموارد عندما لا تكون في طور التطوير النشط - ابدأ بفوترة على أساس الاستهلاك، قم بالترقية إلى PTU فقط للإنتاج
- استخدم
azd provision --previewلتقدير التكاليف قبل النشر - فعّل التحجيم التلقائي: ادفع فقط مقابل الاستخدام الفعلي
مراقبة التكلفة:
# تحقق من التكاليف الشهرية المقدرة
azd provision --preview
# راقب التكاليف الفعلية في بوابة Azure
az consumption budget list --resource-group <your-rg>المتطلبات المسبقة: إكمال الفصل 1
المدة: 45-60 دقيقة
التعقيد: ⭐⭐
- تكوين وإدارة البيئات
- أفضل ممارسات المصادقة والأمن
- تسمية الموارد وتنظيمها
- 📖 التكوين: دليل التكوين - إعداد البيئة
- 🔐 الأمن: أنماط المصادقة والهوية المُدارة - أنماط المصادقة
- 📝 أمثلة: مثال تطبيق قاعدة بيانات - أمثلة قواعد بيانات AZD
- تكوين بيئات متعددة (dev, staging, prod)
- إعداد مصادقة بالهوية المُدارة
- تنفيذ تكوينات مخصصة لكل بيئة
💡 نتيجة الفصل: إدارة بيئات متعددة مع مصادقة وأمن مناسبين
المتطلبات المسبقة: إكمال الفصول 1-3
المدة: 1-1.5 ساعة
التعقيد: ⭐⭐⭐
- أنماط النشر المتقدمة
- البنية التحتية كرمز باستخدام Bicep
- استراتيجيات توفير الموارد
- 📖 النشر: دليل النشر - سير عمل كامل
- 🏗️ التوفير: توفير الموارد - إدارة موارد Azure
- 📝 أمثلة: مثال تطبيق الحاويات - نشرات محكمة الحاويات
- إنشاء قوالب Bicep مخصصة
- نشر تطبيقات متعددة الخدمات
- تنفيذ استراتيجيات النشر الأزرق-الأخضر
💡 نتيجة الفصل: نشر تطبيقات متعددة الخدمات المعقدة باستخدام قوالب بنية تحتية مخصصة
المتطلبات المسبقة: إكمال الفصول 1-2
المدة: 2-3 ساعة
التعقيد: ⭐⭐⭐⭐
- أنماط هندسة متعددة الوكلاء
- تنظيم وتنسيق الوكلاء
- نشرات ذكاء اصطناعي جاهزة للإنتاج
- 🤖 المشروع المميز: حل متعدد الوكلاء للتجزئة - تنفيذ كامل
- 🛠️ حزمة قوالب ARM: حزمة قوالب ARM متعددة الوكلاء للبيع بالتجزئة - نشر بنقرة واحدة
- 📖 الهندسة المعمارية: أنماط تنسيق متعدد الوكلاء - أنماط
# نشر الحل المتكامل متعدد الوكلاء لقطاع التجزئة
cd examples/retail-multiagent-arm-template
./deploy.sh
# استكشاف تكوينات الوكلاء
az deployment group show --resource-group <rg-name> --name <deployment-name>💡 نتيجة الفصل: نشر وإدارة حل ذكاء اصطناعي متعدد الوكلاء جاهز للإنتاج مع وكلاء العملاء والمخزون
المتطلبات المسبقة: إكمال الفصل 4
المدة: 1 ساعة
التعقيد: ⭐⭐
- تخطيط السعة والتحقق من الموارد
- استراتيجيات اختيار SKU
- فحوصات ما قبل الطيران والأتمتة
- 📊 التخطيط: Capacity Planning - التحقق من الموارد
- 💰 الاختيار: SKU Selection - خيارات موفِّرة للتكلفة
- ✅ التحقق: Pre-flight Checks - نصوص آلية
- تشغيل نصوص التحقق من السعة
- تحسين اختيارات SKU من حيث التكلفة
- تنفيذ فحوصات ما قبل النشر المؤتمتة
💡 نتيجة الفصل: التحقق من النشر وتحسينه قبل التنفيذ
المتطلبات المسبقة: إكمال أي فصل حول النشر
المدة: 1-1.5 ساعة
التعقيد: ⭐⭐
- مناهج منهجية لتصحيح الأخطاء
- المشكلات الشائعة والحلول
- استكشاف أخطاء الذكاء الاصطناعي وإصلاحها
- 🔧 المشكلات الشائعة: Common Issues - الأسئلة المتداولة والحلول
- 🕵️ تصحيح الأخطاء: Debugging Guide - استراتيجيات خطوة بخطوة
- 🤖 مشكلات خاصة بالذكاء الاصطناعي: AI-Specific Troubleshooting - مشكلات خدمات الذكاء الاصطناعي
- تشخيص حالات فشل النشر
- حل مشكلات المصادقة
- تصحيح اتصال خدمات الذكاء الاصطناعي
💡 نتيجة الفصل: تشخيص وحل مشكلات النشر الشائعة بشكل مستقل
المتطلبات المسبقة: إكمال الفصول 1-4
المدة: 2-3 ساعات
التعقيد: ⭐⭐⭐⭐
- استراتيجيات نشر الإنتاج
- أنماط أمنية مؤسسية
- المراقبة وتحسين التكلفة
- 🏭 الإنتاج: Production AI Best Practices - أنماط للمؤسسات
- 📝 أمثلة: Microservices Example - هياكل معقدة
- 📊 المراقبة: Application Insights integration - المراقبة
- تنفيذ أنماط أمنية مؤسسية
- إعداد مراقبة شاملة
- النشر إلى بيئة الإنتاج مع الحوكمة المناسبة
💡 نتيجة الفصل: نشر تطبيقات جاهزة للمؤسسات بقدرات إنتاجية كاملة
⚠️ حالة الورشة: قيد التطوير
مواد الورشة قيد الإعداد والتحسين حاليًا. الوحدات الأساسية تعمل، لكن بعض الأقسام المتقدمة غير مكتملة. نحن نعمل بنشاط لإتمام جميع المحتويات. تتبع التقدّم →
تعلّم عملي شامل باستخدام أدوات متصفح وتمارين موجهة
توفر مواد الورشة تجربة تعلم منظمة وتفاعلية تكمل المنهج القائم على الفصول أعلاه. تم تصميم الورشة لكل من التعلم الذاتي وجلسات بقيادة مدرّس.
- واجهة قائمة على المتصفح: ورشة كاملة مدعومة بـ MkDocs مع ميزات البحث والنسخ والثيمات
- تكامل GitHub Codespaces: إعداد بيئة تطوير بنقرة واحدة
- مسار تعلم منظم: تمارين موجهة من 8 وحدات (إجمالي 3-4 ساعات)
- منهجية تصاعدية: مقدمة → اختيار → تحقق → تفكيك → تكوين → تخصيص → إزالة → خاتمة
- بيئة DevContainer تفاعلية: أدوات واعتمادات مُعدّة مسبقًا
تتبع الورشة منهجية تصاعدية مكونة من 8 وحدات تأخذك من الاكتشاف إلى إتقان النشر:
| Module | Topic | What You'll Do | Duration |
|---|---|---|---|
| 0. Introduction | نظرة عامة على الورشة | فهم أهداف التعلم والمتطلبات المسبقة وبنية الورشة | 15 min |
| 1. Selection | اكتشاف القوالب | استكشاف قوالب AZD واختيار قالب الذكاء الاصطناعي المناسب لسيناريوك | 20 min |
| 2. Validation | نشر والتحقق | نشر القالب باستخدام azd up والتحقق من أن البنية التحتية تعمل |
30 min |
| 3. Deconstruction | فهم البنية | استخدام GitHub Copilot لاستكشاف بنية القالب، ملفات Bicep، وتنظيم الشيفرة | 30 min |
| 4. Configuration | الغوص في azure.yaml | اتقان تكوين azure.yaml، خطافات دورة الحياة، والمتغيرات البيئية |
30 min |
| 5. Customization | اجعله ملكك | تمكين البحث بالذكاء الاصطناعي، التتبع، التقييم، وتخصيصه لسيناريوك | 45 min |
| 6. Teardown | التنظيف | إيقاف الموارد بأمان باستخدام azd down --purge |
15 min |
| 7. Wrap-up | الخطوات التالية | مراجعة الإنجازات والمفاهيم الرئيسية ومواصلة رحلة التعلم | 15 min |
تدفّق الورشة:
Introduction → Selection → Validation → Deconstruction → Configuration → Customization → Teardown → Wrap-up
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
Overview Find the Deploy & Explore Master Customize Clean up Review &
right verify code & azure.yaml for your resources next steps
template structure scenario
# الخيار 1: GitHub Codespaces (موصى به)
# انقر على "Code" → "Create codespace on main" في المستودع
# الخيار 2: التطوير المحلي
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# اتبع تعليمات الإعداد في workshop/README.mdعند إكمال الورشة، سيستطيع المشاركون:
- نشر تطبيقات ذكاء اصطناعي للإنتاج: استخدام AZD مع خدمات Microsoft Foundry
- إتقان هياكل الوكلاء المتعددين: تنفيذ حلول منسقة لوكلاء الذكاء الاصطناعي
- تنفيذ أفضل ممارسات الأمان: تكوين المصادقة والتحكم في الوصول
- التحسين من أجل القابلية للتوسع: تصميم نشرات موفِّرة للتكلفة وعالية الأداء
- استكشاف مشاكل النشر وإصلاحها: حل المشكلات الشائعة بشكل مستقل
- 🎥 دليل تفاعلي: Workshop Materials - بيئة تعلم قائمة على المتصفح
- 📋 تعليمات وحدة بوحدة:
- 0. Introduction - نظرة عامة على الورشة والأهداف
- 1. Selection - العثور على قوالب الذكاء الاصطناعي واختيارها
- 2. Validation - نشر والتحقق من القوالب
- 3. Deconstruction - استكشاف بنية القالب
- 4. Configuration - اتقان azure.yaml
- 5. Customization - تخصيص لسيناريوك
- 6. Teardown - تنظيف الموارد
- 7. Wrap-up - مراجعة والخطوات التالية
- 🛠️ مختبر ورشة الذكاء الاصطناعي: AI Workshop Lab - تمارين مركزة على الذكاء الاصطناعي
- 💡 البدء السريع: Workshop Setup Guide - تكوين البيئة
مناسب لـ: التدريب المؤسسي، الدورات الجامعية، التعلم الذاتي، ومعسكرات تدريب المطورين.
بعيدًا عن الأساسيات، يقدّم AZD ميزات قوية لنشر الإنتاج:
- نشرات قائمة على القوالب - استخدم قوالب مُعدة مسبقًا لأنماط التطبيقات الشائعة
- البنية التحتية ككود - إدارة موارد Azure باستخدام Bicep أو Terraform
- تدفقات عمل متكاملة - توفير ونشر ومراقبة التطبيقات بسلاسة
- صديق للمطور - مُحسّن لزيادة إنتاجية وتجربة المطور
لماذا AZD لحلول الذكاء الاصطناعي؟ يتناول AZD أهم التحديات التي يواجهها مطورو الذكاء الاصطناعي:
- قوالب جاهزة للذكاء الاصطناعي - قوالب مُعدة مسبقًا لنماذج Microsoft Foundry وCognitive Services وأعباء عمل ML
- نشرات ذكاء اصطناعي آمنة - أنماط أمان مدمجة لخدمات الذكاء الاصطناعي ومفاتيح API ونقاط نهاية النماذج
- أنماط إنتاجية للذكاء الاصطناعي - أفضل الممارسات لنشر تطبيقات ذكاء اصطناعي قابلة للتوسع وموفِّرة للتكلفة
- تدفقات عمل شاملة للذكاء الاصطناعي - من تطوير النموذج إلى النشر الإنتاجي مع المراقبة المناسبة
- تحسين التكلفة - تخصيص موارد ذكي واستراتيجيات مقياس لأعباء عمل الذكاء الاصطناعي
- تكامل Microsoft Foundry - اتصال سلس إلى كتالوج نماذج Microsoft Foundry ونقاط النهاية
ابدأ من هنا إذا كنت تنشر تطبيقات ذكاء اصطناعي!
ملاحظة: تبيّن هذه القوالب أنماطًا مختلفة للذكاء الاصطناعي. بعضها عينات Azure خارجية، والبعض الآخر تطبيقات محلية.
| Template | Chapter | Complexity | Services | Type |
|---|---|---|---|---|
| Get started with AI chat | الفصل 2 | ⭐⭐ | AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights | خارجي |
| Get started with AI agents | الفصل 2 | ⭐⭐ | Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights | خارجي |
| Azure Search + OpenAI Demo | الفصل 2 | ⭐⭐ | AzureOpenAI + Azure AI Search + App Service + Storage | خارجي |
| OpenAI Chat App Quickstart | الفصل 2 | ⭐ | AzureOpenAI + Container Apps + Application Insights | خارجي |
| Agent OpenAI Python Prompty | الفصل 5 | ⭐⭐⭐ | AzureOpenAI + Azure Functions + Prompty | خارجي |
| Contoso Chat RAG | الفصل 8 | ⭐⭐⭐⭐ | AzureOpenAI + AI Search + Cosmos DB + Container Apps | خارجي |
| Retail Multi-Agent Solution | الفصل 5 | ⭐⭐⭐⭐ | AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB | محلي |
قوالب تطبيقات جاهزة للإنتاج مرتبطة بفصول التعلم
| Template | Learning Chapter | Complexity | Key Learning |
|---|---|---|---|
| openai-chat-app-quickstart | الفصل 2 | ⭐ | أنماط النشر الأساسية للذكاء الاصطناعي |
| azure-search-openai-demo | الفصل 2 | ⭐⭐ | تنفيذ RAG مع Azure AI Search |
| ai-document-processing | الفصل 4 | ⭐⭐ | تكامل Document Intelligence |
| agent-openai-python-prompty | الفصل 5 | ⭐⭐⭐ | إطار الوكلاء واستدعاء الدوال |
| contoso-chat | الفصل 8 | ⭐⭐⭐ | تنظيم ذكاء اصطناعي للمؤسسات |
| retail-multi-agent-solution | الفصل 5 | ⭐⭐⭐⭐ | هندسة متعددة الوكلاء مع وكلاء العملاء والمخزون |
📌 أمثلة محلية مقابل خارجية:
الأمثلة المحلية (في هذا المستودع) = جاهزة للاستخدام فورًا
الأمثلة الخارجية (عينات Azure) = استنساخ من المستودعات المرتبطة
- Retail Multi-Agent Solution - تنفيذ جاهز للإنتاج كامل مع قوالب ARM
- هندسة متعددة الوكلاء (وكيل العميل + وكيل المخزون)
- مراقبة وتقييم شاملة
- نشر بنقرة واحدة عبر قالب ARM
أمثلة شاملة لنشر الحاويات في هذا المستودع:
- Container App Examples - دليل كامل لنشرات الحاويات
- Simple Flask API - واجهة REST أساسية مع مقياس إلى الصفر
- Microservices Architecture - نشر متعدد الخدمات جاهز للإنتاج
- بدء سريع، إنتاج، وأنماط نشر متقدمة
- إرشادات المراقبة والأمان وتحسين التكلفة
استنسخ مستودعات عينات Azure هذه للبدء:
- Simple Web App - Node.js + MongoDB - أنماط نشر أساسية
- Static Website - React SPA - نشر محتوى ثابت
- Container App - Python Flask - نشر واجهة REST
- تطبيق قاعدة بيانات - C# + SQL - أنماط اتصال قاعدة البيانات
- Functions + Cosmos DB - تدفق عمل بيانات خالي من الخوادم
- الخدمات المصغرة بلغة Java - هندسة متعددة الخدمات
- Container Apps Jobs - المعالجة في الخلفية
- خط أنابيب ML للمؤسسات - نماذج تعلم آلي جاهزة للإنتاج
- معرض قوالب AZD الرسمي - مجموعة مُنسَّقة من القوالب الرسمية ومن قِبل المجتمع
- قوالب Azure Developer CLI - توثيق قوالب Microsoft Learn
- دليل الأمثلة - أمثلة محلية للتعلّم مع شروحات مفصلة
- مذكرة الأوامر - أوامر azd الأساسية منظمة حسب الفصل
- المصطلحات - مصطلحات Azure و azd
- الأسئلة الشائعة - أسئلة شائعة منظمة حسب الفصل التعليمي
- دليل الدراسة - تمارين عملية شاملة
- مختبر ورشة عمل الذكاء الاصطناعي - اجعل حلول الذكاء الاصطناعي قابلة للنشر عبر AZD (2-3 ساعات)
- ورشة تفاعلية - تمارين إرشادية مكونة من 8 وحدات باستخدام MkDocs و GitHub Codespaces
- يتبع: المقدمة → الاختيار → التحقق → التفكيك → التكوين → التخصيص → الإيقاف → الخلاصة
- مهارات Microsoft Azure على skills.sh - 37 مهارة وكيل مفتوحة لـ Azure AI و Foundry والنشر والتشخيص وتحسين التكلفة والمزيد. قم بتثبيتها في GitHub Copilot، Cursor، Claude Code، أو أي وكيل مدعوم:
npx skills add microsoft/github-copilot-for-azure
المشكلات الشائعة التي يواجهها المبتدئون والحلول الفورية:
❌ "azd: الأمر غير موجود"
# قم بتثبيت AZD أولاً
# ويندوز (PowerShell):
winget install microsoft.azd
# ماك أو إس:
brew tap azure/azd && brew install azd
# لينكس:
curl -fsSL https://aka.ms/install-azd.sh | bash
# تحقق من التثبيت
azd version❌ "لم يتم العثور على اشتراك" أو "الاشتراك غير مضبوط"
# عرض الاشتراكات المتاحة
az account list --output table
# تعيين الاشتراك الافتراضي
az account set --subscription "<subscription-id-or-name>"
# تعيين لبيئة AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"
# تحقق
az account show❌ "InsufficientQuota" أو "تم تجاوز الحصة"
# جرّب منطقة Azure مختلفة
azd env set AZURE_LOCATION "westus2"
azd up
# أو استخدم SKUs أصغر أثناء التطوير
# حرّر infra/main.parameters.json:
{
"sku": "B1" // Instead of "P1V2"
}❌ فشل "azd up" في منتصف العملية
# الخيار 1: نظف وحاول مرة أخرى
azd down --force --purge
azd up
# الخيار 2: أصلح البنية التحتية فقط
azd provision
# الخيار 3: تحقق من الحالة التفصيلية
azd show
# الخيار 4: تحقق من السجلات في Azure Monitor
azd monitor --logs❌ "فشل التوثيق" أو "انتهت صلاحية الرمز"
# أعد المصادقة لـ AZD
azd auth logout
azd auth login
# اختياري: حدّث Azure CLI أيضًا إذا كنت تشغّل أوامر az
az logout
az login
# تحقق من المصادقة
az account show❌ "المورد موجود بالفعل" أو تعارضات التسمية
# AZD ينشئ أسماءً فريدةً، ولكن إذا حدث تعارض:
azd down --force --purge
# ثم أعد المحاولة باستخدام بيئة جديدة
azd env new dev-v2
azd up❌ استغراق نشر القالب وقتًا طويلاً
أوقات الانتظار العادية:
- تطبيق ويب بسيط: 5-10 دقائق
- تطبيق يحتوي على قاعدة بيانات: 10-15 دقيقة
- تطبيقات الذكاء الاصطناعي: 15-25 دقيقة (تجهيز OpenAI بطيء)
# تحقق من التقدم
azd show
# إذا كنت عالقًا لأكثر من 30 دقيقة، فتحقق من بوابة Azure:
azd monitor --overview
# ابحث عن عمليات النشر الفاشلة❌ "تم رفض الإذن" أو "ممنوع"
# تحقق من دورك في Azure
az role assignment list --assignee $(az account show --query user.name -o tsv)
# تحتاج على الأقل إلى دور "المساهم"
# اطلب من مسؤول Azure الخاص بك منح:
# - دور المساهم (للموارد)
# - مسؤول وصول المستخدمين (لتعيينات الأدوار)❌ لا يمكن العثور على عنوان URL للتطبيق المنشور
# عرض جميع نقاط نهاية الخدمة
azd show
# أو افتح بوابة Azure
azd monitor
# تحقق من خدمة محددة
azd env get-values
# ابحث عن متغيرات *_URL- دليل المشكلات الشائعة: حلول مفصلة
- مشكلات خاصة بالذكاء الاصطناعي: استكشاف أخطاء الذكاء الاصطناعي وإصلاحها
- دليل التصحيح: التصحيح خطوة بخطوة
- احصل على مساعدة: Azure Discord #azure-developer-cli
تتبع تقدمك التعليمي عبر كل فصل:
- الفصل 1: الأساس والانطلاق السريع ✅
- الفصل 2: تطوير يركز على الذكاء الاصطناعي ✅
- الفصل 3: التكوين والمصادقة ✅
- الفصل 4: البنية التحتية ككود والنشر ✅
- الفصل 5: حلول الذكاء الاصطناعي متعددة الوكلاء ✅
- الفصل 6: التحقق والتخطيط قبل النشر ✅
- الفصل 7: استكشاف الأخطاء وإصلاحها وتصحيحها ✅
- الفصل 8: أنماط الإنتاج والمؤسسات ✅
بعد إكمال كل فصل، تحقق من معرفتك عبر:
- التمرين العملي: أكمل نشر الفصل العملي
- فحص المعرفة: راجع قسم الأسئلة الشائعة للفصل
- مناقشة مجتمعية: شارك تجربتك في Azure Discord
- الفصل التالي: انتقل إلى مستوى التعقيد التالي
بمجرد إكمال جميع الفصول، ستحصل على:
- خبرة إنتاجية: نشر تطبيقات ذكاء اصطناعي حقيقية على Azure
- مهارات مهنية: قدرات نشر جاهزة للمؤسسات
- الاعتراف المجتمعي: عضو نشط في مجتمع مطوري Azure
- التقدم الوظيفي: خبرات مطلوبة في نشر AZD والذكاء الاصطناعي
- المشكلات التقنية: الإبلاغ عن الأخطاء وطلب الميزات
- أسئلة التعلم: مجتمع Microsoft Azure على Discord و
- مساعدة خاصة بالذكاء الاصطناعي: انضم إلى
- التوثيق: التوثيق الرسمي لـ Azure Developer CLI
نتائج استطلاع الرأي الأخيرة من قناة #Azure:
- 45% من المطورين يرغبون في استخدام AZD لأعباء عمل الذكاء الاصطناعي
- أهم التحديات: نشر خدمات متعددة، إدارة بيانات الاعتماد، جاهزية الإنتاج
- الأكثر طلبًا: قوالب مخصصة للذكاء الاصطناعي، أدلة استكشاف الأخطاء، أفضل الممارسات
انضم إلى مجتمعنا لـ:
- شارك تجاربك مع AZD + الذكاء الاصطناعي واحصل على المساعدة
- الوصول إلى عروض مبكرة للقوالب الجديدة للذكاء الاصطناعي
- المساهمة في أفضل ممارسات نشر الذكاء الاصطناعي
- التأثير على تطوير ميزات AI + AZD المستقبلية
نرحب بالمساهمات! الرجاء قراءة دليل المساهمة للتفاصيل حول:
- تحسين المحتوى: تعزيز الفصول والأمثلة الحالية
- أمثلة جديدة: أضف سيناريوهات وقوالب من العالم الحقيقي
- الترجمة: ساعد في الحفاظ على دعم متعدد اللغات
- تقارير الأخطاء: حسّن الدقة والوضوح
- معايير المجتمع: اتبع إرشادات المجتمع الشاملة لدينا
هذا المشروع مرخّص بموجب رخصة MIT - راجع ملف LICENSE للتفاصيل.
فريقنا ينتج دورات تعليمية شاملة أخرى:
🚀 هل أنت مستعد للبدء بالتعلّم؟
المبتدئون: ابدأ بـ الفصل 1: الأساسيات والبداية السريعة
مطوروا الذكاء الاصطناعي: انتقل إلى الفصل 2: التطوير القائم على الذكاء الاصطناعي
المطورون ذوو الخبرة: ابدأ بـ الفصل 3: التهيئة والمصادقة
الخطوات التالية: ابدأ الفصل 1 - أساسيات AZD →
إخلاء المسؤولية: تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية هو المصدر المعتمد. للمعلومات الحرجة، يوصى بالاستعانة بترجمة بشرية محترفة. لا نتحمل أي مسؤولية عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة.
