Skip to content

Latest commit

 

History

History
1058 lines (800 loc) · 66.9 KB

File metadata and controls

1058 lines (800 loc) · 66.9 KB

AZD للمبتدئين: مسار تعلّم منظم

AZD للمبتدئين

المتابِعون على GitHub تفرعات GitHub نجوم GitHub

ديسكورد Azure ديسكورد Microsoft Foundry


الترجمات التلقائية (محدّثة دائمًا)

العربية | البنغالية | البلغارية | البورمية (ميانمار) | الصينية (مبسطة) | الصينية (تقليدية، هونغ كونغ) | الصينية (تقليدية، ماكاو) | الصينية (تقليدية، تايوان) | الكرواتية | التشيكية | الدنماركية | الهولندية | الإستونية | الفنلندية | الفرنسية | الألمانية | اليونانية | العبرية | الهندية | المجرية | الإندونيسية | الإيطالية | اليابانية | الكنادية | الخميرية | الكورية | الليتوانية | الماليزية | المالايالامية | الماراثية | النيبالية | البيجين النيجيري | النرويجية | الفارسية (اللغة الفارسية) | البولندية | البرتغالية (البرازيل) | البرتغالية (البرتغال) | البنجابية (غورموخي) | الرومانية | الروسية | الصربية (السيريلية) | السلوفاكية | السلوفينية | الإسبانية | السواحلية | السويدية | التاغالوغية (الفلبينية) | التاميلية | التيلوجو | التايلاندية | التركية | الأوكرانية | الأردية | الفيتنامية

تفضل الاستنساخ محليًا؟

يتضمن هذا المستودع أكثر من 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"

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

🆕 ما الجديد في azd اليوم

لقد توسع Azure Developer CLI ليشمل ما هو أبعد من تطبيقات الويب التقليدية وواجهات برمجة التطبيقات. اليوم، azd هو الأداة الوحيدة لنشر أي تطبيق إلى Azure — بما في ذلك التطبيقات المدعومة بالذكاء الاصطناعي والوكلاء الأذكياء.

إليك ما يعنيه ذلك لك:

  • الوكلاء المعتمدون على الذكاء الاصطناعي صاروا الآن أحمال عمل معترف بها في azd. يمكنك تهيئة ونشر وإدارة مشاريع وكلاء الذكاء الاصطناعي باستخدام نفس تدفق العمل azd initazd up الذي تعرفه بالفعل.
  • تكامل Microsoft Foundry يجلب نشر النماذج واستضافة الوكلاء وتكوين خدمات الذكاء الاصطناعي مباشرة إلى نظام قوالب azd.
  • لم يتغير تدفق العمل الأساسي. سواءً كنت تنشر تطبيق قائمة مهام، أو خدمة مصغرة، أو حل ذكاء اصطناعي متعدد الوكلاء، فإن الأوامر هي نفسها.

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


🚀 ما هو Azure Developer CLI (azd)؟

Azure Developer CLI (azd) هي أداة سطر أوامر صديقة للمطور تسهّل نشر التطبيقات إلى Azure. بدلاً من إنشاء وربط العشرات من موارد Azure يدويًا، يمكنك نشر تطبيقات كاملة بأمر واحد.

سحر azd up

# هذا الأمر الواحد يقوم بكل شيء:
# ✅ ينشئ جميع موارد Azure
# ✅ يضبط الشبكات والأمان
# ✅ يبني شفرة التطبيق الخاص بك
# ✅ ينشر على Azure
# ✅ يوفر لك رابطًا يعمل
azd up

هذا كل شيء! لا نقر على بوابة Azure، لا قوالب ARM معقّدة لتعلّمها أولًا، ولا تكوين يدوي — فقط تطبيقات تعمل على Azure.


❓ Azure Developer CLI مقابل Azure CLI: ما الفرق؟

هذا هو السؤال الأكثر شيوعًا بين المبتدئين. إليك الإجابة البسيطة:

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

لا تبدأ من الصفر! Awesome AZD هو مجموعة المجتمع من القوالب الجاهزة للنشر:

