Skip to content

README.md

Latest commit

 

History

History
1058 lines (801 loc) · 53.5 KB

README.md

File metadata and controls

1058 lines (801 loc) · 53.5 KB

AZD za začetnike: Strukturirano učno pot

AZD-za-začetnike

GitHub opazovalci GitHub forki GitHub zvezde

Azure Discord Microsoft Foundry Discord

Samodejni prevodi (vedno posodobljeni)

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

Raje klonirate lokalno?

Ta repozitorij vsebuje več kot 50 prevodov, kar znatno poveča velikost prenosa. Če želite klonirati brez prevodov, uporabite 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"

To vam daje vse, kar potrebujete za dokončanje tečaja z veliko hitrejšim prenosom.

🆕 Kaj je novega v azd danes

Azure Developer CLI je prerasel tradicionalne spletne aplikacije in API-je. Danes je azd enotno orodje za razmestitev katerekoli aplikacije v Azure — vključno z aplikacijami, podprtimi z AI, in inteligentnimi agenti.

To za vas pomeni:

  • AI agenti so sedaj primarni azd delovni naložbi. Lahko inicializirate, razmestite in upravljate projekte AI agentov z istim potekom dela azd init → azd up, ki ga že poznate.
  • Integracija Microsoft Foundry prinaša razmestitev modelov, gostovanje agentov in konfiguracijo AI storitev neposredno v ekosistem azd predlog.
  • Osnovni potek dela se ni spremenil. Ne glede na to, ali razmestite todo aplikacijo, mikrostoritev ali več-agentno AI rešitev, so ukazi enaki.

Če ste že uporabljali azd prej, je podpora za AI naravna razširitev — ne ločeno orodje ali napredno sledišče. Če začnete iz nič, se boste naučili en potek dela, ki deluje za vse.

🚀 Kaj je Azure Developer CLI (azd)?

Azure Developer CLI (azd) je prijazno orodje ukazne vrstice za razvijalce, ki poenostavi razmestitev aplikacij v Azure. Namesto ročnega ustvarjanja in povezovanja desetine Azure virov lahko z enim ukazom razmestite celotne aplikacije.

Čarobnost azd up

# Ta enojni ukaz naredi vse:
# ✅ Ustvari vse Azure vire
# ✅ Konfigurira omrežje in varnost
# ✅ Zgradi vašo aplikacijsko kodo
# ✅ Izvede nameščanje v Azure
# ✅ Daje vam delujoč URL
azd up

To je to! Brez klikanja v Azure Portal, brez učenja zapletenih ARM predlogov, brez ročne konfiguracije — samo delujoče aplikacije v Azure.

❓ Azure Developer CLI vs Azure CLI: Kakšna je razlika?

To je najpogostejše vprašanje začetnikov. Tukaj je enostaven odgovor:

Feature Azure CLI (az) Azure Developer CLI (azd)
Purpose Manage individual Azure resources Deploy complete applications
Mindset Infrastructure-focused Application-focused
Example az webapp create --name myapp... azd up
Learning Curve Must know Azure services Just know your app
Best For DevOps, Infrastructure Developers, Prototyping

Preprosta primerjava

  • Azure CLI je kot da imate vsa orodja za gradnjo hiše — kladiva, žage, žeblje. Lahko zgradite karkoli, vendar morate poznati gradbeništvo.
  • Azure Developer CLI je kot da najamete izvajalca — opišete, kar želite, in on poskrbi za gradnjo.

Kdaj uporabiti katerega

Scenario Use This
"I want to deploy my web app quickly" azd up
"I need to create just a storage account" az storage account create
"I'm building a full AI application" azd init --template azure-search-openai-demo
"I need to debug a specific Azure resource" az resource show
"I want production-ready deployment in minutes" azd up --environment production

Delujeta skupaj!

AZD uporablja Azure CLI v ozadju. Uporabljate lahko oboje:

# Namestite svojo aplikacijo z AZD
azd up

# Nato prilagodite določene vire z Azure CLI
az webapp config set --name myapp --always-on true

🌟 Najdite predloge v Awesome AZD

Ne začnite iz nič! Awesome AZD je skupnostna zbirka predlog, pripravljenih za enostavno razmestitev:

Resource Description
🔗 Awesome AZD Gallery Brskajte po 200+ predlogah z enostavno razmestitvijo z enim klikom
🔗 Submit a Template Prispevajte svojo predlogo skupnosti
🔗 GitHub Repository Všečkajte in raziščite izvorno kodo

Priljubljene AI predloge iz Awesome AZD

# RAG klepet z Microsoft Foundry modeli + AI iskanje
azd init --template azure-search-openai-demo

