Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
ترجیح میدهید بهصورت محلی کلون کنید؟
This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use sparse checkout:
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 فراتر از برنامهها و APIهای وب سنتی رشد کرده است. امروز، azd ابزار واحدی برای استقرار هر برنامهای در Azure است — از جمله برنامههای توانمند شده با هوش مصنوعی و عاملهای هوشمند.
این برای شما چه معنایی دارد:
- عاملهای هوش مصنوعی اکنون بهعنوان بارکاریهای درجهیک در azd پشتیبانی میشوند. میتوانید پروژههای عامل هوش مصنوعی را با همان جریان کاری
azd init→azd upکه قبلاً میشناسید، مقداردهی اولیه، استقرار و مدیریت کنید. - یکپارچهسازی Microsoft Foundry استقرار مدل، میزبانی عامل و پیکربندی سرویسهای AI را مستقیماً به اکوسیستم قالبهای azd میآورد.
- جریان کاری اصلی تغییر نکرده است. خواه در حال استقرار یک برنامه todo، یک میکروسرویس، یا یک راهکار چندعاملی AI باشید، دستورات یکسان هستند.
اگر قبلاً از azd استفاده کردهاید، پشتیبانی AI یک گسترش طبیعی است — نه یک ابزار جدا یا مسیر پیشرفته. اگر تازه شروع میکنید، یک جریان کاری خواهید آموخت که برای همه چیز کار میکند.
Azure Developer CLI (azd) یک ابزار خط فرمان مناسب توسعهدهنده است که استقرار برنامهها در Azure را ساده میکند. بهجای ایجاد و اتصال دستی دهها منبع Azure، میتوانید کل برنامهها را با یک دستور مستقر کنید.
# این فرمان واحد همه چیز را انجام میدهد:
# ✅ ایجاد همه منابع آزور
# ✅ پیکربندی شبکه و امنیت
# ✅ ساخت کد برنامه شما
# ✅ استقرار در آزور
# ✅ ارائه یک URL عملیاتی به شما
azd upهمین بود! نیازی به کلیک در Azure Portal نیست، نیازی به یادگیری قالبهای پیچیده ARM در ابتدا نیست، هیچ پیکربندی دستی لازم نیست — فقط برنامههای در حال کار روی Azure.
این متداولترین سؤالی است که مبتدیان میپرسند. این پاسخ ساده است:
| ویژگی | Azure CLI (az) |
Azure Developer CLI (azd) |
|---|---|---|
| هدف | مدیریت منابع منفرد Azure | استقرار برنامههای کامل |
| رویکرد | متمرکز بر زیرساخت | متمرکز بر برنامه |
| نمونه | az webapp create --name myapp... |
azd up |
| منحنی یادگیری | باید با سرویسهای Azure آشنا باشید | فقط برنامهتان را باید بدانید |
| مناسب برای | DevOps، زیرساخت | توسعهدهندگان، نمونهسازی |
- Azure CLI شبیه داشتن تمام ابزارهای لازم برای ساختن یک خانه است — چکش، اره، میخها. شما میتوانید هر چیزی بسازید، اما باید ساختوساز را بدانید.
- Azure Developer CLI شبیه استخدام یک پیمانکار است — شما آنچه میخواهید را توضیح میدهید و او ساختن را بر عهده میگیرد.
| سناریو | از این استفاده کنید |
|---|---|
| "میخواهم وباپ خود را سریع مستقر کنم" | azd up |
| "فقط نیاز دارم یک storage account ایجاد کنم" | az storage account create |
| "دارم یک برنامه کامل AI میسازم" | 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 Gallery | مرور بیش از 200 قالب و استقرار با یک کلیک |
| 🔗 Submit a Template | قالب خود را به جامعه ارسال کنید |
| 🔗 GitHub Repository | ستاره دهید و کد منبع را کاوش کنید |
# گفتگوی 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این دوره برای یادگیری تدریجی طراحی شده است — از جایی شروع کنید که با آن راحت هستید و بهتدریج پیش بروید:
| تجربه شما | از اینجا شروع کنید |
|---|---|
| کاملاً تازهوارد به Azure | فصل 1: بنیاد |
| با Azure آشنا، تازهکار با AZD | فصل 1: بنیاد |
| میخواهید اپلیکیشنهای AI را مستقر کنید | فصل 2: توسعه اول AI |
| میخواهید تمرین عملی داشته باشید | 🎓 کارگاه تعاملی - آزمایشگاه هدایتشده ۳-۴ ساعته |
| به الگوهای تولید نیاز دارید | فصل 8: تولید و الگوهای سازمانی |
- این مخزن را فورک کنید:
- آن را کلون کنید:
git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git - کمک بگیرید: جامعه Discord آژور
ترجیح میدهید بهصورت محلی کلون کنید؟
This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use sparse checkout:
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) مسلط شوید. تمرکز ویژه بر استقرار برنامههای AI با یکپارچهسازی Microsoft Foundry.
بر اساس دیدگاههای جامعه Discord مایکروسافت فاندری، 45% توسعهدهندگان میخواهند از AZD برای بارهای کاری AI استفاده کنند اما با چالشهایی مواجه میشوند از جمله:
- معماریهای پیچیده چندخدمتی برای AI
- بهترین شیوههای استقرار AI در تولید
- یکپارچهسازی و پیکربندی سرویسهای AI در Azure
- بهینهسازی هزینه برای بارهای کاری AI
- رفعاشکال مسائل مربوط به استقرارهای خاص AI
با تکمیل این دوره ساختاریافته، شما:
- تسلط بر مبانی AZD: مفاهیم پایه، نصب و پیکربندی
- استقرار برنامههای AI: استفاده از AZD با سرویسهای Microsoft Foundry
- پیادهسازی زیرساخت بهعنوان کد: مدیریت منابع Azure با قالبهای Bicep
- عیبیابی استقرارها: حل مشکلات رایج و دیباگ
- بهینهسازی برای تولید: امنیت، مقیاسپذیری، مانیتورینگ و مدیریت هزینه
- ساخت راهکارهای چندعاملی: استقرار معماریهای پیچیده AI
قبل از شروع فصل 1، مطمئن شوید موارد زیر مهیا هستند. مراحل نصب در ادامه این راهنما فرض میکنند این موارد پایه از قبل تأمین شدهاند.
- یک اشتراک Azure: میتوانید از یک اشتراک موجود از محل کار یا حساب شخصی خود استفاده کنید، یا یک نسخه آزمایشی رایگان ایجاد کنید تا شروع کنید.
- اجازه ایجاد منابع Azure: برای بیشتر تمرینها، باید حداقل دسترسی Contributor روی اشتراک یا گروه منابع هدف داشته باشید. بعضی فصلها ممکن است همچنین فرض کنند که میتوانید گروههای منابع، شناسههای مدیریتشده، و انتصابات RBAC ایجاد کنید.
- یک حساب GitHub: این برای فورک کردن مخزن، پیگیری تغییرات خود و استفاده از GitHub Codespaces برای کارگاه مفید است.
- پیشنیازهای زمان اجرای قالب: برخی قالبها نیاز به ابزارهای محلی مانند Node.js، Python، Java، یا Docker دارند. قبل از شروع، ابزار اعتبارسنج تنظیمات را اجرا کنید تا کمبود ابزارها را زود متوجه شوید.
- آشنایی پایه با ترمینال: لازم نیست متخصص باشید، اما باید با اجرای دستوراتی مانند
git clone,azd auth login, وazd upراحت باشید.
در حال کار در یک اشتراک سازمانی؟ اگر محیط Azure شما توسط یک مدیر مدیریت میشود، پیش از زمان تأیید کنید که میتوانید در اشتراک یا گروه منابعی که قصد استفاده از آن را دارید، منابع مستقر کنید. در غیر این صورت، قبل از شروع درخواست یک اشتراک سندباکس یا دسترسی Contributor کنید.
تازهکار با Azure؟ با نسخه آزمایشی Azure خود یا اشتراک pay-as-you-go در https://aka.ms/azurefreetrial شروع کنید تا بتوانید تمرینها را از ابتدا تا انتها بدون انتظار برای تأییدات سطح تننت انجام دهید.
هر فصل دارای README اختصاصی با اهداف آموزشی، شروع سریع، و تمرینها است:
| Chapter | Topic | Lessons | Duration | Complexity |
|---|---|---|---|---|
| فصل 1: بنیاد | شروع کار | مفاهیم پایه AZD | نصب | اولین پروژه | 30-45 دقیقه | ⭐ |
| فصل 2: توسعه هوش مصنوعی | برنامههای AI-اول | یکپارچگی Foundry | عوامل هوش مصنوعی | استقرار مدل | کارگاه | 1-2 ساعت | ⭐⭐ |
| فصل 3: پیکربندی | احراز هویت و امنیت | پیکربندی | احراز هویت و امنیت | 45-60 دقیقه | ⭐⭐ |
| فصل 4: زیرساخت | IaC و استقرار | راهنمای استقرار | تأمین منابع | 1-1.5 ساعت | ⭐⭐⭐ |
| فصل 5: چندعامل | راهحلهای عامل هوش مصنوعی | سناریوی خردهفروشی | الگوهای هماهنگی | 2-3 ساعت | ⭐⭐⭐⭐ |
| فصل 6: پیش از استقرار | برنامهریزی و اعتبارسنجی | بررسیهای پیشپرواز | برنامهریزی ظرفیت | انتخاب SKU | Application Insights | 1 ساعت | ⭐⭐ |
| فصل 7: رفع اشکال | دیباگ و رفع خطا | مسائل رایج | اشکالزدایی | مسائل AI | 1-1.5 ساعت | ⭐⭐ |
| فصل 8: تولید | الگوهای سازمانی | روشهای تولید | 2-3 ساعت | ⭐⭐⭐⭐ |
| 🎓 کارگاه | آزمایش عملی | مقدمه | انتخاب | اعتبارسنجی | بازشکافی | پیکربندی | سفارشیسازی | جمعآوری منابع | جمعبندی | 3-4 ساعت | ⭐⭐ |
مدت زمان کل دوره: ~10-14 ساعت | پیشرفت مهارت: مبتدی → آماده برای تولید
مسیر یادگیری خود را بر اساس سطح تجربه و اهداف انتخاب کنید
پیشنیازها: اشتراک Azure، دانش پایه خط فرمان
مدت زمان: 30-45 دقیقه
پیچیدگی: ⭐
- درک اصول خط فرمان توسعهدهنده Azure (AZD)
- نصب 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
- استقرار برنامههای مجهز به هوش مصنوعی
- درک تنظیمات سرویسهای AI
- 🎯 از اینجا شروع کنید: یکپارچگی Microsoft Foundry
- 🤖 عوامل AI: راهنمای عوامل AI - استقرار عوامل هوشمند با AZD
- 📖 الگوها: استقرار مدل AI - استقرار و مدیریت مدلهای AI
- 🛠️ کارگاه: آزمایشگاه کارگاه AI - آمادهسازی راهحلهای AI برای AZD
- 🎥 راهنمای تعاملی: مواد کارگاه - یادگیری مبتنی بر مرورگر با MkDocs * DevContainer Environment
- 📋 قالبها: قالبهای مایکروسافت فاندری برجسته
- 📝 مثالها: نمونههای استقرار AZD
# اولین برنامه هوش مصنوعی خود را مستقر کنید
azd init --template azure-search-openai-demo
azd up
# قالبهای اضافی هوش مصنوعی را امتحان کنید
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty💡 نتیجه فصل: استقرار و پیکربندی یک برنامه چت مجهز به AI با قابلیتهای RAG
✅ اعتبارسنجی موفقیت:
# بعد از فصل ۲، باید بتوانید:
azd init --template azure-search-openai-demo
azd up
# رابط چت هوش مصنوعی را آزمایش کنید
# سؤالات بپرسید و پاسخهای تولیدشده توسط هوش مصنوعی را همراه با منابع دریافت کنید
# بررسی کنید که ادغام جستجو کار میکند
azd monitor # بررسی کنید که Application Insights دادههای تلهمتری را نمایش میدهد
azd down --force --purge📊 زمان مورد نیاز: 1-2 ساعت
📈 سطح مهارت پس از: قادر به استقرار و پیکربندی برنامههای AI آماده تولید
💰 آگاهی از هزینه: درک هزینههای توسعه ~$80-150/ماه، هزینههای تولید ~$300-3500/ماه
محیط توسعه (تخمینی $80-150/ماه):
- مدلهای Microsoft Foundry (پرداخت به ازای مصرف): $0-50/ماه (بر اساس مصرف توکن)
- AI Search (رده پایه): $75/ماه
- Container Apps (مصرفی): $0-20/ماه
- Storage (استاندارد): $1-5/ماه
محیط تولید (تخمینی $300-3,500+/ماه):
- مدلهای Microsoft Foundry (PTU برای عملکرد ثابت): $3,000+/ماه یا پرداخت به ازای مصرف با حجم بالا
- AI Search (رده استاندارد): $250/ماه
- Container Apps (اختصاصی): $50-100/ماه
- Application Insights: $5-50/ماه
- Storage (پرمیوم): $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
- 📝 مثالها: مثال برنامه Container - استقرارهای کانتینری
- ایجاد قالبهای Bicep سفارشی
- استقرار برنامههای چندسرویسی
- پیادهسازی استراتژیهای استقرار blue-green
💡 نتیجه فصل: استقرار برنامههای پیچیده چندسرویسی با استفاده از قالبهای زیرساخت سفارشی
پیشنیازها: تکمیل فصلهای 1-2
مدت زمان: 2-3 ساعت
پیچیدگی: ⭐⭐⭐⭐
- الگوهای معماری چندعامل
- ارکستراسیون و هماهنگی عوامل
- استقرارهای AI آماده تولید
- 🤖 پروژه برجسته: راهحل چندعامل خردهفروشی - پیادهسازی کامل
- 🛠️ قالبهای ARM: بسته قالب ARM - استقرار با یک کلیک
- 📖 معماری: الگوهای هماهنگی چندعامل - الگوها
# استقرار کامل راهحل چندعاملی خردهفروشی
cd examples/retail-multiagent-arm-template
./deploy.sh
# بررسی پیکربندیهای عامل
az deployment group show --resource-group <rg-name> --name <deployment-name>💡 نتیجه فصل: استقرار و مدیریت یک راهحل چندعامل AI آماده تولید با عوامل مشتری و موجودی
پیشنیازها: تکمیل فصل 4
مدت زمان: 1 ساعت
پیچیدگی: ⭐⭐
- برنامهریزی ظرفیت و تایید منابع
- راهبردهای انتخاب SKU
- بررسیهای پیشاستقرار و خودکارسازی
- 📊 برنامهریزی: برنامهریزی ظرفیت - تایید منابع
- 💰 انتخاب: انتخاب SKU - انتخابهای مقرونبهصرفه
- ✅ اعتبارسنجی: بررسیهای پیشاستقرار - اسکریپتهای خودکار
- اسکریپتهای اعتبارسنجی ظرفیت را اجرا کنید
- انتخابهای SKU را برای کاهش هزینه بهینه کنید
- بررسیهای خودکار پیشاستقرار را پیادهسازی کنید
💡 نتیجه فصل: استقرارها را قبل از اجرا اعتبارسنجی و بهینهسازی کنید
پیشنیازها: تکمیل هر یک از فصلهای استقرار
مدت زمان: 1-1.5 ساعت
پیچیدگی: ⭐⭐
- رویکردهای سیستماتیک اشکالزدایی
- مسائل رایج و راهحلها
- عیبیابی مخصوص هوش مصنوعی
- 🔧 مسائل رایج: مسائل رایج - پرسشهای متداول و راهحلها
- 🕵️ دیباگ: راهنمای اشکالزدایی - راهبردهای گامبهگام
- 🤖 مسائل هوش مصنوعی: عیبیابی مخصوص هوش مصنوعی - مشکلات سرویسهای هوش مصنوعی
- تشخیص شکستهای استقرار
- رفع مشکلات احراز هویت
- رفع اشکال در اتصال سرویسهای هوش مصنوعی
💡 نتیجه فصل: تشخیص و حل مستقل مسائل رایج استقرار
پیشنیازها: تکمیل فصلهای 1 تا 4
مدت زمان: 2-3 ساعت
پیچیدگی: ⭐⭐⭐⭐
- راهبردهای استقرار در محیط تولید
- الگوهای امنیتی سازمانی
- نظارت و بهینهسازی هزینه
- 🏭 تولید: بهترین شیوههای AI برای تولید - الگوهای سازمانی
- 📝 نمونهها: مثال میکروسرویسها - معماریهای پیچیده
- 📊 نظارت: ادغام با Application Insights - نظارت
- پیادهسازی الگوهای امنیتی سازمانی
- راهاندازی نظارت جامع
- استقرار در محیط تولید با حاکمیت مناسب
💡 نتیجه فصل: استقرار برنامههای آماده سازمانی با قابلیتهای کامل تولید
⚠️ وضعیت کارگاه: در حال توسعه فعال
مواد کارگاه در حال حاضر در دست توسعه و پالایش هستند. ماژولهای اصلی عملیاتی هستند، اما برخی بخشهای پیشرفته کامل نشدهاند. ما بهطور فعال در حال تکمیل تمام محتوا هستیم. پیشرفت را دنبال کنید →
آموزش جامع دستاول با ابزارهای مبتنی بر مرورگر و تمرینهای هدایتشده
مواد کارگاه ما تجربهای ساختاریافته و تعاملی فراهم میکند که مکمل برنامه درسی مبتنی بر فصلهای بالا است. این کارگاه برای هر دو حالت یادگیری خودخوان و جلسات با هدایت مدرس طراحی شده است.
- رابط مبتنی بر مرورگر: کارگاه کامل مبتنی بر MkDocs با ویژگیهای جستجو، کپی و تم
- ادغام GitHub Codespaces: راهاندازی محیط توسعه با یک کلیک
- مسیر یادگیری ساختاریافته: تمرینهای هدایتشده در 8 ماژول (جمعاً 3-4 ساعت)
- روششناسی پیشرونده: مقدمه → انتخاب → اعتبارسنجی → تجزیه → پیکربندی → سفارشیسازی → پاکسازی → جمعبندی
- محیط DevContainer تعاملی: ابزارها و وابستگیهای پیشپیکربندیشده
The workshop follows an 8-module progressive methodology that takes you from discovery to deployment mastery:
| ماژول | موضوع | کارهایی که انجام خواهید داد | مدت زمان |
|---|---|---|---|
| 0. معرفی | مرور کارگاه | درک اهداف یادگیری، پیشنیازها، و ساختار کارگاه | 15 دقیقه |
| 1. انتخاب | کشف قالبها | کاوش قالبهای AZD و انتخاب قالب AI مناسب برای سناریوی شما | 20 دقیقه |
| 2. اعتبارسنجی | استقرار و بررسی | قالب را با azd up مستقر کرده و اعتبارسنجی کنید که زیرساخت کار میکند |
30 دقیقه |
| 3. تجزیه | درک ساختار | از GitHub Copilot برای کاوش معماری قالب، فایلهای Bicep، و سازماندهی کد استفاده کنید | 30 دقیقه |
| 4. پیکربندی | بررسی عمیق azure.yaml | بر پیکربندی azure.yaml، هوکهای چرخه عمر و متغیرهای محیطی تسلط پیدا کنید |
30 دقیقه |
| 5. سفارشیسازی | آن را متعلق به خود کنید | جستجوی AI، tracing، ارزیابی را فعال کرده و برای سناریوی خود سفارشی کنید | 45 دقیقه |
| 6. پاکسازی | پاکسازی | منابع را بهطور امن پاک کنید با azd down --purge |
15 دقیقه |
| 7. جمعبندی | مراحل بعدی | مرور دستاوردها، مفاهیم کلیدی، و ادامه مسیر یادگیری خود | 15 دقیقه |
Workshop Flow:
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
# گزینهٔ ۱: GitHub Codespaces (توصیهشده)
# در مخزن روی «Code» کلیک کنید → «Create codespace on main»
# گزینهٔ ۲: توسعهٔ محلی
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# دستورالعملهای راهاندازی در workshop/README.md را دنبال کنیدبا تکمیل کارگاه، شرکتکنندگان قادر خواهند بود:
- استقرار برنامههای AI تولیدی: از AZD با سرویسهای Microsoft Foundry استفاده کنید
- تسلط بر معماریهای چندعامله: پیادهسازی راهحلهای هماهنگشده عوامل هوش مصنوعی
- پیادهسازی بهترین شیوههای امنیتی: پیکربندی احراز هویت و کنترل دسترسی
- بهینهسازی برای مقیاس: طراحی استقرارهای مقرونبهصرفه و با عملکرد مناسب
- عیبیابی استقرارها: حل مستقل مسائل رایج
- 🎥 راهنمای تعاملی: مواد کارگاه - محیط یادگیری مبتنی بر مرورگر
- 📋 دستورالعملهای مرحلهبهمرحله ماژولها:
- 0. Introduction - مرور کارگاه و اهداف
- 1. Selection - پیدا کردن و انتخاب قالبهای AI
- 2. Validation - استقرار و بررسی قالبها
- 3. Deconstruction - کاوش معماری قالب
- 4. Configuration - تسلط بر azure.yaml
- 5. Customization - سفارشیسازی برای سناریوی شما
- 6. Teardown - پاکسازی منابع
- 7. Wrap-up - مرور و مراحل بعدی
- 🛠️ لابراتوار کارگاه AI: AI Workshop Lab - تمرینهای متمرکز بر AI
- 💡 شروع سریع: راهنمای راهاندازی کارگاه - پیکربندی محیط
مناسب برای: آموزش سازمانی، دورههای دانشگاهی، یادگیری خودخوان، و بوتکمپهای توسعهدهنده.
فراتر از مبانی، AZD امکانات قدرتمندی برای استقرار در محیط تولید فراهم میکند:
- استقرار مبتنی بر قالبها - استفاده از قالبهای از پیشساخته برای الگوهای رایج برنامه
- زیرساخت بهعنوان کد - مدیریت منابع Azure با استفاده از Bicep یا Terraform
- گردشهای کاری یکپارچه - تامین، استقرار، و نظارت بر برنامهها بهصورت یکپارچه
- دوستدار توسعهدهنده - بهینهشده برای بهرهوری و تجربه توسعهدهنده
چرا AZD برای راهحلهای AI؟ AZD به چالشهای اصلی توسعهدهندگان هوش مصنوعی پاسخ میدهد:
- قالبهای آماده AI - قالبهای پیشپیکربندیشده برای مدلهای Microsoft Foundry، Cognitive Services، و بارکاری ML
- استقرارهای ایمن AI - الگوهای امنیتی داخلی برای سرویسهای AI، کلیدهای API، و نقاط انتهایی مدل
- الگوهای AI برای تولید - بهترین شیوهها برای استقرارهای AI مقیاسپذیر و مقرونبهصرفه
- گردشهای کاری انتهابهانتها برای AI - از توسعه مدل تا استقرار تولید با نظارت مناسب
- بهینهسازی هزینه - تخصیص هوشمند منابع و راهبردهای مقیاسگذاری برای بارکاریهای AI
- ادغام با Microsoft Foundry - اتصال یکپارچه به کاتالوگ مدلها و نقاط انتهایی Microsoft Foundry
اگر در حال استقرار برنامههای AI هستید، از اینجا شروع کنید!
توجه: این قالبها الگوهای مختلف AI را نشان میدهند. برخی از آنها Azure Samples خارجی هستند، و برخی دیگر پیادهسازیهای محلی هستند.
| قالب | فصل | پیچیدگی | خدمات | نوع |
|---|---|---|---|---|
| شروع با چت AI | فصل 2 | ⭐⭐ | AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights | خارجی |
| شروع با عوامل AI | فصل 2 | ⭐⭐ | Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights | خارجی |
| دموی Azure Search + OpenAI | فصل 2 | ⭐⭐ | AzureOpenAI + Azure AI Search + App Service + Storage | خارجی |
| شروع سریع برنامه چت OpenAI | فصل 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 | محلی |
قالبهای آماده تولید که به فصلهای آموزشی نگاشت شدهاند
| قالب | فصل آموزشی | پیچیدگی | یادگیری کلیدی |
|---|---|---|---|
| openai-chat-app-quickstart | فصل 2 | ⭐ | الگوهای پایه استقرار AI |
| azure-search-openai-demo | فصل 2 | ⭐⭐ | پیادهسازی RAG با Azure AI Search |
| ai-document-processing | فصل 4 | ⭐⭐ | ادغام Document Intelligence |
| agent-openai-python-prompty | فصل 5 | ⭐⭐⭐ | چارچوب عامل و فراخوانی توابع |
| contoso-chat | فصل 8 | ⭐⭐⭐ | ارکستراسیون سازمانی AI |
| retail-multi-agent-solution | فصل 5 | ⭐⭐⭐⭐ | معماری چندعامل با عوامل مشتری و موجودی |
📌 مثالهای محلی در مقابل خارجی:
مثالهای محلی (در این مخزن) = آماده استفاده بلافاصله
مثالهای خارجی (Azure Samples) = کلون از مخازن لینکشده
- راهحل چندعامل خردهفروشی - پیادهسازی کامل آماده تولید با قالبهای ARM
- معماری چندعامل (عامل مشتری + عامل موجودی)
- نظارت و ارزیابی جامع
- استقرار با یک کلیک از طریق قالب ARM
مثالهای جامع استقرار کانتینر در این مخزن:
- نمونههای برنامه کانتینر - راهنمای کامل برای استقرارهای کانتینری
- API ساده Flask - API REST پایه با قابلیت scale-to-zero
- معماری میکروسرویسها - استقرار چندسرویسی آماده تولید
- شروع سریع، تولید، و الگوهای استقرار پیشرفته
- راهنمایی در زمینه نظارت، امنیت، و بهینهسازی هزینه
برای شروع، این مخازن Azure Samples را کلون کنید:
- وباپ ساده - Node.js + MongoDB - الگوهای استقرار پایه
- وبسایت استاتیک - React SPA - استقرار محتوای ایستا
- برنامه کانتینر - Python Flask - استقرار API REST
- اپلیکیشن پایگاهداده - C# + SQL - الگوهای اتصال به پایگاهداده
- Functions + Cosmos DB - گردشکار داده بدون سرور
- Java Microservices - معماریهای چندسرویسی
- Container Apps Jobs - پردازش پسزمینه
- Enterprise ML Pipeline - الگوهای ML آماده تولید
- Official AZD Template Gallery - مجموعه گزینششدهای از قالبهای رسمی و جامعه
- Azure Developer CLI Templates - مستندات قالبهای Microsoft Learn
- Examples Directory - مثالهای محلی برای یادگیری با توضیحات کامل
- Command Cheat Sheet - دستورات ضروری azd مرتبشده بر اساس فصل
- Glossary - اصطلاحات Azure و azd
- FAQ - سؤالهای متداول مرتبشده بر اساس فصل آموزشی
- Study Guide - تمرینهای جامع عملی
- AI Workshop Lab - تبدیل راهحلهای هوش مصنوعی شما به امکان استقرار با AZD (2-3 ساعت)
- Interactive Workshop - تمرینهای راهنمای ۸ ماژوله با MkDocs و GitHub Codespaces
- شامل: مقدمه → انتخاب → اعتبارسنجی → تفکیک → پیکربندی → سفارشیسازی → پاکسازی → جمعبندی
- Microsoft Azure Skills on skills.sh - 37 مهارت عامل متنباز برای Azure AI، Foundry، استقرار، عیبیابی، بهینهسازی هزینه و بیشتر. آنها را در GitHub Copilot، Cursor، Claude Code، یا هر عامل پشتیبانیشده نصب کنید:
npx skills add microsoft/github-copilot-for-azure
مشکلهای رایجی که مبتدیان با آن مواجه میشوند و راهحلهای سریع:
❌ "azd: command not found"
# ابتدا AZD را نصب کنید
# ویندوز (PowerShell):
winget install microsoft.azd
# مکاواس:
brew tap azure/azd && brew install azd
# لینوکس:
curl -fsSL https://aka.ms/install-azd.sh | bash
# نصب را بررسی کنید
azd version❌ "No subscription found" or "Subscription not set"
# لیست اشتراکهای موجود
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" or "Quota exceeded"
# یک منطقهٔ Azure متفاوت را امتحان کنید
azd env set AZURE_LOCATION "westus2"
azd up
# یا در محیط توسعه از SKUهای کوچکتر استفاده کنید
# فایل infra/main.parameters.json را ویرایش کنید:
{
"sku": "B1" // Instead of "P1V2"
}❌ "azd up" fails halfway through
# گزینه ۱: پاکسازی و تلاش مجدد
azd down --force --purge
azd up
# گزینه ۲: فقط زیرساخت را اصلاح کنید
azd provision
# گزینه ۳: وضعیت دقیق را بررسی کنید
azd show
# گزینه ۴: لاگها را در Azure Monitor بررسی کنید
azd monitor --logs❌ "Authentication failed" or "Token expired"
# برای AZD مجدداً احراز هویت کنید
azd auth logout
azd auth login
# اختیاری: اگر دستورات az را اجرا میکنید، Azure CLI را نیز بهروزرسانی کنید
az logout
az login
# احراز هویت را بررسی کنید
az account show❌ "Resource already exists" or naming conflicts
# AZD نامهای یکتا تولید میکند، اما در صورت تداخل:
azd down --force --purge
# سپس با یک محیط تازه دوباره تلاش کنید
azd env new dev-v2
azd up❌ Template deployment taking too long
زمانهای انتظار معمول:
- برنامه وب ساده: ۵-۱۰ دقیقه
- برنامه با پایگاهداده: ۱۰-۱۵ دقیقه
- برنامههای هوش مصنوعی: ۱۵-۲۵ دقیقه (تهیه منابع OpenAI کند است)
# پیشرفت را بررسی کنید
azd show
# اگر بیش از ۳۰ دقیقه گیر کردهاید، پرتال Azure را بررسی کنید:
azd monitor --overview
# به دنبال استقرارهای ناموفق بگردید❌ "Permission denied" or "Forbidden"
# نقش Azure خود را بررسی کنید
az role assignment list --assignee $(az account show --query user.name -o tsv)
# شما حداقل به نقش "Contributor" نیاز دارید
# از ادمین Azure خود بخواهید که اعطا کند:
# - Contributor (برای منابع)
# - User Access Administrator (برای تخصیص نقشها)❌ Can't find deployed application URL
# نمایش همه نقاط انتهایی سرویسها
azd show
# یا پورتال Azure را باز کنید
azd monitor
# سرویس خاص را بررسی کنید
azd env get-values
# به دنبال متغیرهای *_URL بگردید- راهنمای مشکلات متداول: راهحلهای دقیق
- مسائل خاص هوش مصنوعی: عیبیابی AI
- راهنمای اشکالزدایی: اشکالزدایی گامبهگام
- دریافت کمک: Azure Discord #azure-developer-cli
پیشرفت یادگیری خود را در هر فصل پیگیری کنید:
- فصل 1: مبانی و شروع سریع ✅
- فصل 2: توسعه با محوریت AI ✅
- فصل 3: پیکربندی و احراز هویت ✅
- فصل 4: زیرساخت بهعنوان کد و استقرار ✅
- فصل 5: راهحلهای چندعاملۀ AI ✅
- فصل 6: اعتبارسنجی و برنامهریزی پیش از استقرار ✅
- فصل 7: عیبیابی و اشکالزدایی ✅
- فصل 8: الگوهای تولیدی و سازمانی ✅
پس از اتمام هر فصل، دانش خود را با موارد زیر تأیید کنید:
- تمرین عملی: استقرار عملی فصل را کامل کنید
- بررسی دانش: بخش سؤالات متداول فصل خود را مرور کنید
- بحث جامعهای: تجربیات خود را در Azure Discord به اشتراک بگذارید
- فصل بعدی: به سطح بعدی پیچیدگی بروید
پس از اتمام همه فصلها، شما خواهید داشت:
- تجربه تولیدی: استقرار برنامههای واقعی هوش مصنوعی در Azure
- مهارتهای حرفهای: توانمندیهای استقرار آماده سازمانی
- شناختهشدن در جامعه: عضو فعال جامعه توسعهدهندگان Azure
- پیشرفت شغلی: تخصصهای پرتقاضا در استقرار AZD و AI
- مشکلات فنی: گزارش باگها و درخواست ویژگیها
- سؤالات یادگیری: Microsoft Azure Discord Community و
- کمکهای خاص AI: به
بپیوندید
- مستندات: مستندات رسمی Azure Developer CLI
نتایج نظرسنجی اخیر از کانال #Azure:
- 45% از توسعهدهندگان میخواهند از AZD برای بارهای کاری AI استفاده کنند
- چالشهای برتر: استقرارهای چندسرویسی، مدیریت اعتبارنامه، آمادگی برای تولید
- پُرجستجوترینها: قالبهای خاص AI، راهنماهای عیبیابی، بهترین شیوهها
به جامعه ما بپیوندید تا:
- تجربیات AZD + AI خود را به اشتراک بگذارید و کمک دریافت کنید
- به پیشنمایشهای اولیه قالبهای جدید AI دسترسی پیدا کنید
- در توسعه بهترین شیوههای استقرار AI مشارکت کنید
- در توسعه ویژگیهای آینده AI + AZD تأثیرگذار باشید
ما از مشارکت استقبال میکنیم! لطفاً راهنمای Contributing Guide را برای جزئیات بخوانید:
- بهبود محتوا: تقویت فصلها و مثالهای موجود
- مثالهای جدید: افزودن سناریوها و قالبهای دنیای واقعی
- ترجمه: کمک به نگهداری پشتیبانی چندزبانه
- گزارش باگ: افزایش دقت و شفافیت
- استانداردهای جامعه: پیروی از دستورالعملهای جامعه فراگیر ما
این پروژه تحت مجوز MIT منتشر شده است - برای جزئیات فایل LICENSE را ببینید.
تیم ما دورههای آموزشی جامعی دیگری نیز تولید میکند:
🚀 آیا آمادهاید شروع به یادگیری؟
مبتدیان: شروع کنید با فصل 1: پایه و شروع سریع
توسعهدهندگان هوش مصنوعی: برو به فصل 2: توسعه مبتنی بر هوش مصنوعی
توسعهدهندگان باتجربه: شروع کنید با فصل 3: پیکربندی و احراز هویت
گامهای بعدی: شروع فصل 1 - مبانی AZD →
Disclaimer: این سند با استفاده از سرویس ترجمهٔ مبتنی بر هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمههای خودکار ممکن است حاوی خطاها یا نادرستیهایی باشند. سند اصلی به زبان مبدأ باید بهعنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، ترجمهٔ حرفهای انسانی توصیه میشود. ما در قبال هرگونه سوءتفاهم یا برداشت نادرست ناشی از استفاده از این ترجمه مسئولیتی نداریم.