Resource Description
🔗 معرض Awesome AZD تصفح أكثر من 200 قالب مع إمكانية النشر بنقرة واحدة
🔗 إرسال قالب ساهم بقالبك الخاص للمجتمع
🔗 مستودع GitHub ضع نجمة واستكشف المصدر

قوالب الذكاء الاصطناعي الشائعة من Awesome AZD

# دردشة 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

🎯 ابدأ في 3 خطوات

قبل أن تبدأ، تأكد من أن جهازك جاهز للقالب الذي تريد نشره:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

إذا فشل أي فحص مطلوب، أصلح ذلك أولًا ثم تابع البدء السريع.

الخطوة 1: تثبيت AZD (دقيقتان)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

curl -fsSL https://aka.ms/install-azd.sh | bash

الخطوة 2: المصادقة لـ AZD

# اختياري إذا كنت تخطط لاستخدام أوامر Azure CLI مباشرة في هذه الدورة
az login

# مطلوب لتدفقات عمل AZD
azd auth login

إذا لم تكن متأكدًا أي واحد تحتاجه، اتبع سير الإعداد الكامل في التثبيت والإعداد.

الخطوة 3: نشر تطبيقك الأول

# التهيئة من قالب
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: أنماط الإنتاج والمؤسسات

الإعداد السريع

  1. افتح فورك لهذا المستودع: تفرعات GitHub
  2. انسخه: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. احصل على المساعدة: مجتمع 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 ساعة | تدرج المهارة: مبتدئ → جاهز للإنتاج


📚 فصول التعلم

اختر مسارك التعليمي بناءً على مستوى الخبرة والأهداف

🚀 الفصل 1: الأساسيات والبدء السريع

المتطلبات المسبقة: اشتراك Azure، معرفة أساسية بسطر الأوامر
المدة: 30-45 دقيقة
التعقيد: ⭐

ماذا ستتعلم

  • فهم أساسيات 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 دقيقة
📈 مستوى المهارة بعد: قادر على نشر تطبيقات أساسية بشكل مستقل 📈 مستوى المهارة بعد: قادر على نشر تطبيقات أساسية بشكل مستقل


🤖 الفصل 2: تطوير الذكاء الاصطناعي أولاً (مُوصى به لمطوري الذكاء الاصطناعي)

المتطلبات المسبقة: إكمال الفصل 1
المدة: 1-2 ساعة
التعقيد: ⭐⭐

ماذا ستتعلم

  • تكامل 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>

⚙️ الفصل 3: التكوين والمصادقة

المتطلبات المسبقة: إكمال الفصل 1
المدة: 45-60 دقيقة
التعقيد: ⭐⭐

ماذا ستتعلم

  • تكوين وإدارة البيئات
  • أفضل ممارسات المصادقة والأمن
  • تسمية الموارد وتنظيمها

مصادر التعلم

تمارين عملية

  • تكوين بيئات متعددة (dev, staging, prod)
  • إعداد مصادقة بالهوية المُدارة
  • تنفيذ تكوينات مخصصة لكل بيئة

💡 نتيجة الفصل: إدارة بيئات متعددة مع مصادقة وأمن مناسبين


🏗️ الفصل 4: البنية التحتية كرمز والنشر

المتطلبات المسبقة: إكمال الفصول 1-3
المدة: 1-1.5 ساعة
التعقيد: ⭐⭐⭐

ماذا ستتعلم

  • أنماط النشر المتقدمة
  • البنية التحتية كرمز باستخدام Bicep
  • استراتيجيات توفير الموارد

مصادر التعلم

تمارين عملية

  • إنشاء قوالب Bicep مخصصة
  • نشر تطبيقات متعددة الخدمات
  • تنفيذ استراتيجيات النشر الأزرق-الأخضر

💡 نتيجة الفصل: نشر تطبيقات متعددة الخدمات المعقدة باستخدام قوالب بنية تحتية مخصصة


🎯 الفصل 5: حلول الذكاء الاصطناعي متعددة الوكلاء (متقدم)