# Hitro AI klepetalno aplikacijo
azd init --template openai-chat-app-quickstart

# AI agenti z Foundry agenti
azd init --template get-started-with-ai-agents

🎯 Začnite v 3 korakih

Preden začnete, preverite, ali je vaš računalnik pripravljen za predlogo, ki jo želite razmestiti:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Če kateri izmed zahtevanih preverjanj ne uspe, to najprej odpravite in nato nadaljujte s hitrim začetkom.

Korak 1: Namestite AZD (2 minuti)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Korak 2: Avtentikacija za AZD

# Opcijsko, če nameravate uporabljati ukaze Azure CLI neposredno v tem tečaju
az login

# Potrebno za AZD poteke dela
azd auth login

Če niste prepričani, katerega potrebujete, sledite celotnemu postopku namestitve v Installation & Setup.

Korak 3: Razmestite svojo prvo aplikacijo

# Inicializiraj iz predloge
azd init --template todo-nodejs-mongo

# Namesti na Azure (ustvari vse!)
azd up

🎉 To je to! Vaša aplikacija je zdaj objavljena v Azure.

Čiščenje (ne pozabite!)

# Remove all resources when done experimenting
azd down --force --purge

📚 Kako uporabljati ta tečaj

Ta tečaj je zasnovan za postopno učenje - začnite tam, kjer se počutite udobno, in postopoma nadgrajujte znanje:

Your Experience Start Here
Brand new to Azure Chapter 1: Foundation
Know Azure, new to AZD Chapter 1: Foundation
Want to deploy AI apps Chapter 2: AI-First Development
Want hands-on practice 🎓 Interactive Workshop - 3-4 hour guided lab
Need production patterns Chapter 8: Production & Enterprise

Hitra nastavitev

  1. Ustvarite fork tega repozitorija: GitHub forki
  2. Klonirajte ga: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. Poiščite pomoč: Azure Discord Community

Raje klonirate lokalno?

Ta repozitorij vsebuje več kot 50 prevodov, kar znatno poveča velikost prenosa. Če želite klonirati brez prevodov, uporabite 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'

To vam daje vse, kar potrebujete za dokončanje tečaja z veliko hitrejšim prenosom.

Pregled tečaja

Obvladujte Azure Developer CLI (azd) skozi strukturirana poglavja, zasnovana za postopno učenje. Poseben poudarek na razmestitvi AI aplikacij z integracijo Microsoft Foundry.

Zakaj je ta tečaj ključnega pomena za sodobne razvijalce

Na podlagi vpogledov skupnosti Microsoft Foundry Discord, 45% razvijalcev želi uporabiti AZD za AI delovne obremenitve, vendar se srečujejo z izzivi pri:

  • Zapletenih večstoritevnih AI arhitekturah
  • Produkcijskih praksah razmestitve AI
  • Integraciji in konfiguraciji Azure AI storitev
  • Optimizaciji stroškov za AI delovne obremenitve
  • Odpravljanju težav pri specifikah razmestitve AI

Cilji učenja

S končanjem tega strukturiranega tečaja boste:

  • Obvladali osnove AZD: Osnovni koncepti, namestitev in konfiguracija
  • Razmestili AI aplikacije: Uporaba AZD z Microsoft Foundry storitvami
  • Uvedli Infrastructure as Code: Upravljanje Azure virov z Bicep predlogami
  • Odpravili težave pri razmestitvah: Reševanje pogostih težav in razhroščevanje
  • Optimizirali za produkcijo: Varnost, skaliranje, spremljanje in upravljanje stroškov
  • Zgradili več-agentne rešitve: Razmestitev zapletenih AI arhitektur

Preden začnete: Računi, dostop in predpostavke

Preden začnete s Poglavjem 1, poskrbite, da imate naslednje. Namestitveni koraki kasneje v tem vodiču predvidevajo, da so te osnovne zahteve že urejene.

  • Naročnina Azure: Uporabite lahko obstoječo naročnino iz službenega računa ali svojo, ali pa ustvarite brezplačni preizkus za začetek.
  • Dovoljenje za ustvarjanje virov v Azure: Za večino vaj bi morali imeti vsaj Contributor dostop do ciljnega naročniškega računa ali skupine virov. Nekatera poglavja lahko predvidevajo tudi, da lahko ustvarjate skupine virov, upravljane identitete in RBAC dodelitve.
  • GitHub račun: To je koristno za forkanje repozitorija, sledenje lastnim spremembam in uporabo GitHub Codespaces za delavnico.
  • Predpogoji za izvajanje predloge: Nekatere predloge potrebujejo lokalna orodja, kot so Node.js, Python, Java ali Docker. Pred začetkom zaženite validator za nastavitev, da zgodaj odkrijete manjkajoča orodja.
  • Osnovno poznavanje terminala: Ni vam treba biti strokovnjak, vendar bi morali biti udobni pri izvajanju ukazov, kot so git clone, azd auth login in azd up.

