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
Unapendelea Kukopa Kwenye Kompyuta Yako?
Hifadhidata hii inajumuisha tafsiri katika lugha 50+ ambazo zinaongeza kiasi cha kupakua. Ili kukopa bila tafsiri, tumia 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"Hii inakupa kila kitu unachohitaji kukamilisha kozi na upakuaji wa kasi zaidi.
Azure Developer CLI imekua zaidi ya programu za wavuti na API za jadi. Leo, azd ni zana moja kwa kupeleka programu yoyote kwenye Azure—ikiwa ni pamoja na programu zinazodhibitiwa na AI na maajenti wenye akili.
Hii inamaanisha nini kwako:
- Maajenti ya AI sasa ni mizigo ya azd za daraja la juu. Unaweza kuanzisha, kupeleka, na kusimamia miradi ya maajenti ya AI kwa kutumia mtiririko uleule wa
azd init→azd upunaoujuwa. - Uunganishaji wa Microsoft Foundry unaleta utekelezaji wa modeli, kuweka maajenti, na usanidi wa huduma za AI moja kwa moja ndani ya mfumo wa templates wa azd.
- Mtiririko wa msingi haujabadilika. Iwe unapeleka programu ya todo, microservice, au suluhisho la AI lenye maajenti wengi, amri zinaendelea kuwa zile zile.
Ikiwa umewahi kutumia azd hapo awali, msaada wa AI ni nyongeza ya asili—si zana tofauti au njia ya juu. Ikiwa unaanza upya, utajifunza mtiririko mmoja unaofaa kwa kila kitu.
Azure Developer CLI (azd) ni zana rafiki kwa waendelezaji ya mstari wa amri inayofanya iwe rahisi kupeleka programu kwenye Azure. Badala ya kuunda na kuunganisha kwa mikono mabilioni ya rasilimali za Azure, unaweza kupeleka programu nzima kwa amri moja tu.
# Amri hii moja hufanya kila kitu:
# ✅ Inaunda rasilimali zote za Azure
# ✅ Inapanga mitandao na usalama
# ✅ Inajenga msimbo wa programu yako
# ✅ Inaweka kwenye Azure
# ✅ Inakupa URL inayofanya kazi
azd upHiyo ni yote! Hakuna kubofya katika Azure Portal, hakuna templates ngumu za ARM za kujifunza kwanza, hakuna usanidi wa mikono - ni programu zinazofanya kazi kwenye Azure.
Hii ndiyo swali linaloulizwa mara nyingi na waanzilishi. Hapa kuna jibu rahisi:
| Sifa | Azure CLI (az) |
Azure Developer CLI (azd) |
|---|---|---|
| Madhumuni | Dhibiti rasilimali za Azure binafsi | Tekeleza programu kamili |
| Mtazamo | Inazingatia miundombinu | Inazingatia programu |
| Mfano | az webapp create --name myapp... |
azd up |
| Ugumu wa Kujifunza | Inahitaji kujua huduma za Azure | Fahamu tu programu yako |
| Inafaa Kwa | DevOps, Miundombinu | Waendelezaji, Utengenezaji Mifano |
- Azure CLI ni kama kuwa na zana zote za kujenga nyumba - nyundo, kisu, mabati. Unaweza kujenga chochote, lakini unahitaji uzoefu wa ujenzi.
- Azure Developer CLI ni kama kuajiri mkandarasi - unaeleza unachotaka, na wao wanashughulikia ujenzi.
| Hali | Tumia Hili |
|---|---|
| "Nataka kupeleka app yangu ya wavuti haraka" | azd up |
| "Nahitaji kuunda akaunti ya hifadhi tu" | az storage account create |
| "Ninaunda programu kamili ya AI" | azd init --template azure-search-openai-demo |
| "Nahitaji kutatua tatizo kwa rasilimali maalum ya Azure" | az resource show |
| "Nataka utekelezaji wa uzalishaji kwa dakika" | azd up --environment production |
AZD inatumia Azure CLI chini ya uso. Unaweza kutumia zote mbili:
# Weka programu yako kwa AZD
azd up
# Kisha rekebisha rasilimali maalum kwa Azure CLI
az webapp config set --name myapp --always-on trueUsianze kutoka mwanzo! Awesome AZD ni mkusanyiko wa jamii wa templates tayari-kupelekwa:
| Rasilimali | Maelezo |
|---|---|
| 🔗 Galleria ya Awesome AZD | Tafuta templates 200+ na kuzipeleka kwa bonyeza moja |
| 🔗 Wasilisha Template | Changia template yako kwa jamii |
| 🔗 Hifadhi ya GitHub | Weka nyota na chunguza chanzo |
# Maongezi ya RAG na Models za Microsoft Foundry + Utafutaji wa AI
azd init --template azure-search-openai-demo
# Programu ya Haraka ya Maongezi ya AI
azd init --template openai-chat-app-quickstart
# Wakala wa AI na Wakala wa Foundry
azd init --template get-started-with-ai-agentsKabla ya kuanza, hakikisha mashine yako iko tayari kwa template unayotaka kupeleka:
Windows:
.\validate-setup.ps1macOS / Linux:
bash ./validate-setup.shIkiwa ukaguzi wa lazima ukishindwa, rekebisha hapo kwanza kisha endelea na mwanzo wa haraka.
Windows:
winget install microsoft.azdmacOS:
brew tap azure/azd && brew install azdLinux:
curl -fsSL https://aka.ms/install-azd.sh | bash# Hiari ikiwa unapanga kutumia amri za Azure CLI moja kwa moja katika kozi hii
az login
# Inahitajika kwa ajili ya mifumo ya AZD
azd auth loginIkiwa haujasikia ni ipi unayohitaji, fuata mtiririko kamili wa usanidi katika Installation & Setup.
# Anzisha kutoka kwa kiolezo
azd init --template todo-nodejs-mongo
# Sambaza kwenda Azure (huunda kila kitu!)
azd up🎉 Hiyo ni yote! Programu yako sasa imewekwa mtandaoni kwenye Azure.
# Remove all resources when done experimenting
azd down --force --purgeKozi hii imeundwa kwa ajili ya kujifunza hatua kwa hatua - anza pale unapoeleweka na endelea kupanda:
| Uzoefu Wako | Anza Hapa |
|---|---|
| Mpya kabisa kwa Azure | Sura 1: Msingi |
| Unajua Azure, Mpya kwa AZD | Sura 1: Msingi |
| Unataka kupeleka programu za AI | Sura 2: Maendeleo-Kwanza ya AI |
| Unataka mazoezi ya vitendo | 🎓 Warsha ya Kazi ya Vitendo - maabara ya mwongozo wa masaa 3-4 |
| Unahitaji mifano ya uzalishaji | Sura 8: Uzalishaji & Mifumo ya Kampuni |
- Fanya Fork ya Hifadhi Hii:
- Nakili (Clone) Hii:
git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git - Pata Msaada: Azure Discord Community
Unapendelea Kukopa Kwenye Kompyuta Yako?
Hifadhidata hii inajumuisha tafsiri katika lugha 50+ ambazo zinaongeza kiasi cha kupakua. Ili kukopa bila tafsiri, tumia 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'Hii inakupa kila kitu unachohitaji kukamilisha kozi kwa upakuaji wa kasi zaidi.
Jifunze Azure Developer CLI (azd) kupitia sura zilizo pangwa kwa ajili ya kujifunza hatua kwa hatua. Mzozo maalum katika utekelezaji wa programu za AI kwa ushirikiano na Microsoft Foundry.
Kulingana na maoni ya jumuiya ya Microsoft Foundry Discord, 45% ya waendelezaji wanataka kutumia AZD kwa mzigo wa AI lakini wanakutana na changamoto za:
- Miundo tata ya huduma nyingi za AI
- Mifumo bora ya utekelezaji wa AI kwa uzalishaji
- Uunganishaji na usanidi wa huduma za Azure AI
- Uboreshaji wa gharama kwa huduma za AI
- Kutatua matatizo mahsusi ya utekelezaji wa AI
Kwa kukamilisha kozi hii iliyopangwa, utakuwa na uwezo wa:
- Kumfahamu AZD kwa Undani: Dhana za msingi, usakinishaji, na usanidi
- Kupeleka Programu za AI: Tumia AZD na huduma za Microsoft Foundry
- Kutumia Infrastructure as Code: Simamia rasilimali za Azure kwa templates za Bicep
- Kutatua Matatizo ya Utekelezaji: Rekebisha matatizo ya kawaida na debug
- Kuboresha kwa Uzalishaji: Usalama, upanuaji, ufuatiliaji, na usimamizi wa gharama
- Kujenga Suluhisho za Maajenti Wengi: Tekeleza miundo tata ya AI
Kabla ya kuanza Sura ya 1, hakikisha una yafuatayo mahali. Hatua za usakinishaji zilizo baadaye katika mwongozo huu zinadhani kuwa mambo haya ya msingi yameshatatuliwa.
- Usajili wa Azure: Unaweza kutumia usajili uliopo kutoka kazini au akaunti yako mwenyewe, au tengeneza jaribio la bure ili kuanza.
- Ruhusa ya kuunda rasilimali za Azure: Kwa mazoezi mengi, unapaswa kuwa na angalau Contributor access kwenye usajili unalolenga au kikundi cha rasilimali. Sura baadhi zinaweza pia kutegemea kwamba unaweza kuunda makundi ya rasilimali, vitambulisho vinavyosimamiwa, na uteuzi za RBAC.
- Akaunti ya GitHub: Hii inafaa kwa kuforka hazina ya msimbo (repository), kufuatilia mabadiliko yako mwenyewe, na kutumia GitHub Codespaces kwa warsha.
- Mahitaji ya wakati wa utekelezaji ya templeti: Templati zingine zinahitaji zana za ndani kama Node.js, Python, Java, au Docker. Endesha validator ya usanidi kabla ya kuanza ili ugundue zana zilizoikosekana mapema.
- Ujuzi wa msingi wa terminali: Hauhitaji kuwa mtaalamu, lakini unapaswa kuwa na uwezo wa kutekeleza amri kama
git clone,azd auth login, naazd up.
Unafanya kazi kwenye usajili wa shirika? Iwapo mazingira yako ya Azure yanadhibitiwa na msimamizi, thibitisha mapema kuwa unaweza kutengeneza rasilimali katika usajili au kikundi cha rasilimali unachopanga kutumia. Ikiwa sivyo, omba usajili wa sandbox au ufikiaji wa Contributor kabla ya kuanza.
Mpya kwa Azure? Anza na jaribio lako la Azure au usajili wa pay-as-you-go kupitia https://aka.ms/azurefreetrial ili uweze kumaliza mazoezi kutoka mwanzo hadi mwisho bila kusubiri idhini za ngazi ya mpangaji.
Kila sura ina README ya kujitolea yenye malengo ya kujifunza, anza za haraka, na mazoezi:
Jumla ya Muda wa Kozi: ~10-14 masaa | Maendeleo ya Ujuzi: Mwanzo → Production-Ready
Chagua njia yako ya kujifunza kulingana na kiwango chako cha uzoefu na malengo
Mahitaji ya awali: Usajili wa Azure, ujuzi wa msingi wa mstari wa amri
Muda: 30-45 dakika
Ugumu: ⭐
- Kuelewa misingi ya Azure Developer CLI
- Kusakinisha AZD kwenye jukwaa lako
- Utekelezaji wako wa kwanza uliofanikiwa
- 🎯 Anza Hapa: Azure Developer CLI ni Nini?
- 📖 Nadharia: Misingi ya AZD - Dhana kuu na istilahi
- ⚙️ Usanidi: Usakinishaji & Usanidi - Miongozo maalum kwa jukwaa
- 🛠️ Vitendo: Mradi Wako wa Kwanza - Mafunzo hatua kwa hatua
- 📋 Marejeleo ya Haraka: Muhtasari wa Amri
# Ukaguzi wa haraka wa usanikishaji
azd version
# Weka programu yako ya kwanza
azd init --template todo-nodejs-mongo
azd up💡 Matokeo ya Sura: Kuweka kwa mafanikio programu rahisi ya wavuti kwenye Azure ukitumia AZD
✅ Uthibitisho wa Mafanikio:
# Baada ya kumaliza Sura ya 1, unapaswa kuwa na uwezo wa:
azd version # Inaonyesha toleo lililowekwa
azd init --template todo-nodejs-mongo # Inaanzisha mradi
azd up # Inaweka kwenye Azure
azd show # Inaonyesha URL ya programu inayokimbia
# Programu inafunguka kwenye kivinjari na inafanya kazi
azd down --force --purge # Inasafisha rasilimali📊 Muda wa Kuchukua: 30-45 dakika
📈 Kiwango cha Ujuzi Baada: Unaweza kuweka programu za msingi kwa kujitegemea
📈 Kiwango cha Ujuzi Baada: Unaweza kuweka programu za msingi kwa kujitegemea
Mahitaji ya awali: Sura 1 imekamilika
Muda: 1-2 saa
Ugumu: ⭐⭐
- Uunganishaji wa Microsoft Foundry na AZD
- Kuweka programu zilizoongozwa na AI
- Kuelewa usanidi wa huduma za AI
- 🎯 Anza Hapa: Uunganishaji wa Microsoft Foundry
- 🤖 Wakala za AI: Mwongozo wa Wakala za AI - Weka wakala wenye akili kwa kutumia AZD
- 📖 Mifano: Utekelezaji wa Mfano wa AI - Weka na simamia mifano ya AI
- 🛠️ Warsha: Maabara ya Warsha ya AI - Fanya suluhisho zako za AI ziwe tayari kwa AZD
- 🎥 Mwongozo wa Kuingiliana: Nyenzo za Warsha - Kujifunza katika kivinjari kwa MkDocs * Mazingira ya DevContainer
- 📋 Violezo: Violezo vya Microsoft Foundry
- 📝 Mifano: Mifano ya Utekelezaji wa AZD
# Weka programu yako ya kwanza ya AI
azd init --template azure-search-openai-demo
azd up
# Jaribu templeti za ziada za AI
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty💡 Matokeo ya Sura: Weka na sanidi programu ya gumzo inayoendeshwa na AI yenye uwezo wa RAG
✅ Uthibitisho wa Mafanikio:
# Baada ya Sura ya 2, unapaswa kuwa na uwezo wa:
azd init --template azure-search-openai-demo
azd up
# Kujaribu kiolesura cha mazungumzo cha AI
# Uliza maswali na upate majibu ya AI yenye vyanzo
# Thibitisha kuwa ujumuishaji wa utafutaji unafanya kazi
azd monitor # Angalia Application Insights inaonyesha telemetri
azd down --force --purge📊 Muda wa Kuchukua: 1-2 saa
📈 Kiwango cha Ujuzi Baada: Unaweza kuweka na kusanidi programu za AI zilizotayarishwa kwa uzalishaji
💰 Uelewa wa Gharama: Elewa gharama za maendeleo $80-150/kwa mwezi, gharama za uzalishaji $300-3500/kwa mwezi
Mazingira ya Maendeleo (Makadirio $80-150/kwa mwezi):
- Mifano ya Microsoft Foundry (Pay-as-you-go): $0-50/kwa mwezi (kutegemea matumizi ya tokeni)
- AI Search (ngazi ya Msingi): $75/kwa mwezi
- Container Apps (Matumizi): $0-20/kwa mwezi
- Uhifadhi (Standard): $1-5/kwa mwezi
Mazingira ya Uzalishaji (Makadirio $300-3,500+/kwa mwezi):
- Mifano ya Microsoft Foundry (PTU kwa utendaji thabiti): $3,000+/kwa mwezi AU Pay-as-you-go kwa kiasi kikubwa
- AI Search (ngazi ya Standard): $250/kwa mwezi
- Container Apps (Zilizotengwa): $50-100/kwa mwezi
- Application Insights: $5-50/kwa mwezi
- Uhifadhi (Premium): $10-50/kwa mwezi
💡 Vidokezo vya Kupunguza Gharama:
- Tumia Free Tier ya Mifano ya Microsoft Foundry kwa kujifunza (Azure OpenAI 50,000 tokens/kwa mwezi zimejumuishwa)
- Endesha
azd downkuwachilia rasilimali wakati hauendelei kikazi - Anza na bili inayotegemea matumizi, angalia PTU tu kwa uzalishaji
- Tumia
azd provision --previewkukadiria gharama kabla ya utekelezaji - Washa auto-scaling: lipa tu kwa matumizi halisi
Ufuatiliaji wa Gharama:
# Angalia makadirio ya gharama za kila mwezi
azd provision --preview
# Fuatilia gharama halisi katika Portal ya Azure
az consumption budget list --resource-group <your-rg>Mahitaji ya awali: Sura 1 imekamilika
Muda: 45-60 dakika
Ugumu: ⭐⭐
- Usanidi na usimamizi wa mazingira
- Mazoezi bora ya uthibitishaji na usalama
- Uainishaji wa majina ya rasilimali na muundo
- 📖 Mipangilio: Mwongozo wa Mipangilio - Usanidi wa mazingira
- 🔐 Usalama: Mifumo ya uthibitishaji na vitambulisho vinavyosimamiwa - Mifumo ya uthibitishaji
- 📝 Mifano: Mfano wa Programu ya Hifadhidata - Mifano ya Hifadhidata za AZD
- Sanidi mazingira mengi (dev, staging, prod)
- Weka uthibitishaji wa vitambulisho vinavyosimamiwa
- Tekeleza usanidi maalum kwa mazingira
💡 Matokeo ya Sura: Simamia mazingira mengi kwa uthibitishaji na usalama sahihi
Mahitaji ya awali: Sura 1-3 zimekamilika
Muda: 1-1.5 saa
Ugumu: ⭐⭐⭐
- Mifano ya juu ya utekelezaji
- Miundombinu kama Msimbo kwa Bicep
- Mikakati ya utayarishaji wa rasilimali
- 📖 Utekelezaji: Mwongozo wa Utekelezaji - Mchakato kamili
- 🏗️ Utayarishaji: Utayarishaji wa Rasilimali - Usimamizi wa rasilimali za Azure
- 📝 Mifano: Mfano wa Programu ya Container - Utekelezaji wa yaliyofungashwa kwenye container
- Unda violezo vya Bicep vilivyobinafsishwa
- Weka programu zenye huduma nyingi
- Tekeleza mikakati ya utekelezaji ya blue-green
💡 Matokeo ya Sura: Weka programu zinazoingiza huduma nyingi zenye ugumu kwa kutumia violezo maalum vya miundombinu
Mahitaji ya awali: Sura 1-2 zimekamilika
Muda: 2-3 saa
Ugumu: ⭐⭐⭐⭐
- Mifano ya usanifu wa wakala wengi
- Uratibu na uendeshaji wa wakala
- Utekelezaji wa AI tayari kwa uzalishaji
- 🤖 Mradi Ulioangaziwa: Suluhisho la Wakala Wengi kwa Rejareja - Utekelezaji kamili
- 🛠️ Violezo za ARM: Kifurushi cha Violezo vya ARM - Utekelezaji kwa bonyeza moja
- 📖 Usanifu: Mifano ya uratibu wa wakala wengi - Mifano
# Sambaza suluhisho kamili la rejareja lenye mawakala wengi
cd examples/retail-multiagent-arm-template
./deploy.sh
# Chunguza usanidi wa mawakala
az deployment group show --resource-group <rg-name> --name <deployment-name>💡 Matokeo ya Sura: Weka na simamia suluhisho la AI la wakala wengi tayari kwa uzalishaji lenye wakala wa Mteja na wa Hesabu
Mahitaji ya awali: Sura 4 imekamilika
Muda: 1 saa
Ugumu: ⭐⭐
- Upangaji wa uwezo na uhakikisho wa rasilimali
- Mikakati ya kuchagua SKU
- Ukaguzi kabla ya uzinduzi na uendeshaji wa kiotomatiki
- 📊 Upangaji: Capacity Planning - Uhakikisho wa rasilimali
- 💰 Uchaguzi: SKU Selection - Chaguo za gharama nafuu
- ✅ Uhakikisho: Pre-flight Checks - Skripti za kiotomatiki
- Endesha skripti za uhakikisho wa uwezo
- Boresha uchaguzi wa SKU kwa gharama
- Tekeleza ukaguzi wa kiotomatiki kabla ya uzinduzi
💡 Matokeo ya Sura: Thibitisha na boresha uanzishaji kabla ya utekelezaji
Masharti ya Awali: Sura yoyote ya uanzishaji imekamilika
Muda: 1–1.5 saa
Ugumu: ⭐⭐
- Mbinu za kimfumo za urekebishaji makosa
- Matatizo ya kawaida na suluhisho
- Utatuzi wa matatizo maalum kwa AI
- 🔧 Matatizo ya Kawaida: Common Issues - Maswali yanayoulizwa mara kwa mara na suluhisho
- 🕵️ Urekebishaji: Debugging Guide - Mikakati hatua kwa hatua
- 🤖 Matatizo ya AI: AI-Specific Troubleshooting - Matatizo ya huduma za AI
- Gunduza kushindwa kwa uanzishaji
- Rekebisha matatizo ya uthibitisho
- Fanya urekebishaji wa uunganisho wa huduma za AI
💡 Matokeo ya Sura: Gunduza na suluhisha kwa kujitegemea matatizo ya kawaida ya uanzishaji
Masharti ya Awali: Suras 1-4 zimekamilika
Muda: 2–3 saa
Ugumu: ⭐⭐⭐⭐
- Mikakati ya uanzishaji wa uzalishaji
- Mifumo ya usalama ya biashara
- Ufuatiliaji na uboreshaji wa gharama
- 🏭 Uzalishaji: Production AI Best Practices - Mifumo ya biashara
- 📝 Mifano: Microservices Example - Miundo tata
- 📊 Ufuatiliaji: Application Insights integration - Uunganishaji wa Application Insights
- Tekeleza mifumo ya usalama ya biashara
- Sanidi ufuatiliaji kamili
- Tekeleza uanzishaji kwenye uzalishaji kwa utawala muafaka
💡 Matokeo ya Sura: Anzisha programu zilizo tayari kwa biashara zenye uwezo kamili wa uzalishaji
⚠️ HALI YA WARSHA: Inapoendelea Kuendelezwa
Vifaa vya warsha kwa sasa vinatengenezwa na kurekebishwa. Moduli za msingi zinafanya kazi, lakini baadhi ya sehemu za juu hazijakamilika. Tunafanya kazi kwa bidii kukamilisha maudhui yote. Fuata maendeleo →
Ujifunzaji wa vitendo wa kina kwa kutumia zana za kivinjari na mazoezi yaliyoongozwa
Vifaa vya warsha vinatoa uzoefu uliopangwa, unaoshirikisha vitendo unaoendana na mtaala uliotajwa hapo juu. Warsha imeundwa kwa ajili ya kujifunza kwa mwendo binafsi na pia kwa kipindi kinachoongozwa na mkufunzi.
- Kiolesura cha Kivinjari: Warsha kamili inayotumia MkDocs yenye utafutaji, kunakili, na vipengele vya mandhari
- Uunganisho wa GitHub Codespaces: Usanidi wa mazingira ya maendeleo kwa bonyeza moja
- Njia ya Kujifunza Iliyopangwa: Mazoezi ya moduli 8 yaliyoongozwa (saa 3–4 jumla)
- Mbinu Inayoendelea: Utangulizi → Uchaguzi → Uthibitisho → Uvunjaji → Usanidi → Urekebishaji → Uondoaji → Hitimisho
- Mazingira ya DevContainer yenye mwingiliano: Zana na utegemezi zilizosanifiwa awali
Warsha inafuata mbinu ya moduli 8 inayoendelea inayokuchukua kutoka kugundua hadi utaalamu wa uanzishaji:
| Moduli | Mada | Utalofanya | Muda |
|---|---|---|---|
| 0. Utangulizi | Muhtasari wa Warsha | Elewa malengo ya kujifunza, masharti ya awali, na muundo wa warsha | 15 min |
| 1. Uchaguzi | Ugunduzi wa Kiolezo | Chunguza kiolezo za AZD na chagua kiolezo sahihi cha AI kwa senario yako | 20 min |
| 2. Uthibitisho | Tuma & Thibitisha | Tuma kiolezo kwa azd up na thibitisha miundombinu inafanya kazi |
30 min |
| 3. Uvunjaji | Elewa Muundo | Tumia GitHub Copilot kuchunguza usanifu wa kiolezo, mafaili ya Bicep, na mpangilio wa msimbo | 30 min |
| 4. Usanidi | Uchunguzi wa kina wa azure.yaml | Tawala usanidi wa azure.yaml, lifecycle hooks, na vigezo vya mazingira |
30 min |
| 5. Urekebishaji | Ifanye Iwe Yako | Wezesha AI Search, ufuatiliaji, tathmini, na rekebisha kwa senario yako | 45 min |
| 6. Ufutaji | Safisha | Ondoa rasilimali kwa usalama kwa kutumia azd down --purge |
15 min |
| 7. Hitimisho | Hatua Zifuatazo | Pitia mafanikio, dhana kuu, na endelea safari yako ya kujifunza | 15 min |
Mtiririko wa Warsha:
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
# Chaguo 1: GitHub Codespaces (Inapendekezwa)
# Bonyeza "Code" → "Unda codespace kwenye tawi la main" katika hazina
# Chaguo 2: Uendelezaji wa ndani
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Fuata maelekezo ya usanidi katika workshop/README.mdKwa kukamilisha warsha, washiriki wata:
- Weka Programu za AI za Uzalishaji: Tumia AZD na huduma za Microsoft Foundry
- Tawala Miundo ya Mawakala Wengi: Tekeleza suluhisho za mawakala za AI zilizoratibiwa
- Tekeleza Mbinu Bora za Usalama: Sanidi uthibitishaji na udhibiti wa upatikanaji
- Boresha Kwa Upanuaji: Buni uanzishaji wa gharama nafuu na wenye utendaji mzuri
- Tatua Matatizo ya Uanzishaji: Suluhisha matatizo ya kawaida kwa kujitegemea
- 🎥 Mwongozo wa Mtandaoni: Workshop Materials - Mazingira ya kujifunzia yanayotumia kivinjari
- 📋 Maelekezo Kwa Moduli:
- 0. Utangulizi - Muhtasari wa warsha na malengo
- 1. Uchaguzi - Pata na chagua templeti za AI
- 2. Uthibitisho - Tuma na thibitisha kiolezo
- 3. Uvunjaji - Chunguza usanifu wa kiolezo
- 4. Usanidi - Tawala azure.yaml
- 5. Urekebishaji - Rekebisha kwa senario yako
- 6. Ufutaji - Safisha rasilimali
- 7. Hitimisho - Pitia na hatua zinazofuata
- 🛠️ Maabara ya Warsha ya AI: AI Workshop Lab - Mazoezi yanayolenga AI
- 💡 Anza Haraka: Workshop Setup Guide - Usanidi wa mazingira
Inafaa kwa: Mafunzo ya kampuni, kozi za chuo, kujifunza kwa mwendo wako, na bootcamps za watengenezaji.
Zaidi ya msingi, AZD inatoa vipengele vyenye nguvu kwa uanzishaji wa uzalishaji:
- Uanzishaji unaotegemea templeti - Tumia templeti zilizojengwa kabla kwa mifumo ya kawaida ya programu
- Miundombinu kama Msimbo - Dhibiti rasilimali za Azure kwa kutumia Bicep au Terraform
- Mtiririko uliounganishwa - Sambamba panga, anzisha, na fuatilia programu kwa urahisi
- Rafiki kwa Msanidi Programu - Imeboreshwa kwa uzalishaji na uzoefu wa msanidi programu
Kwa Nini AZD kwa Suluhisho za AI? AZD inashughulikia changamoto kuu zinazowakabili wasanidi programu wa AI:
- Templeti Tayari kwa AI - Templeti zilizosanifiwa awali kwa Microsoft Foundry Models, Cognitive Services, na mzigo wa kazi wa ML
- Uanzishaji Salama wa AI - Mifumo ya usalama iliyojengewa ndani kwa huduma za AI, funguo za API, na miisho ya modeli
- Mifumo ya AI kwa Uzalishaji - Mbinu bora kwa uanzishaji wa programu za AI zinazoenea na zenye gharama nafuu
- Mtiririko wa AI Kuanzia Mwangoni Hadi Mwisho - Kutoka kwenye maendeleo ya modeli hadi uanzishaji wa uzalishaji kwa ufuatiliaji sahihi
- Uboreshaji wa Gharama - Ugawaji wa rasilimali kwa busara na mikakati ya upanuaji kwa mzigo wa AI
- Uunganisho wa Microsoft Foundry - Muunganisho bila mshono na katalogi ya modeli ya Microsoft Foundry na miisho yake
Anza hapa ukiaanzisha programu za AI!
Kumbuka: Templeti hizi zinaonyesha mifumo mbalimbali ya AI. Baadhi ni Sampuli za Azure za nje, zingine ni utekelezaji za ndani.
| Templeti | Sura | Ugumu | Huduma | Aina |
|---|---|---|---|---|
| Get started with AI chat | Sura 2 | ⭐⭐ | AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights | Nje |
| Get started with AI agents | Sura 2 | ⭐⭐ | Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights | Nje |
| Azure Search + OpenAI Demo | Sura 2 | ⭐⭐ | AzureOpenAI + Azure AI Search + App Service + Storage | Nje |
| OpenAI Chat App Quickstart | Sura 2 | ⭐ | AzureOpenAI + Container Apps + Application Insights | Nje |
| Agent OpenAI Python Prompty | Sura 5 | ⭐⭐⭐ | AzureOpenAI + Azure Functions + Prompty | Nje |
| Contoso Chat RAG | Sura 8 | ⭐⭐⭐⭐ | AzureOpenAI + AI Search + Cosmos DB + Container Apps | Nje |
| Retail Multi-Agent Solution | Sura 5 | ⭐⭐⭐⭐ | AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB | Ndani |
Templeti za programu zinazostahili uzalishaji zimeainishwa kwa sura za kujifunzia
| Templeti | Sura ya Kujifunzia | Ugumu | Somo Muhimu |
|---|---|---|---|
| openai-chat-app-quickstart | Sura 2 | ⭐ | Mifumo ya msingi ya uanzishaji wa AI |
| azure-search-openai-demo | Sura 2 | ⭐⭐ | Utekelezaji wa RAG na Azure AI Search |
| ai-document-processing | Sura 4 | ⭐⭐ | Uunganishaji wa Document Intelligence |
| agent-openai-python-prompty | Sura 5 | ⭐⭐⭐ | Mfumo wa mawakala na funcition calling |
| contoso-chat | Sura 8 | ⭐⭐⭐ | Uratibu wa AI wa kampuni |
| retail-multi-agent-solution | Sura 5 | ⭐⭐⭐⭐ | Miundo ya mawakala wengi na mawakala wa Mteja na Hisa |
📌 Mifano ya Ndani dhidi ya Nje:
Mifano za Ndani (katika repo hii) = Tayari kutumika mara moja
Mifano za Nje (Azure Samples) = Nakili kutoka kwa repositori zilizounganishwa
- Retail Multi-Agent Solution - Utekelezaji kamili tayari kwa uzalishaji pamoja na templeti za ARM
- Miundo ya mawakala wengi (Wakala wa Mteja + Wakala wa Hisa)
- Ufuatiliaji na tathmini kabambe
- Uanzishaji kwa bonyeza moja kupitia kiolezo cha ARM
Mifano kamili ya uanzishaji wa kontena katika repo hii:
- Container App Examples - Mwongozo kamili wa uanzishaji wa programu za kontena
- Simple Flask API - REST API msingi yenye scale-to-zero
- Microservices Architecture - Uanzishaji wa huduma nyingi unaostahili uzalishaji
- Mwanzo wa Haraka, Uzalishaji, na mifumo ya uanzishaji ya Juu
- Mwongozo wa ufuatiliaji, usalama, na uboreshaji wa gharama
Nakili repositori hizi za Azure Samples ili kuanza:
- Simple Web App - Node.js + MongoDB - Mifumo ya msingi ya uanzishaji
- Static Website - React SPA - Uanzishaji wa maudhui tuli
- Container App - Python Flask - Uanzishaji wa REST API
- Programu ya Hifadhidata - C# + SQL - Mifumo ya uunganishaji wa hifadhidata
- Functions + Cosmos DB - Mtiririko wa data usio na seva
- Java Microservices - Miundo ya huduma nyingi
- Container Apps Jobs - Usindikaji wa kazi za nyuma
- Enterprise ML Pipeline - Mifumo ya ML tayari kwa uzalishaji
- Official AZD Template Gallery - Makusanyo yaliyoratibiwa ya violezo rasmi na vya jamii
- Azure Developer CLI Templates - Nyaraka za kielelezo za Microsoft Learn
- Examples Directory - Mifano ya kujifunzia ya ndani yenye maelezo ya kina
- Command Cheat Sheet - Amri muhimu za azd zilizopangwa kwa sura
- Glossary - Msamiati wa maneno ya Azure na azd
- FAQ - Maswali yanayoulizwa mara kwa mara yaliyopangwa kwa sura za kujifunza
- Study Guide - Mazoezi ya vitendo ya kina
- AI Workshop Lab - Tengeneza suluhisho zako za AI ziweze kutumika kwa AZD (2-3 hours)
- Interactive Workshop - Mazoezi ya moduli 8 yaliyoongozwa na MkDocs na GitHub Codespaces
- Inafuata: Utangulizi → Uchaguzi → Uthibitisho → Uchanganuzi → Usanidi → Ubinafsishaji → Uondoshaji → Hitimisho
- Microsoft Azure Skills on skills.sh - Ujuzi 37 wazi wa mawakala kwa Azure AI, Foundry, uwasilishaji, uchunguzi, uboreshaji wa gharama, na mengine. Waweke kwenye GitHub Copilot, Cursor, Claude Code, au wakala wowote unaounga mkono:
npx skills add microsoft/github-copilot-for-azure
Matatizo ya kawaida ambayo waanzilishi hukutana nayo na suluhisho za papo hapo:
❌ "azd: amri haipatikani"
# Sakinisha AZD kwanza
# Windows (PowerShell):
winget install microsoft.azd
# macOS:
brew tap azure/azd && brew install azd
# Linux:
curl -fsSL https://aka.ms/install-azd.sh | bash
# Thibitisha usakinishaji
azd version❌ "Hakuna usajili uliopatikana" au "Usajili haujawekwa"
# Orodhesha usajili zilizopo
az account list --output table
# Weka usajili wa chaguo-msingi
az account set --subscription "<subscription-id-or-name>"
# Weka kwa mazingira ya AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"
# Thibitisha
az account show❌ "InsufficientQuota" au "Quota imezidi"
# Jaribu eneo tofauti la Azure
azd env set AZURE_LOCATION "westus2"
azd up
# Au tumia SKUs ndogo kwenye uendelezaji
# Hariri infra/main.parameters.json:
{
"sku": "B1" // Instead of "P1V2"
}❌ "azd up" inashindwa katikati ya mchakato
# Chaguo 1: Safisha na jaribu tena
azd down --force --purge
azd up
# Chaguo 2: Rekebisha tu miundombinu
azd provision
# Chaguo 3: Angalia hali kwa undani
azd show
# Chaguo 4: Angalia kumbukumbu (logs) katika Azure Monitor
azd monitor --logs❌ "Uthibitishaji umefeli" au "Token imeisha"
# Thibitisha upya kwa AZD
azd auth logout
azd auth login
# Hiari: sasisha pia Azure CLI ikiwa unafanya amri za az
az logout
az login
# Thibitisha uthibitishaji
az account show❌ "Rasilimali tayari ipo" au "migogoro ya majina"
# AZD huunda majina ya kipekee, lakini ikiwa kuna mgongano:
azd down --force --purge
# Kisha jaribu tena kwa mazingira mapya
azd env new dev-v2
azd up❌ Utekelezaji wa kiolezo unachukua muda mrefu
Wakati wa kawaida wa kusubiri:
- Programu rahisi ya wavuti: dakika 5-10
- Programu yenye hifadhidata: dakika 10-15
- Programu za AI: dakika 15-25 (Upangaji wa OpenAI ni polepole)
# Angalia maendeleo
azd show
# Ikiwa imekwama kwa zaidi ya dakika 30, angalia Azure Portal:
azd monitor --overview
# Tafuta utekelezaji ulioshindwa❌ "Idhini imekataliwa" au "Imezuiwa"
# Angalia jukumu lako la Azure
az role assignment list --assignee $(az account show --query user.name -o tsv)
# Unahitaji angalau jukumu la "Contributor"
# Mwombe msimamizi wako wa Azure akupe:
# - Contributor (kwa rasilimali)
# - User Access Administrator (kwa uteuzi wa majukumu)❌ Haiwezi kupata URL ya programu iliyowekwa
# Onyesha vituo vyote vya huduma
azd show
# Au fungua Portal ya Azure
azd monitor
# Angalia huduma maalum
azd env get-values
# Tafuta vigezo vya *_URL- Mwongozo wa Matatizo ya Kawaida: Suluhisho za Kina
- Matatizo Maalum ya AI: Utatuzi wa AI
- Mwongozo wa Urekebishaji: Uchambuzi hatua kwa hatua
- Pata Msaada: Azure Discord #azure-developer-cli
Fuata maendeleo yako ya kujifunza kila sura:
- Sura 1: Msingi & Anza Haraka ✅
- Sura 2: Maendeleo ya Kwanza ya AI ✅
- Sura 3: Usanidi & Uthibitishaji ✅
- Sura 4: Miundombinu kama Msimbo & Utekelezaji ✅
- Sura 5: Suluhisho za AI zenye mawakala wengi ✅
- Sura 6: Uthibitisho kabla ya Utekelezaji & Mipango ✅
- Sura 7: Utatuzi wa Matatizo & Urekebishaji ✅
- Sura 8: Mifumo ya Uzalishaji & Ya Kampuni ✅
Baada ya kumaliza kila sura, thibitisha maarifa yako kwa:
- Mazoezi ya Vitendo: Kamilisha utekelezaji wa vitendo wa sura
- Uhakiki wa Maarifa: Pitia sehemu ya FAQ ya sura yako
- Majadiliano ya Jamii: Shiriki uzoefu wako kwenye Azure Discord
- Sura Iliyofuata: Hamia ngazi inayofuata ya ugumu
Baada ya kumaliza sura zote, utakuwa na:
- Uzoefu wa Uzalishaji: Umeweka programu halisi za AI kwenye Azure
- Ujuzi wa Kitaaluma: Uwezo wa utekelezaji wa kampuni
- Utambuzi wa Jamii: Mwanachama hai wa jamii ya waendelezaji wa Azure
- Maendeleo ya Kazi: Utaalamu unaohitajika wa AZD na utekelezaji wa AI
- Matatizo ya Kifundi: Ripoti mende na omba vipengele
- Maswali ya Kujifunza: Microsoft Azure Discord Community and
- Msaada Maalum wa AI: Jiunge na
- Nyaraka: Nyaraka Rasmi za Azure Developer CLI
Matokeo ya kura ya maoni ya hivi karibuni kutoka Kituo #Azure:
- 45% ya watengenezaji wanataka kutumia AZD kwa mizigo ya kazi ya AI
- Changamoto kuu: Utekelezaji wa huduma nyingi, usimamizi wa vibali, utayari kwa uzalishaji
- Iliyoombwa zaidi: Violezo maalum kwa AI, mwongozo wa utatuzi, mbinu bora
Jiunge na jamii yetu ili:
- Shiriki uzoefu wako wa AZD + AI na pata msaada
- Pata mapitio ya awali ya violezo vipya vya AI
- Changia mbinu bora za utekelezaji wa AI
- Kuathiri maendeleo ya vipengele vya AI + AZD zijazo
Tunakaribisha michango! Tafadhali soma Mwongozo wa Kuchangia kwa maelezo kuhusu:
- Kuboresha Maudhui: Boresha sura zilizopo na mifano
- Mifano Mpya: Ongeza hali halisi na violezo
- Tafsiri: Saidia kudumisha msaada wa lugha nyingi
- Ripoti za Mende: Boresha usahihi na uwazi
- Viwango vya Jamii: Fuata miongozo yetu ya ujumuishaji wa jamii
Mradi huu umepewa leseni chini ya Leseni ya MIT - angalia faili ya LICENSE kwa maelezo.
Timu yetu hutengeneza kozi zingine za kina za kujifunza:
🚀 Tayari Kuanza Kujifunza?
Waanzilishi: Anza na Sura 1: Msingi & Anza Haraka
Waendelezaji wa AI: Nenda kwa Sura 2: Uendelezaji wa Kwanza kwa AI
Waendelezaji Wenye Uzoefu: Anza na Sura 3: Usanidi & Uthibitisho
Hatua Zifuatazo: Anza Sura 1 - Misingi ya AZD →
Tamko la kutokuwajibika: Nyaraka hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kufikia usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokukamilika. Nyaraka ya awali katika lugha yake ya asili inapaswa kuzingatiwa kama chanzo chenye mamlaka. Kwa taarifa muhimu, inapendekezwa kutumia tafsiri ya kitaalamu ya binadamu. Hatuwajibiki kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.