المتطلبات المسبقة: إكمال الفصول 1-2
المدة: 2-3 ساعة
التعقيد: ⭐⭐⭐⭐

ماذا ستتعلم

  • أنماط هندسة متعددة الوكلاء
  • تنظيم وتنسيق الوكلاء
  • نشرات ذكاء اصطناعي جاهزة للإنتاج

مصادر التعلم

تمارين عملية

# نشر الحل المتكامل متعدد الوكلاء لقطاع التجزئة
cd examples/retail-multiagent-arm-template
./deploy.sh

# استكشاف تكوينات الوكلاء
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 نتيجة الفصل: نشر وإدارة حل ذكاء اصطناعي متعدد الوكلاء جاهز للإنتاج مع وكلاء العملاء والمخزون


🔍 الفصل 6: التحقق والتخطيط ما قبل النشر

المتطلبات المسبقة: إكمال الفصل 4
المدة: 1 ساعة
التعقيد: ⭐⭐

ما الذي ستتعلمه

  • تخطيط السعة والتحقق من الموارد
  • استراتيجيات اختيار SKU
  • فحوصات ما قبل الطيران والأتمتة

موارد التعلم

تمارين عملية

  • تشغيل نصوص التحقق من السعة
  • تحسين اختيارات SKU من حيث التكلفة
  • تنفيذ فحوصات ما قبل النشر المؤتمتة

💡 نتيجة الفصل: التحقق من النشر وتحسينه قبل التنفيذ


🚨 الفصل 7: استكشاف الأخطاء وإصلاحها وتصحيح الأخطاء

المتطلبات المسبقة: إكمال أي فصل حول النشر
المدة: 1-1.5 ساعة
التعقيد: ⭐⭐

ما الذي ستتعلمه

  • مناهج منهجية لتصحيح الأخطاء
  • المشكلات الشائعة والحلول
  • استكشاف أخطاء الذكاء الاصطناعي وإصلاحها

موارد التعلم

  • 🔧 المشكلات الشائعة: Common Issues - الأسئلة المتداولة والحلول
  • 🕵️ تصحيح الأخطاء: Debugging Guide - استراتيجيات خطوة بخطوة
  • 🤖 مشكلات خاصة بالذكاء الاصطناعي: AI-Specific Troubleshooting - مشكلات خدمات الذكاء الاصطناعي

تمارين عملية

  • تشخيص حالات فشل النشر
  • حل مشكلات المصادقة
  • تصحيح اتصال خدمات الذكاء الاصطناعي

💡 نتيجة الفصل: تشخيص وحل مشكلات النشر الشائعة بشكل مستقل


🏢 الفصل 8: أنماط الإنتاج والمؤسسات

المتطلبات المسبقة: إكمال الفصول 1-4
المدة: 2-3 ساعات
التعقيد: ⭐⭐⭐⭐

ما الذي ستتعلمه

  • استراتيجيات نشر الإنتاج
  • أنماط أمنية مؤسسية
  • المراقبة وتحسين التكلفة

موارد التعلم

تمارين عملية

  • تنفيذ أنماط أمنية مؤسسية
  • إعداد مراقبة شاملة
  • النشر إلى بيئة الإنتاج مع الحوكمة المناسبة

💡 نتيجة الفصل: نشر تطبيقات جاهزة للمؤسسات بقدرات إنتاجية كاملة


🎓 نظرة عامة على الورشة: تجربة تعلم عملية

⚠️ حالة الورشة: قيد التطوير
مواد الورشة قيد الإعداد والتحسين حاليًا. الوحدات الأساسية تعمل، لكن بعض الأقسام المتقدمة غير مكتملة. نحن نعمل بنشاط لإتمام جميع المحتويات. تتبع التقدّم →

مواد الورشة التفاعلية

تعلّم عملي شامل باستخدام أدوات متصفح وتمارين موجهة

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