Delate v naročnini podjetja? Če vaše Azure okolje upravlja skrbnik, vnaprej potrdite, da lahko razmestite vire v naročnini ali skupini virov, ki jo nameravate uporabiti. Če ne, prosite za peskovnik (sandbox) ali dostop Contributor, preden začnete.

Ste novi v Azure? Začnite z lastno preizkusno ali pay-as-you-go naročnino Azure na https://aka.ms/azurefreetrial, tako da lahko vaje dokončate od začetka do konca brez čakanja na odobritve na ravni najemnika.

🗺️ Načrt tečaja: Hitro navigiranje po poglavjih

Vsako poglavje ima ločen README z učnimi cilji, hitrimi začetki in vajami:

Poglavje Tema Lekcije Trajanje Kompleksnost
Poglavje 1: Osnove Začetek Osnove AZD | Namestitev | Prvi projekt 30-45 min ⭐
Poglavje 2: AI razvoj AI-first aplikacije Integracija Foundry | AI agenti | Razmestitev modelov | Delavnica 1-2 hrs ⭐⭐
Poglavje 3: Konfiguracija Avtentikacija in varnost Konfiguracija | Avtentikacija & varnost 45-60 min ⭐⭐
Poglavje 4: Infrastruktura IaC & razmestitev Priročnik za razmestitev | Provisioning 1-1.5 hrs ⭐⭐⭐
Poglavje 5: Več-agentno Rešitve z AI agenti Maloprodajni scenarij | Vzorce koordinacije 2-3 hrs ⭐⭐⭐⭐
Poglavje 6: Pred-razmestitev Načrtovanje & validacija Preflight checks | Načrtovanje kapacitet | Izbira SKU | App Insights 1 hr ⭐⭐
Poglavje 7: Odpravljanje napak Razhroščevanje & popravki Pogoste težave | Razhroščevanje | AI težave 1-1.5 hrs ⭐⭐
Poglavje 8: Produkcija Enterprise vzorci Prakse za produkcijo 2-3 hrs ⭐⭐⭐⭐
🎓 Delavnica Praktični laboratorij Uvod | Izbira | Validacija | Dekonstrukcija | Konfiguracija | Prilagoditev | Demontaža | Zaključek 3-4 hrs ⭐⭐

Skupno trajanje tečaja: ~10-14 ur | Napredovanje znanja: Začetnik → Pripravljen za produkcijo

📚 Učna poglavja

Izberite svojo učno pot glede na raven izkušenj in cilje

🚀 Poglavje 1: Osnove in hiter začetek

Predpogoji: Naročnina Azure, osnovno znanje ukazne vrstice
Trajanje: 30-45 minut
Kompleksnost: ⭐

Kaj se boste naučili

  • Razumevanje osnov Azure Developer CLI
  • Namestitev AZD na vašo platformo
  • Vaša prva uspešna razmestitev

Viri za učenje

Praktične vaje

# Hitro preverjanje namestitve
azd version

# Namestite svojo prvo aplikacijo
azd init --template todo-nodejs-mongo
azd up

💡 Izid poglavja: Uspešno razmestite preprosto spletno aplikacijo v Azure z uporabo AZD

✅ Validacija uspeha:

# Po končanem 1. poglavju boste znali:
azd version              # Prikaže nameščeno različico
azd init --template todo-nodejs-mongo  # Inicializira projekt
azd up                  # Razporedi v Azure
azd show                # Prikaže URL zagnane aplikacije
# Aplikacija se odpre v brskalniku in deluje
azd down --force --purge  # Počisti vire

📊 Časovna naložba: 30-45 minut
📈 Raven spretnosti po: Lahko samostojno razmestite osnovne aplikacije 📈 Raven spretnosti po: Lahko samostojno razmestite osnovne aplikacije

🤖 Poglavje 2: AI-prvi razvoj (priporočeno za razvijalce AI)

Predpogoji: Poglavje 1 dokončano
Trajanje: 1-2 ure
Kompleksnost: ⭐⭐

Kaj se boste naučili

  • Integracija Microsoft Foundry z AZD
  • Razmestitev AI-podprtih aplikacij
  • Razumevanje konfiguracij AI storitev

Viri za učenje

Praktične vaje

# Namestite svojo prvo AI aplikacijo
azd init --template azure-search-openai-demo
azd up

# Preizkusite dodatne AI predloge
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Izid poglavja: Razmestite in konfigurirajte AI-podprto klepetalno aplikacijo z RAG zmogljivostmi

✅ Validacija uspeha:

# Po 2. poglavju boste lahko:
azd init --template azure-search-openai-demo
azd up
# Preizkusiti vmesnik za klepet z AI
# Postavljati vprašanja in prejemati odgovore, ki jih poganja AI, z navedbami virov
# Preveriti, ali integracija iskanja deluje
azd monitor  # Preveriti, ali Application Insights prikazuje telemetrijo
azd down --force --purge

📊 Časovna naložba: 1-2 ure
📈 Raven spretnosti po: Lahko razmestite in konfigurirate AI aplikacije pripravljene za produkcijo
💰 Zavedanje stroškov: Razumeti stroške razvoja $80-150/mesec, stroške produkcije $300-3500/mesec

💰 Razmisleki o stroških za AI razmestitve

Razvojno okolje (ocenjeno $80-150/mesec):

  • Microsoft Foundry modeli (plačilo po uporabi): $0-50/mesec (odvisno od porabe tokenov)
  • AI Search (osnovni nivo): $75/mesec
  • Container Apps (poraba): $0-20/mesec
  • Shramba (Standard): $1-5/mesec

Produkcijsko okolje (ocenjeno $300-3,500+/mesec):

  • Microsoft Foundry modeli (PTU za konsistentno zmogljivost): $3,000+/mesec ALI plačilo po porabi pri velikem obsegu
  • AI Search (standardni nivo): $250/mesec
  • Container Apps (namenski): $50-100/mesec
  • Application Insights: $5-50/mesec
  • Shramba (Premium): $10-50/mesec

💡 Nasveti za optimizacijo stroškov:

  • Uporabite brezplačni nivo Microsoft Foundry modelov za učenje (Azure OpenAI vključuje 50.000 tokenov/mesec)
  • Zaustavite vire z azd down, ko aktivno ne razvijate
  • Začnite z obračunavanjem po porabi, PTU nadgradite le za produkcijo
  • Uporabite azd provision --preview za oceno stroškov pred razmestitvijo
  • Omogočite avtomatsko skaliranje: plačajte samo za dejansko porabo

Spremljanje stroškov:

# Preverite ocenjene mesečne stroške
azd provision --preview

# Spremljajte dejanske stroške v portalu Azure
az consumption budget list --resource-group <your-rg>

⚙️ Poglavje 3: Konfiguracija & Avtentikacija

Predpogoji: Poglavje 1 dokončano
Trajanje: 45-60 minut
Kompleksnost: ⭐⭐

Kaj se boste naučili

  • Upravljanje in konfiguracija okolij
  • Najboljše prakse za avtentikacijo in varnost
  • Poimenovanje in organizacija virov

Viri za učenje

Praktične vaje

  • Konfigurirajte več okolij (dev, staging, prod)
  • Nastavite avtentikacijo z upravljano identiteto
  • Implementirajte konfiguracije, specifične za okolje

💡 Izid poglavja: Upravljajte več okolij z ustrezno avtentikacijo in varnostjo

🏗️ Poglavje 4: Infrastruktura kot koda & Razmestitev

Predpogoji: Poglavja 1-3 dokončana
Trajanje: 1-1.5 ure
Kompleksnost: ⭐⭐⭐

Kaj se boste naučili

  • Napredni vzorci razmestitve
  • Infrastruktura kot koda z Bicep
  • Strategije za provisioning virov

Viri za učenje

Praktične vaje

  • Ustvarite lastne Bicep predloge
  • Razmestite večstoritevne aplikacije
  • Implementirajte blue-green strategije razmestitve

💡 Izid poglavja: Razmestite kompleksne večstoritevne aplikacije z uporabo lastnih infrastrukturnih predlog

🎯 Poglavje 5: Več-agentne AI rešitve (Napredno)

Predpogoji: Poglavja 1-2 dokončana
Trajanje: 2-3 ure
Kompleksnost: ⭐⭐⭐⭐

Kaj se boste naučili

  • Vzorci več-agentne arhitekture
  • Orkestracija in koordinacija agentov
  • Produkcijsko pripravljene AI razmestitve

Viri za učenje

Praktične vaje

# Razmestite celotno maloprodajno večagentno rešitev
cd examples/retail-multiagent-arm-template
./deploy.sh

# Raziščite konfiguracije agentov
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Izid poglavja: Razmestite in upravljajte produkcijsko pripravljeno več-agentno AI rešitev z agenti za stranke in inventar