🛠️ ميزات الورشة

  • واجهة قائمة على المتصفح: ورشة كاملة مدعومة بـ 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 - بيئة تعلم قائمة على المتصفح
  • 📋 تعليمات وحدة بوحدة:
  • 🛠️ مختبر ورشة الذكاء الاصطناعي: AI Workshop Lab - تمارين مركزة على الذكاء الاصطناعي
  • 💡 البدء السريع: Workshop Setup Guide - تكوين البيئة

مناسب لـ: التدريب المؤسسي، الدورات الجامعية، التعلم الذاتي، ومعسكرات تدريب المطورين.


📖 نظرة معمقة: قدرات AZD

بعيدًا عن الأساسيات، يقدّم AZD ميزات قوية لنشر الإنتاج:

  • نشرات قائمة على القوالب - استخدم قوالب مُعدة مسبقًا لأنماط التطبيقات الشائعة
  • البنية التحتية ككود - إدارة موارد Azure باستخدام Bicep أو Terraform
  • تدفقات عمل متكاملة - توفير ونشر ومراقبة التطبيقات بسلاسة
  • صديق للمطور - مُحسّن لزيادة إنتاجية وتجربة المطور

AZD + Microsoft Foundry: مثالي لنشر الذكاء الاصطناعي

لماذا AZD لحلول الذكاء الاصطناعي؟ يتناول AZD أهم التحديات التي يواجهها مطورو الذكاء الاصطناعي:

  • قوالب جاهزة للذكاء الاصطناعي - قوالب مُعدة مسبقًا لنماذج Microsoft Foundry وCognitive Services وأعباء عمل ML
  • نشرات ذكاء اصطناعي آمنة - أنماط أمان مدمجة لخدمات الذكاء الاصطناعي ومفاتيح API ونقاط نهاية النماذج
  • أنماط إنتاجية للذكاء الاصطناعي - أفضل الممارسات لنشر تطبيقات ذكاء اصطناعي قابلة للتوسع وموفِّرة للتكلفة
  • تدفقات عمل شاملة للذكاء الاصطناعي - من تطوير النموذج إلى النشر الإنتاجي مع المراقبة المناسبة
  • تحسين التكلفة - تخصيص موارد ذكي واستراتيجيات مقياس لأعباء عمل الذكاء الاصطناعي
  • تكامل Microsoft Foundry - اتصال سلس إلى كتالوج نماذج 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

أمثلة محلية - تطبيقات الحاويات (الفصول 2-5)

أمثلة شاملة لنشر الحاويات في هذا المستودع:

  • Container App Examples - دليل كامل لنشرات الحاويات
    • Simple Flask API - واجهة REST أساسية مع مقياس إلى الصفر
    • Microservices Architecture - نشر متعدد الخدمات جاهز للإنتاج
    • بدء سريع، إنتاج، وأنماط نشر متقدمة
    • إرشادات المراقبة والأمان وتحسين التكلفة

أمثلة خارجية - تطبيقات بسيطة (الفصلان 1-2)

استنسخ مستودعات عينات Azure هذه للبدء:

أمثلة خارجية - تكامل قواعد البيانات (الفصل 3-4)

أمثلة خارجية - أنماط متقدمة (الفصول 4-8)

مجموعات القوالب الخارجية


📚 الموارد والمراجع التعليمية

مراجع سريعة

ورش عمل تطبيقية

  • مختبر ورشة عمل الذكاء الاصطناعي - اجعل حلول الذكاء الاصطناعي قابلة للنشر عبر 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

📚 موارد استكشاف الأخطاء وإصلاحها الكاملة


🎓 إكمال الدورة والشهادات

تتبع التقدم

تتبع تقدمك التعليمي عبر كل فصل:

  • الفصل 1: الأساس والانطلاق السريع ✅
  • الفصل 2: تطوير يركز على الذكاء الاصطناعي ✅
  • الفصل 3: التكوين والمصادقة ✅
  • الفصل 4: البنية التحتية ككود والنشر ✅
  • الفصل 5: حلول الذكاء الاصطناعي متعددة الوكلاء ✅
  • الفصل 6: التحقق والتخطيط قبل النشر ✅
  • الفصل 7: استكشاف الأخطاء وإصلاحها وتصحيحها ✅
  • الفصل 8: أنماط الإنتاج والمؤسسات ✅