🔍 Poglavje 6: Pred-razmestitvena validacija & Načrtovanje

Predpogoji: Poglavje 4 dokončano
Trajanje: 1 ura
Kompleksnost: ⭐⭐

Kaj se boste naučili

  • Načrtovanje zmogljivosti in preverjanje virov
  • Strategije izbire SKU-jev
  • Predhodne kontrole in avtomatizacija

Učni viri

Praktične vaje

  • Zaženite skripte za preverjanje zmogljivosti
  • Optimizirajte izbiro SKU-jev glede stroškov
  • Implementirajte avtomatizirane prednamestitvene kontrole

💡 Rezultat poglavja: Preverite in optimizirajte namestitve pred izvedbo

🚨 Poglavje 7: Odpravljanje težav in razhroščevanje

Predpogoji: Katero koli poglavje o nameščanju zaključeno
Trajanje: 1–1,5 ure
Kompleksnost: ⭐⭐

Kaj se boste naučili

  • Sistemski pristopi k razhroščevanju
  • Pogoste težave in rešitve
  • Odpravljanje težav specifičnih za AI

Učni viri

Praktične vaje

  • Diagnozirajte neuspehe namestitve
  • Razrešite težave z avtentikacijo
  • Razhroščevanje povezljivosti storitev AI

💡 Rezultat poglavja: Neodvisno diagnosticirajte in rešujte pogoste težave z namestitvijo

🏢 Poglavje 8: Produkcija in podjetniški vzorci

Predpogoji: Poglavja 1–4 zaključena
Trajanje: 2–3 ure
Kompleksnost: ⭐⭐⭐⭐

Kaj se boste naučili

  • Strategije nameščanja v produkcijo
  • Vzorci varnosti za podjetja
  • Nadzor in optimizacija stroškov

Učni viri

Praktične vaje

  • Implementirajte varnostne vzorce za podjetja
  • Vzpostavite celovit nadzor
  • Namestite v produkcijo z ustreznim upravljanjem

💡 Rezultat poglavja: Namestite aplikacije pripravljene za podjetja z vsemi produkcijskimi zmogljivostmi

🎓 Pregled delavnice: Praktična učna izkušnja

⚠️ STATUS DELAVNICE: V aktivnem razvoju
Gradiva delavnice se trenutno razvijajo in izboljšujejo. Osnovni moduli so funkcionalni, vendar so nekateri naprednejši deli nepopolni. Aktivno delamo na dokončanju vsebine. Spremljajte napredek →

Interaktivni materiali delavnice

Celovito praktično učenje z orodji v brskalniku in vodenimi vajami

Naša gradiva delavnice nudijo strukturirano, interaktivno učno izkušnjo, ki dopolnjuje zgoraj navedeno poglavjsko gradivo. Delavnica je zasnovana tako za samostojno učenje kot za seje pod vodstvom inštruktorja.

🛠️ Značilnosti delavnice

  • Vmesnik v brskalniku: Celovita delavnica na osnovi MkDocs z iskanjem, kopiranjem in možnostmi teme
  • Integracija z GitHub Codespaces: Vzpostavitev razvojnega okolja z enim klikom
  • Strukturirana učna pot: 8-modulne vodene vaje (skupaj 3–4 ure)
  • Postopna metodologija: Uvod → Izbira → Preverjanje → Dekonstrukcija → Konfiguracija → Prilagoditev → Odstranitev → Zaključek
  • Interaktivno DevContainer okolje: Predkonfigurirana orodja in odvisnosti

📚 Struktura modulov delavnice

Delavnica sledi 8-modulni postopni metodologiji, ki vas popelje od odkrivanja do obvladovanja nameščanja:

Module Topic What You'll Do Duration
0. Uvod Pregled delavnice Razumite cilje učenja, predpogoje in strukturo delavnice 15 min
1. Izbira Odkrijte predloge Raziščite AZD predloge in izberite pravo AI predlogo za vaš scenarij 20 min
2. Validation Deploy & Verify Namestite predlogo z azd up in preverite delovanje infrastrukture 30 min
3. Dekonstrukcija Razumite strukturo Uporabite GitHub Copilot za raziskovanje arhitekture predloge, Bicep datotek in organizacije kode 30 min
4. Konfiguracija azure.yaml Deep Dive Obvladajte konfiguracijo azure.yaml, življenjske kuke in spremenljivke okolja 30 min
5. Prilagoditev Make It Yours Omogočite AI Search, sledenje, evalvacijo in prilagodite za vaš scenarij 45 min
6. Odstranitev Clean Up Varno odstranite vire z azd down --purge 15 min
7. Zaključek Next Steps Preglejte dosežke, ključne koncepte in nadaljujte z učenjem 15 min

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

🚀 Začetek z delavnico

# Možnost 1: GitHub Codespaces (Priporočeno)
# Kliknite "Code" → "Create codespace on main" v repozitoriju

# Možnost 2: Lokalni razvoj
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Sledite navodilom za nastavitev v workshop/README.md

🎯 Učni izidi delavnice

Z zaključkom delavnice bodo udeleženci:

  • Namestiti produkcijske AI aplikacije: Uporabite AZD z Microsoft Foundry storitvami
  • Obvladati večagentne arhitekture: Implementirajte usklajene rešitve AI agentov
  • Uveljaviti varnostne najboljše prakse: Konfigurirajte avtentikacijo in nadzor dostopa
  • Optimizirati za skaliranje: Oblikujte stroškovno učinkovite, zmogljive namestitve
  • Odpraviti težave z namestitvami: Samostojno rešujte pogoste težave

📖 Viri delavnice

Idealno za: Korporativno usposabljanje, univerzitetne tečaje, samostojno učenje in programerske bootcampe.

📖 Poglobljen pogled: Zmožnosti AZD

Poleg osnov ponuja AZD močne funkcije za produkcijska nameščanja:

  • Nameščanja na osnovi predlog - Uporabite vnaprej pripravljene predloge za pogoste vzorce aplikacij
  • Infrastruktura kot koda - Upravljajte Azure vire z uporabo Bicep ali Terraform
  • Integrirane delovne tokove - Nemoteno zagotavljanje, nameščanje in nadzorovanje aplikacij
  • Prijazno do razvijalcev - Optimizirano za produktivnost in izkušnjo razvijalcev

AZD + Microsoft Foundry: Idealno za AI nameščanja

Zakaj AZD za AI rešitve? AZD naslavlja glavne izzive, s katerimi se soočajo AI razvijalci:

  • Predloge pripravljene za AI - Predkonfigurirane predloge za Microsoft Foundry modele, Cognitive Services in ML delovne obremenitve
  • Varna AI nameščanja - Vgrajeni varnostni vzorci za AI storitve, API ključe in modelne končne točke
  • Produkcijski AI vzorci - Najboljše prakse za skalabilna, stroškovno učinkovita nameščanja AI aplikacij
  • End-to-End AI delovni tokovi - Od razvoja modela do produkcijske namestitve z ustreznim nadzorom
  • Optimizacija stroškov - Pametna razporeditev virov in strategije skaliranja za AI delovne obremenitve
  • Integracija z Microsoft Foundry - Gladka povezava s katalogom modelov Microsoft Foundry in končnimi točkami

🎯 Knjižnica predlog in primerov

Izpostavljeno: Microsoft Foundry predloge

Začnite tukaj, če nameščate AI aplikacije!

Opomba: Te predloge prikazujejo različne AI vzorce. Nekatere so zunanje Azure vzorce, druge so lokalne implementacije.

Template Chapter Complexity Services Type
Get started with AI chat Poglavje 2 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights Zunanje
Get started with AI agents Poglavje 2 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights Zunanje
Azure Search + OpenAI Demo Poglavje 2 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage Zunanje
OpenAI Chat App Quickstart Poglavje 2 ⭐ AzureOpenAI + Container Apps + Application Insights Zunanje
Agent OpenAI Python Prompty Poglavje 5 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty Zunanje
Contoso Chat RAG Poglavje 8 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps Zunanje
Retail Multi-Agent Solution Poglavje 5 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB Lokalno

Izpostavljeno: Celoviti učni scenariji

Predloge aplikacij pripravljenih za produkcijo, mapirane na učna poglavja

Template Learning Chapter Complexity Key Learning
openai-chat-app-quickstart Poglavje 2 ⭐ Osnovni vzorci nameščanja AI
azure-search-openai-demo Poglavje 2 ⭐⭐ Implementacija RAG z Azure AI Search
ai-document-processing Poglavje 4 ⭐⭐ Integracija Document Intelligence
agent-openai-python-prompty Poglavje 5 ⭐⭐⭐ Okvir agentov in klicanje funkcij
contoso-chat Poglavje 8 ⭐⭐⭐ Orkestracija podjetniškega AI
retail-multi-agent-solution Poglavje 5 ⭐⭐⭐⭐ Večagentna arhitektura s Customer in Inventory agenti

Učenje po tipu primerov

📌 Lokalni proti zunanjim primerom:
Lokalni primeri (v tem repozitoriju) = Na voljo za takojšnjo uporabo
Zunanji primeri (Azure Samples) = Klonirajte iz povezanih repozitorijev