التحقق من التعلم

بعد إكمال كل فصل، تحقق من معرفتك عبر:

  1. التمرين العملي: أكمل نشر الفصل العملي
  2. فحص المعرفة: راجع قسم الأسئلة الشائعة للفصل
  3. مناقشة مجتمعية: شارك تجربتك في Azure Discord
  4. الفصل التالي: انتقل إلى مستوى التعقيد التالي

فوائد إتمام الدورة

بمجرد إكمال جميع الفصول، ستحصل على:

  • خبرة إنتاجية: نشر تطبيقات ذكاء اصطناعي حقيقية على Azure
  • مهارات مهنية: قدرات نشر جاهزة للمؤسسات
  • الاعتراف المجتمعي: عضو نشط في مجتمع مطوري Azure
  • التقدم الوظيفي: خبرات مطلوبة في نشر AZD والذكاء الاصطناعي

🤝 المجتمع والدعم

الحصول على المساعدة والدعم

رؤى المجتمع من Microsoft Foundry Discord

نتائج استطلاع الرأي الأخيرة من قناة #Azure:

  • 45% من المطورين يرغبون في استخدام AZD لأعباء عمل الذكاء الاصطناعي
  • أهم التحديات: نشر خدمات متعددة، إدارة بيانات الاعتماد، جاهزية الإنتاج
  • الأكثر طلبًا: قوالب مخصصة للذكاء الاصطناعي، أدلة استكشاف الأخطاء، أفضل الممارسات

انضم إلى مجتمعنا لـ:

  • شارك تجاربك مع AZD + الذكاء الاصطناعي واحصل على المساعدة
  • الوصول إلى عروض مبكرة للقوالب الجديدة للذكاء الاصطناعي
  • المساهمة في أفضل ممارسات نشر الذكاء الاصطناعي
  • التأثير على تطوير ميزات AI + AZD المستقبلية

المساهمة في الدورة

نرحب بالمساهمات! الرجاء قراءة دليل المساهمة للتفاصيل حول:

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

📄 معلومات الدورة

الترخيص

هذا المشروع مرخّص بموجب رخصة MIT - راجع ملف LICENSE للتفاصيل.

موارد تعليمية متعلقة من Microsoft

فريقنا ينتج دورات تعليمية شاملة أخرى:

LangChain

LangChain4j للمبتدئين LangChain.js للمبتدئين LangChain للمبتدئين

Azure / Edge / MCP / الوكلاء

AZD للمبتدئين Edge AI للمبتدئين MCP للمبتدئين وكلاء AI للمبتدئين


سلسلة الذكاء الاصطناعي التوليدي

الذكاء الاصطناعي التوليدي للمبتدئين الذكاء الاصطناعي التوليدي (.NET) الذكاء الاصطناعي التوليدي (Java) الذكاء الاصطناعي التوليدي (JavaScript)


التعلم الأساسي

تعلم الآلة للمبتدئين علوم البيانات للمبتدئين الذكاء الاصطناعي للمبتدئين الأمن السيبراني للمبتدئين تطوير الويب للمبتدئين إنترنت الأشياء للمبتدئين تطوير الواقع الممتد للمبتدئين


سلسلة Copilot

Copilot للبرمجة التشاركية بالذكاء الاصطناعي Copilot لـ C#/.NET مغامرة Copilot


🗺️ التنقل في الدورة

🚀 هل أنت مستعد للبدء بالتعلّم؟

المبتدئون: ابدأ بـ الفصل 1: الأساسيات والبداية السريعة
مطوروا الذكاء الاصطناعي: انتقل إلى الفصل 2: التطوير القائم على الذكاء الاصطناعي
المطورون ذوو الخبرة: ابدأ بـ الفصل 3: التهيئة والمصادقة

الخطوات التالية: ابدأ الفصل 1 - أساسيات AZD


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