Lokalni primeri (pripravljeni za uporabo)

  • Retail Multi-Agent Solution - Celovita implementacija pripravljena za produkcijo z ARM predlogami
    • Arhitektura z več agenti (Customer + Inventory agenti)
    • Celovit nadzor in ocenjevanje
    • Namestitev z enim klikom preko ARM predloge

Lokalni primeri - Kontejnerske aplikacije (Poglavja 2-5)

Celoviti primeri nameščanja kontejnerjev v tem repozitoriju:

Zunanji primeri - Preproste aplikacije (Poglavja 1-2)

Klonirajte te Azure Samples repozitorije za začetek:

Zunanji primeri - Integracija baz podatkov (Poglavja 3-4)

Zunanji primeri - Napredni vzorci (poglavja 4-8)

Zbirke zunanjih predlog

📚 Viri za učenje in reference

Hitre reference

Delavnice s praktičnimi vajami

  • AI Workshop Lab - Naredite vaše AI rešitve primerne za uvajanje z AZD (2–3 ure)
  • Interactive Workshop - 8-modulne vodene vaje z MkDocs in GitHub Codespaces
    • Sledi: Uvod → Izbira → Preverjanje → Razčlenitev → Konfiguracija → Prilagoditev → Odstranitev → Zaključek

Zunanji viri za učenje

Spretnosti AI agentov za vaš urejevalnik

  • Microsoft Azure Skills on skills.sh - 37 odprtih veščin agentov za Azure AI, Foundry, uvajanje, diagnostiko, optimizacijo stroškov in več. Namestite jih v GitHub Copilot, Cursor, Claude Code ali kateri koli podprt agent: 
    npx skills add microsoft/github-copilot-for-azure

🔧 Hiter vodnik za odpravljanje težav

Pogoste težave, s katerimi se srečujejo začetniki, in takojšnje rešitve:

❌ "azd: command not found" 
# Najprej namestite AZD
# Windows (PowerShell):
winget install microsoft.azd

# macOS:
brew tap azure/azd && brew install azd

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

# Preverite namestitev
azd version
❌ "No subscription found" or "Subscription not set" 
# Seznam razpoložljivih naročnin
az account list --output table

# Nastavi privzeto naročnino
az account set --subscription "<subscription-id-or-name>"

# Nastavi za AZD okolje
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Preveri
az account show
❌ "InsufficientQuota" or "Quota exceeded" 
# Poskusite drugo regijo Azure
azd env set AZURE_LOCATION "westus2"
azd up

# Ali uporabite manjše SKU-je pri razvoju
# Uredite infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" fails halfway through 
# Možnost 1: Očisti in poskusi znova
azd down --force --purge
azd up

# Možnost 2: Samo popravi infrastrukturo
azd provision

# Možnost 3: Preveri podrobno stanje
azd show

# Možnost 4: Preveri dnevnike v Azure Monitorju
azd monitor --logs
❌ "Authentication failed" or "Token expired" 
# Ponovno se prijavite za AZD
azd auth logout
azd auth login

# Neobvezno: osvežite tudi Azure CLI, če izvajate ukaze az
az logout
az login

# Preverite prijavo
az account show
❌ "Resource already exists" or naming conflicts 
# AZD ustvarja enolična imena, vendar če pride do konflikta:
azd down --force --purge

# Nato poskusi znova z novim okoljem
azd env new dev-v2
azd up
❌ Template deployment taking too long

Normal wait times:

  • Preprosta spletna aplikacija: 5–10 minut
  • Aplikacija z bazo podatkov: 10–15 minut
  • AI aplikacije: 15–25 minut (provisioniranje OpenAI je počasno)
# Preverite napredek
azd show

# Če se zatakne več kot 30 minut, preverite Azure Portal:
azd monitor --overview
# Poiščite neuspele razmestitve
❌ "Permission denied" or "Forbidden" 
# Preverite svojo vlogo v Azureu
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Potrebujete vsaj vlogo "Contributor"
# Prosite svojega Azure skrbnika, naj dodeli:
# - Contributor (za vire)
# - User Access Administrator (za dodelitve vlog)
❌ Can't find deployed application URL 
# Prikaži vse končne točke storitev
azd show

# Ali odpri Azure Portal
azd monitor

# Preveri določeno storitev
azd env get-values
# Poišči spremenljivke *_URL

📚 Celotni viri za odpravljanje težav

🎓 Zaključek tečaja in potrdila

Sledenje napredku

Spremljajte svoj napredek skozi posamezna poglavja:

  • Chapter 1: Osnove in hiter začetek ✅
  • Chapter 2: Razvoj, usmerjen na AI ✅
  • Chapter 3: Konfiguracija in avtentikacija ✅
  • Chapter 4: Infrastruktura kot koda in uvajanje ✅
  • Chapter 5: Rešitve AI z več agenti ✅
  • Chapter 6: Preverjanje in načrtovanje pred uvajanjem ✅
  • Chapter 7: Odpravljanje težav in razhroščevanje ✅
  • Chapter 8: Vzorci za produkcijo in podjetja ✅

Preverjanje znanja

Po zaključenem poglavju preverite svoje znanje z:

  1. Praktična vaja: Dokončajte praktično uvajanje poglavja
  2. Preverjanje znanja: Preglejte razdelek FAQ za svoje poglavje
  3. Skupnostna razprava: Delite svoje izkušnje v Azure Discord
  4. Naslednje poglavje: Preidite na naslednjo raven zapletenosti

Prednosti po zaključku tečaja

Po zaključku vseh poglavij boste imeli:

  • Izkušnje s produkcijo: Uvedene resnične AI aplikacije v Azure
  • Poklicne veščine: Sposobnosti uvajanja primerne za podjetja
  • Priznanje v skupnosti: Aktivni član Azure razvijalne skupnosti
  • Napredek v karieri: Priljubljene spretnosti za AZD in uvajanje AI

🤝 Skupnost in podpora

Poiščite pomoč in podporo

Vpogledi skupnosti iz Microsoft Foundry Discorda

Nedavni rezultati ankete iz kanala #Azure:

  • 45% razvijalcev želi uporabljati AZD za AI delovne obremenitve
  • Glavne izzive predstavljajo: večstorivne razmestitve, upravljanje poverilnic, pripravljenost za produkcijo
  • Najbolj zahtevano: AI-specifične predloge, vodniki za odpravljanje težav, priporočene prakse

Pridružite se naši skupnosti, da:

  • Delite svoje izkušnje z AZD + AI in prejmete pomoč
  • Dostopate do zgodnjih predogledov novih AI predlog
  • Prispevate k najboljšim praksam za uvajanje AI
  • Vplivate na prihodnji razvoj funkcij AI + AZD

Prispevanje k tečaju

Prispevki so dobrodošli! Prosimo, preberite naš Contributing Guide za podrobnosti o:

  • Izboljšave vsebine: Nadgradite obstoječa poglavja in primere
  • Novi primeri: Dodajte resnične scenarije in predloge
  • Prevodi: Pomagajte vzdrževati večjezično podporo
  • Poročila o napakah: Izboljšajte natančnost in jasnost
  • Standardi skupnosti: Upoštevajte naša vključujoča pravila skupnosti

📄 Informacije o tečaju

Licenca

Ta projekt je licenciran pod licenco MIT - za podrobnosti glejte datoteko LICENSE.

Povezani Microsoftovi učni viri

Our team produces other comprehensive learning courses:

LangChain

LangChain4j za začetnike LangChain.js za začetnike LangChain za začetnike

Azure / Edge / MCP / Agents

AZD za začetnike Edge AI za začetnike MCP za začetnike AI agenti za začetnike

Serija o generativnem AI

Generativni AI za začetnike Generativni AI (.NET) Generativni AI (Java) Generativni AI (JavaScript)

Osnovno učenje

ML za začetnike Podatkovna znanost za začetnike Umetna inteligenca za začetnike Kibernetska varnost za začetnike Spletni razvoj za začetnike IoT za začetnike Razvoj XR za začetnike

Serija Copilot

Copilot za programiranje v paru z AI Copilot za C#/.NET Copilot Pustolovščina

🗺️ Navigacija tečaja

🚀 Pripravljeni začeti z učenjem?

Začetniki: Začnite s Poglavje 1: Temelji in hiter začetek
Razvijalci AI: Pojdite na Poglavje 2: Razvoj z AI v ospredju
Izkušeni razvijalci: Začnite z Poglavje 3: Konfiguracija in overjanje

Naslednji koraki: Začni poglavje 1 - Osnove AZD →

Izjava o omejitvi odgovornosti: Ta dokument je bil preveden z uporabo storitve za prevajanje z umetno inteligenco Co-op Translator. Čeprav si prizadevamo za natančnost, prosimo, upoštevajte, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku velja za avtoritativni vir. Za kritične informacije priporočamo strokovni prevod, opravljen s strani človeka. Ne odgovarjamo za morebitne nesporazume ali napačne razlage, ki izhajajo iz uporabe tega prevoda.
⚡