Skip to content

README.md

Latest commit

 

History

History
1058 lines (801 loc) · 54.9 KB

README.md

File metadata and controls

1058 lines (801 loc) · 54.9 KB

AZD Aloittelijoille: Rakenteellinen oppimispolku

AZD-aloittelijoille

GitHub seuraajat GitHub forkit GitHub tähdet

Azure Discord Microsoft Foundry Discord

Automaattiset käännökset (aina ajan tasalla)

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

Haluatko kloonata paikallisesti?

Tämä repositorio sisältää yli 50 käännöstä, mikä kasvattaa latauskokoa merkittävästi. Jos haluat kloonata ilman käännöstiedostoja, käytä sparseta checkoutia:

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"

Tämä antaa sinulle kaiken tarvittavan kurssin suorittamiseen paljon nopeammalla latauksella.

🆕 Mitä uutta azd:ssä tänään

Azure Developer CLI on laajentunut perinteisistä web-sovelluksista ja API:ista. Nykyään azd on ainoa työkalu, jolla voit ottaa käyttöön minkä tahansa sovelluksen Azureen — mukaan lukien tekoälyä hyödyntävät sovellukset ja älykkäät agentit.

Tämä tarkoittaa sinulle:

  • AI-agentit ovat nyt ensiluokkaisia azd-työkuormia. Voit alustaa, ottaa käyttöön ja hallita AI-agenttiprojekteja samalla azd init → azd up -työnkululla, jonka jo tunnet.
  • Microsoft Foundry -integraatio tuo mallien käyttöönoton, agenttien isännöinnin ja AI-palveluiden määrityksen suoraan azd-mallit-ekosysteemiin.
  • Ydintyönkulku ei ole muuttunut. Olipa kyse todo-sovelluksesta, mikropalvelusta tai moniagenttisesta AI-ratkaisusta, komennot ovat samat.

Jos olet käyttänyt azd:tä aiemmin, AI-tuki on luonnollinen laajennus — ei erillinen työkalu tai edistyksellinen polku. Jos aloitat alusta, opit yhden työnkulun, joka toimii kaikkeen.

🚀 Mikä on Azure Developer CLI (azd)?

Azure Developer CLI (azd) on kehittäjäystävällinen komentorivityökalu, joka tekee sovellusten käyttöönotosta Azureen helppoa. Sen sijaan, että loisit ja yhdistäisit manuaalisesti kymmeniä Azure-resursseja, voit ottaa käyttöön kokonaisia sovelluksia yhdellä komennolla.

azd up -toiminnon taika

# Tämä yksittäinen komento tekee kaiken:
# ✅ Luo kaikki Azure-resurssit
# ✅ Määrää verkot ja tietoturvan
# ✅ Kääntää sovelluskoodisi
# ✅ Julkaisee Azureen
# ✅ Antaa sinulle toimivan URL-osoitteen
azd up

Siinä se! Ei Azure-portaalissa klikkailua, ei monimutkaisten ARM-mallien opettelua ensin, ei manuaalista konfigurointia — vain toimivia sovelluksia Azureen.

❓ Azure Developer CLI vs Azure CLI: Mikä on ero?

Tämä on yleisin kysymys, jonka aloittelijat esittävät. Tässä yksinkertainen vastaus:

Feature Azure CLI (az) Azure Developer CLI (azd)
Purpose Hallitse yksittäisiä Azure-resursseja Ota käyttöön kokonaisia sovelluksia
Mindset Infrastruktuuriin keskittyvä Sovellukseen keskittyvä
Example az webapp create --name myapp... azd up
Learning Curve Vaatii Azure-palvelujen tuntemusta Tarvitsee vain sovelluksen tuntemuksen
Best For DevOps, infrastruktuuri Kehittäjät, prototypointi

Yksinkertainen vertauskuva

  • Azure CLI on kuin kaikki työkalut talon rakentamiseen — vasarat, sahat, naulat. Voit rakentaa mitä tahansa, mutta sinun täytyy ymmärtää rakentaminen.
  • Azure Developer CLI on kuin urakoitsijan palkkaaminen — kuvailet mitä haluat, ja he hoitavat rakentamisen.

Milloin käyttää kumpaakin

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

Ne toimivat yhdessä!

AZD käyttää Azure CLI:tä taustalla. Voit käyttää molempia:

# Ota sovelluksesi käyttöön AZD:n avulla
azd up

# Säädä sitten tiettyjä resursseja Azure CLI:llä
az webapp config set --name myapp --always-on true

🌟 Löydä malleja Awesome AZD:stä

Älä aloita alusta! Awesome AZD on yhteisön kokoelma valmiita malleja, jotka ovat heti käyttövalmiita:

Resource Description
🔗 Awesome AZD Gallery Selaa yli 200 mallia ja ota ne käyttöön yhdellä napsautuksella
🔗 Submit a Template Lähetä oma mallisi yhteisölle
🔗 GitHub Repository Tähtää ja tutki lähdekoodia

Suositut AI-mallit Awesome AZD:stä

# RAG-chat Microsoft Foundry -malleilla + AI-haku
azd init --template azure-search-openai-demo

# Nopea AI-chat-sovellus
azd init --template openai-chat-app-quickstart

# AI-agentit Foundry-agenttien kanssa
azd init --template get-started-with-ai-agents

🎯 Aloittaminen kolmessa vaiheessa

Ennen kuin aloitat, varmista että koneesi on valmis käyttämään mallia, jonka haluat ottaa käyttöön:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Jos jokin vaadituista tarkistuksista epäonnistuu, korjaa se ensin ja jatka sitten pika-askeleesta.

Vaihe 1: Asenna AZD (2 minuuttia)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Vaihe 2: Todennus AZD:lle

# Valinnainen, jos aiot käyttää Azure CLI -komentoja suoraan tässä kurssissa
az login

# Vaaditaan AZD-työnkuluissa
azd auth login

Jos et ole varma, mitä tarvitset, seuraa koko asennus- ja määritysprosessia kohdassa Asennus ja määritys.

Vaihe 3: Ota ensimmäinen sovellus käyttöön

# Alusta mallipohjasta
azd init --template todo-nodejs-mongo

# Ota käyttöön Azureen (luo kaiken!)
azd up

🎉 Siinä se! Sovelluksesi on nyt käytössä Azuren palveluissa.

Siivoaminen (älä unohda!)

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

📚 Kuinka käyttää tätä kurssia

Tämä kurssi on suunniteltu portaittaiseksi oppimiseksi — aloita siltä tasolta, jossa olet mukavin, ja etene siitä eteenpäin:

Your Experience Start Here
Brand new to Azure Luku 1: Perusteet
Know Azure, new to AZD Luku 1: Perusteet
Want to deploy AI apps Luku 2: AI-ensimmäinen kehitys
Want hands-on practice 🎓 Interaktiivinen työpaja - 3–4 tunnin ohjattu laboratorio
Need production patterns Luku 8: Tuotanto & yritysratkaisut

Pikainen asennus

  1. Forkkaa tämä repository: GitHub forkit
  2. Kloonaa se: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. Hanki apua: Azure Discord -yhteisö

Haluatko kloonata paikallisesti?

Tämä repositorio sisältää yli 50 käännöstä, mikä kasvattaa latauskokoa merkittävästi. Jos haluat kloonata ilman käännöstiedostoja, käytä sparseta checkoutia:

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'

Tämä antaa sinulle kaiken tarvittavan kurssin suorittamiseen paljon nopeammalla latauksella.

Kurssin yleiskatsaus

Hallitse Azure Developer CLI (azd) rakenteellisten lukujen kautta, jotka on suunniteltu portaittaista oppimista varten. Erityinen painotus AI-sovellusten käyttöönotossa Microsoft Foundry -integraation kanssa.

Miksi tämä kurssi on oleellinen nykyaikaisille kehittäjille

Microsoft Foundry Discord -yhteisön näkemyksiin perustuen 45 % kehittäjistä haluaa käyttää AZD:tä AI-työkuormiin, mutta he kohtaavat haasteita:

  • Monimutkaiset monipalveluiset AI-arkkitehtuurit
  • Tuotantovalmiiden AI-järjestelmien käyttöönoton parhaat käytännöt
  • Azure AI -palvelujen integrointi ja määritys
  • Kustannusten optimointi AI-työkuormille
  • AI-spesifisten käyttöönotto-ongelmien vianmääritys

Oppimistavoitteet

Suorittamalla tämän rakenteellisen kurssin:

  • Hallinnoi AZD:n perusteet: ydinajatusmallit, asennus ja konfigurointi
  • Ota AI-sovelluksia käyttöön: käytä AZD:tä Microsoft Foundry -palvelujen kanssa
  • Ota käyttöön Infrastructure as Code: hallitse Azure-resursseja Bicep-mallien avulla
  • Vianmääritys käyttöönotossa: ratkaise yleisiä ongelmia ja debuggaa virheitä
  • Optimoi tuotantokäyttöön: turvallisuus, skaalaus, valvonta ja kustannusten hallinta
  • Rakenna moniagenttisia ratkaisuja: ota käyttöön monimutkaisia AI-arkkitehtuureja

Ennen kuin aloitat: tilit, käyttöoikeudet ja oletukset

Ennen kuin aloitat luvun 1, varmista että sinulla on seuraavat asiat kunnan. Tämän oppaan myöhemmät asennusvaiheet olettavat, että nämä perusasiat on jo hoidettu.

  • Azure-tilaus: Voit käyttää olemassa olevaa tilausta työpaikalta tai omalta tililtäsi, tai luoda free trial aloittaaksesi.
  • Oikeudet Azure-resurssien luomiseen: Useimpiin harjoituksiin tarvitset vähintään Contributor-käyttöoikeuden kohdetilaukseen tai resurssiryhmään. Joissakin luvuissa saatetaan myös olettaa, että voit luoda resurssiryhmiä, hallittuja identiteettejä ja RBAC-tehtäviä.
  • GitHub-tili: Tämä on hyödyllinen repositorion forkkaamiseen, omien muutosten seuraamiseen ja GitHub Codespacesin käyttämiseen työpajassa.
  • Mallipohjan ajonaikaiset vaatimukset: Jotkin mallipohjat tarvitsevat paikallisia työkaluja, kuten Node.js, Python, Java tai Docker. Suorita asennuksen tarkistus ennen aloittamista, jotta havaitset puuttuvat työkalut ajoissa.
  • Perustason komentorivin tuntemus: Et tarvitse asiantuntijan tasoa, mutta sinun tulisi osata ajaa komentoja kuten git clone, azd auth login ja azd up.

Työskenteletkö yritystilin alla? Jos Azure-ympäristöäsi hallinnoi järjestelmänvalvoja, varmista etukäteen, että voit ottaa resursseja käyttöön siinä tilauksessa tai resurssiryhmässä, jota aiot käyttää. Jos et voi, pyydä sandbox-tilausta tai Contributor-oikeuksia ennen aloittamista.

Uusi Azureen? Aloita omalla Azure-kokeilutilauksellasi tai pay-as-you-go -tilauksella osoitteessa https://aka.ms/azurefreetrial, jotta voit suorittaa harjoitukset kokonaisuudessaan ilman vuokraaja-tason hyväksyntöjä.

🗺️ Kurssikartta: Pikainen navigointi lukujen mukaan

Jokaisella luvulla on oma README, jossa on oppimistavoitteet, pikapikaohjeet ja harjoitukset:

Chapter Topic Lessons Duration Complexity
Luku 1: Perusta Aloittaminen AZD-perusteet | Asennus | Ensimmäinen projektisi 30-45 min ⭐
Luku 2: AI-kehitys AI-ensisijaiset sovellukset Foundry-integrointi | AI-agentit | AI-mallien käyttöönotto | Työpaja 1-2 hrs ⭐⭐
Luku 3: Konfigurointi Autentikointi ja turvallisuus Konfigurointi | Autentikointi ja turvallisuus 45-60 min ⭐⭐
Luku 4: Infrastruktuuri IaC ja käyttöönotto Käyttöönotto-opas | Provisiointi 1-1.5 hrs ⭐⭐⭐
Luku 5: Moni-agentti AI-agenttiratkaisut Vähittäiskaupan skenaario | Koordinointimallit 2-3 hrs ⭐⭐⭐⭐
Luku 6: Ennen käyttöönottoa Suunnittelu ja validointi Esitarkastukset | Kapasiteettisuunnittelu | SKU-valinta | Application Insights 1 hr ⭐⭐
Luku 7: Vianetsintä Debuggaus & korjaus Yleiset ongelmat | Debuggaus | AI-ongelmat 1-1.5 hrs ⭐⭐
Luku 8: Tuotanto Yrityskäytännöt Tuotantokäytännöt 2-3 hrs ⭐⭐⭐⭐
🎓 Työpaja Käytännön harjoitus Johdanto | Valinta | Validointi | Purku | Konfigurointi | Muokkaus | Infrastruktuurin purku | Yhteenveto 3-4 hrs ⭐⭐

Kurssin kokonaiskesto: ~10-14 tuntia | Taitojen eteneminen: Aloittelija → Tuotantovalmius

📚 Oppimislukujen sisältö

Valitse oppimispolku kokemustason ja tavoitteiden mukaan

🚀 Luku 1: Perusta & Pikakäynnistys

Esivaatimukset: Azure-tilaus, perustason komentorivin tuntemus
Kesto: 30-45 minuuttia
Monimutkaisuus: ⭐

Mitä opit

  • Azure Developer CLI:n perusteiden ymmärtäminen
  • AZD:n asentaminen omalle alustallesi
  • Ensimmäinen onnistunut käyttöönotto

Oppimateriaalit

Käytännön harjoitukset

# Nopea asennustarkistus
azd version

# Ota ensimmäinen sovelluksesi käyttöön
azd init --template todo-nodejs-mongo
azd up

💡 Luvun lopputulos: Ota onnistuneesti käyttöön yksinkertainen web-sovellus Azureen käyttäen AZD:ta

✅ Onnistumisen validointi:

# Luvun 1 suorittamisen jälkeen sinun pitäisi osata:
azd version              # Näyttää asennetun version
azd init --template todo-nodejs-mongo  # Alustaa projektin
azd up                  # Julkaisee Azureen
azd show                # Näyttää käynnissä olevan sovelluksen URL-osoitteen
# Sovellus avautuu selaimessa ja toimii
azd down --force --purge  # Siivoaa resurssit

📊 Aika-arvio: 30-45 minuuttia
📈 Taitotaso tämän jälkeen: Pystyy ottamaan käyttöön perustason sovelluksia itsenäisesti
📈 Taitotaso tämän jälkeen: Pystyy ottamaan käyttöön perustason sovelluksia itsenäisesti

🤖 Luku 2: AI-ensisuuntautunut kehitys (Suositellaan AI-kehittäjille)

Esivaatimukset: Luku 1 suoritettu
Kesto: 1-2 tuntia
Monimutkaisuus: ⭐⭐

Mitä opit

  • Microsoft Foundryn integrointi AZD:hen
  • AI-ominaisuuksilla varustettujen sovellusten käyttöönotto
  • AI-palvelukonfiguraatioiden ymmärtäminen

Oppimateriaalit

Käytännön harjoitukset

# Ota ensimmäinen tekoälysovelluksesi käyttöön
azd init --template azure-search-openai-demo
azd up

# Kokeile lisää tekoälymalleja
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Luvun lopputulos: Ota käyttöön ja konfiguroi AI-voimainen chat-sovellus RAG-ominaisuuksilla

✅ Onnistumisen validointi:

# Luvun 2 jälkeen sinun pitäisi osata:
azd init --template azure-search-openai-demo
azd up
# Testata tekoälychatin käyttöliittymää
# Esittää kysymyksiä ja saada tekoälypohjaisia vastauksia lähteineen
# Varmistaa, että hakuintegraatio toimii
azd monitor  # Tarkistaa, että Application Insights näyttää telemetriatiedot
azd down --force --purge

📊 Aika-arvio: 1-2 tuntia
📈 Taitotaso tämän jälkeen: Pystyy ottamaan käyttöön ja konfiguroimaan tuotantovalmiita AI-sovelluksia
💰 Kustannustietoisuus: Ymmärrä $80-150/month kehityskustannukset, $300-3500/month tuotantokustannukset

💰 Kustannusnäkökohdat AI-käyttöönotossa

Kehitysympäristö (arvio $80-150/kk):

  • Microsoft Foundry -mallit (Pay-as-you-go): $0-50/kk (perustuu token-käyttöön)
  • AI Search (Basic-taso): $75/kk
  • Container Apps (Consumption): $0-20/kk
  • Tallennustila (Standard): $1-5/kk

Tuotantoympäristö (arvio $300-3,500+/kk):

  • Microsoft Foundry -mallit (PTU tasaisen suorituskyvyn takaamiseksi): $3,000+/kk TAI Pay-as-you-go kovalla volyymilla
  • AI Search (Standard-taso): $250/kk
  • Container Apps (Dedicated): $50-100/kk
  • Application Insights: $5-50/kk
  • Tallennustila (Premium): $10-50/kk

💡 Kustannusten optimointivinkit:

  • Käytä Free Tier Microsoft Foundry -malleja oppimiseen (Azure OpenAI 50,000 tokens/month included)
  • Suorita azd down vapauttaaksesi resursseja, kun et aktiivisesti kehitä
  • Aloita kulutukseen perustuvalla laskutuksella, nosta PTU:hun vain tuotannossa
  • Käytä azd provision --preview arvioidaksesi kustannuksia ennen käyttöönottoa
  • Ota käyttöön automaattinen skaalaus: maksa vain todellisesta käytöstä

Kustannusten seuranta:

# Tarkista arvioidut kuukausikustannukset
azd provision --preview

# Seuraa todellisia kustannuksia Azure-portaalissa
az consumption budget list --resource-group <your-rg>

⚙️ Luku 3: Konfigurointi ja autentikointi

Esivaatimukset: Luku 1 suoritettu
Kesto: 45-60 minuuttia
Monimutkaisuus: ⭐⭐

Mitä opit

  • Ympäristön konfigurointi ja hallinta
  • Autentikointi ja tietoturvan parhaat käytännöt
  • Resurssien nimeäminen ja jäsentely

Oppimateriaalit

Käytännön harjoitukset

  • Konfiguroi useita ympäristöjä (dev, staging, prod)
  • Ota käyttöön hallinnoitu identiteetin autentikointi
  • Toteuta ympäristökohtaiset konfiguraatiot

💡 Luvun lopputulos: Hallitse useita ympäristöjä asianmukaisella autentikoinnilla ja tietoturvalla

🏗️ Luku 4: Infrastruktuuri koodina & käyttöönotto

Esivaatimukset: Luvut 1-3 suoritettu
Kesto: 1-1.5 tuntia
Monimutkaisuus: ⭐⭐⭐

Mitä opit

  • Edistyneet käyttöönotto-mallit
  • Infrastruktuuri koodina Bicepillä
  • Resurssien provisiointistrategiat

Oppimateriaalit

Käytännön harjoitukset

  • Luo mukautettuja Bicep-malleja
  • Ota käyttöön monipalvelu-sovelluksia
  • Ota käyttöön blue-green -käyttöönotto-strategioita

💡 Luvun lopputulos: Ota käyttöön monimutkaisia monipalvelusovelluksia käyttämällä mukautettuja infrastruktuurimalleja

🎯 Luku 5: Moni-agenttiset AI-ratkaisut (Edistynyt)

Esivaatimukset: Luvut 1-2 suoritettu
Kesto: 2-3 tuntia
Monimutkaisuus: ⭐⭐⭐⭐

Mitä opit

  • Moni-agentti-arkkitehtuurimallit
  • Agenttien orkestrointi ja koordinointi
  • Tuotantovalmiit AI-käyttöönotot

Oppimateriaalit

Käytännön harjoitukset

# Ota käyttöön täydellinen vähittäiskaupan moniagenttinen ratkaisu
cd examples/retail-multiagent-arm-template
./deploy.sh

# Tutki agenttien kokoonpanoja
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Luvun lopputulos: Ota käyttöön ja hallinnoi tuotantovalmista moni-agenttista AI-ratkaisua Customer- ja Inventory-agenteilla

🔍 Luku 6: Ennen käyttöönottoa – validointi ja suunnittelu

Esivaatimukset: Luku 4 suoritettu
Kesto: 1 tunti
Monimutkaisuus: ⭐⭐

Mitä opit

  • Kapasiteettisuunnittelu ja resurssien validointi
  • SKU-valintastrategiat
  • Ennakkotarkistukset ja automaatio

Oppimateriaalit

Käytännön harjoitukset

  • Suorita kapasiteetin validointiskriptit
  • Optimoi SKU-valinnat kustannusten mukaan
  • Toteuta automatisoituja ennakkokäyttöönoton tarkistuksia

💡 Luvun tulos: Varmista ja optimoi käyttöönotot ennen toteutusta

🚨 Luku 7: Vianmääritys ja virheiden etsintä

Esivaatimukset: Mikä tahansa käyttöönottoa käsittelevä luku suoritettu
Kesto: 1–1,5 tuntia
Monimutkaisuus: ⭐⭐

Mitä opit

  • Järjestelmälliset virheiden etsintämenetelmät
  • Yleisimmät ongelmat ja ratkaisut
  • Tekoälyyn liittyvä vianmääritys

Oppimateriaalit

Käytännön harjoitukset

  • Diagnosoi käyttöönoton epäonnistumiset
  • Ratkaise todennusongelmat
  • Etsi ja korjaa tekoälypalvelun yhteysongelmat

💡 Luvun tulos: Pystyt itsenäisesti diagnosoimaan ja ratkaisemaan yleiset käyttöönottoon liittyvät ongelmat

🏢 Luku 8: Tuotanto- ja yritysmallit

Esivaatimukset: Luvut 1–4 suoritetut
Kesto: 2–3 tuntia
Monimutkaisuus: ⭐⭐⭐⭐

Mitä opit

  • Tuotantokäyttöönoton strategiat
  • Yritystason suojausmallit
  • Valvonta ja kustannusten optimointi

Oppimateriaalit

Käytännön harjoitukset

  • Toteuta yritystason suojausmalleja
  • Ota käyttöön kattava valvonta
  • Ota käyttöönotto tuotantoon asianmukaisen hallinnon puitteissa

💡 Luvun tulos: Ota käyttöön yritysvalmiita sovelluksia, joilla on täysi tuotantokapasiteetti

🎓 Workshopin yleiskatsaus: Käytännön oppimiskokemus

⚠️ WORKSHOP STATUS: Kehitteillä
Työpajan materiaalit ovat tällä hetkellä kehitteillä ja viimeistelyvaiheessa. Ydinmoduulit toimivat, mutta jotkin edistyneemmät osiot ovat keskeneräisiä. Työskentelemme aktiivisesti kaikkien sisältöjen täydentämiseksi. Seuraa edistymistä →

Interaktiiviset työpajamateriaalit

Kattava käytännön oppimiskokemus selainpohjaisilla työkaluilla ja ohjatuilla harjoituksilla

Työpajan materiaalit tarjoavat rakenteellisen, interaktiivisen oppimiskokemuksen, joka täydentää yllä olevia lukuja. Työpaja on suunniteltu sekä itsenäiseen opiskeluun että ohjattuihin sessioihin.

🛠️ Työpajan ominaisuudet

  • Selaimessa toimiva käyttöliittymä: Täydellinen MkDocs-pohjainen työpaja hakutoiminnolla, kopioinnilla ja teemavalinnoilla
  • GitHub Codespaces -integraatio: Yhden klikkauksen kehitysympäristön käyttöönotto
  • Rakenettu oppimispolku: 8-moduulinen ohjattu harjoitus (yhteensä 3–4 tuntia)
  • Johdonmukainen metodologia: Johdanto → Valinta → Validointi → Pureminen → Konfigurointi → Räätälöinti → Purku → Yhteenveto
  • Interaktiivinen DevContainer-ympäristö: Esikonfiguroidut työkalut ja riippuvuudet

📚 Työpajan moduulirakenne

Työpaja noudattaa 8-moduulista johdonmukaista metodologiaa, joka vie sinut löytämisestä käyttöönoton hallintaan:

Moduuli Aihe Mitä teet Kesto
0. Johdanto Työpajan yleiskatsaus Ymmärrä oppimistavoitteet, esivaatimukset ja työpajan rakenne 15 min
1. Valinta Mallin löytäminen Tutki AZD-malleja ja valitse oikea AI-malli tilanteeseesi 20 min
2. Validointi Ota käyttöön ja varmista Ota malli käyttöön komennolla azd up ja varmista infrastruktuurin toimivuus 30 min
3. Rakenneanalyysi Ymmärrä rakenne Käytä GitHub Copilotia tutkiaksesi mallin arkkitehtuuria, Bicep-tiedostoja ja koodin järjestelyä 30 min
4. Konfigurointi azure.yaml syväluotaus Hallitse azure.yaml-konfiguraatio, elinkaarikoukut ja ympäristömuuttujat 30 min
5. Räätälöinti Tee siitä oma Ota käyttöön AI-haku, jäljitys, arviointi ja räätälöi tilanteeseesi 45 min
6. Purku Siivous Poista resurssit turvallisesti komennolla azd down --purge 15 min
7. Yhteenveto Seuraavat askeleet Käy läpi saavutukset, keskeiset käsitteet ja jatka oppimismatkaa 15 min

Työpajan kulku:

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

🚀 Aloittaminen työpajan kanssa

# Vaihtoehto 1: GitHub Codespaces (suositeltu)
# Napsauta arkistossa "Code" → "Create codespace on main"

# Vaihtoehto 2: Paikallinen kehitys
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Noudata asennusohjeita tiedostossa workshop/README.md

🎯 Työpajan oppimistulokset

Työpajan suorittamalla osallistujat:

  • Ota käyttöön tuotannon AI-sovelluksia: Käytä AZD:tä Microsoft Foundryn palveluiden kanssa
  • Hallitse moni-agenttiarkkitehtuurit: Toteuta koordinoituja tekoälyagenttiratkaisuja
  • Ota käyttöön tietoturvan parhaat käytännöt: Konfiguroi todennus ja käyttöoikeuksien hallinta
  • Optimoi skaalautuvuutta varten: Suunnittele kustannustehokkaita ja suorituskykyisiä käyttöönottoja
  • Vianmääritys käyttöönottoihin: Ratkaise yleiset ongelmat itsenäisesti

📖 Työpajaresurssit

Täydellinen kohderyhmälle: Yrityskoulutus, yliopistokurssit, itsenäinen opiskelu ja kehittäjäbootcampit.

📖 Syventävä katsaus: AZD:n ominaisuudet

Perusasioiden lisäksi AZD tarjoaa tehokkaita ominaisuuksia tuotantokäyttöönottoihin:

  • Mallipohjaiset käyttöönotot - Käytä valmiiksi rakennettuja malleja yleisiin sovelluskuvioihin
  • Infrastructure as Code - Hallitse Azure-resursseja Bicepillä tai Terraformilla
  • Integroitu työnkulku - Provisionoi, ota käyttöön ja valvo sovelluksia saumattomasti
  • Kehittäjäystävällinen - Optimoitu kehittäjätuottavuuteen ja käyttökokemukseen

AZD + Microsoft Foundry: Täydellinen tekoälykäyttöönottoihin

Miksi AZD tekoälyratkaisuihin? AZD vastaa tekoälykehittäjien yleisimpiin haasteisiin:

  • AI-valmiit mallit - Esikonfiguroidut mallit Microsoft Foundry -malleille, Cognitive Servicesille ja ML-kuormille
  • Turvalliset AI-käyttöönotot - Sisäänrakennetut suojausmallit AI-palveluille, API-avaimille ja mallipäätteille
  • Tuotannon AI-mallit - Parhaat käytännöt skaalautuviin, kustannustehokkaisiin AI-sovelluksiin
  • End-to-End AI-työnkulut - Mallikehityksestä tuotantoon seurantaan saakka
  • Kustannusoptimointi - Älykkäät resurssien allokointi- ja skaalausstrategiat AI-kuormille
  • Microsoft Foundry -integraatio - Saumaton yhteys Microsoft Foundryn mallikatalogiin ja päätepisteisiin

🎯 Mallien & esimerkkien kirjasto

Esittelyssä: Microsoft Foundry -mallit

Aloita tästä, jos olet ottamassa käyttöön tekoälysovelluksia!

Huom: Nämä mallit esittelevät erilaisia AI-kuvioita. Osa on Azure Samples -ulkoisia, toiset paikallisia toteutuksia.

Malli Luku Monimutkaisuus Palvelut Tyyppi
Get started with AI chat Luku 2 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights Ulkoinen
Get started with AI agents Luku 2 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights Ulkoinen
Azure Search + OpenAI Demo Luku 2 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage Ulkoinen
OpenAI Chat App Quickstart Luku 2 ⭐ AzureOpenAI + Container Apps + Application Insights Ulkoinen
Agent OpenAI Python Prompty Luku 5 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty Ulkoinen
Contoso Chat RAG Luku 8 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps Ulkoinen
Retail Multi-Agent Solution Luku 5 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB Paikallinen

Esittelyssä: Valmiit oppimistapaukset

Tuotantovalmiit sovellusmallit yhdistettynä lukuihin

Malli Oppiluku Monimutkaisuus Keskeinen oppi
openai-chat-app-quickstart Luku 2 ⭐ Perus AI-käyttöönottojen mallit
azure-search-openai-demo Luku 2 ⭐⭐ RAG-toteutus Azure AI Searchin kanssa
ai-document-processing Luku 4 ⭐⭐ Document Intelligence -integraatio
agent-openai-python-prompty Luku 5 ⭐⭐⭐ Agent-kehys ja function calling
contoso-chat Luku 8 ⭐⭐⭐ Yritystason AI-orchestrointi
retail-multi-agent-solution Luku 5 ⭐⭐⭐⭐ Moni-agenttiarkkitehtuuri Customer- ja Inventory-agenteilla

Oppiminen esimerkkien avulla

📌 Paikalliset vs. ulkoiset esimerkit:
Paikalliset esimerkit (tässä repossa) = Valmiit käytettäväksi heti
Ulkoiset esimerkit (Azure Samples) = Kloonaa linkatuista reposta

Paikalliset esimerkit (Valmiit käytettäväksi)

  • Retail Multi-Agent Solution - Täydellinen tuotantovalmiin toteutus ARM-malleilla
    • Moni-agenttiarkkitehtuuri (Customer + Inventory -agentit)
    • Kattava valvonta ja arviointi
    • Yhden klikkauksen käyttöönotto ARM-mallin kautta

Paikalliset esimerkit - Container-sovellukset (Luvut 2–5)

Kattavat konttikäyttöönottoesimerkit tässä repossa:

  • Container App Examples - Täydellinen opas konttipohjaisiin käyttöönottoihin
    • Simple Flask API - Perus REST-API scale-to-zero -ominaisuudella
    • Microservices Architecture - Tuotantovalmiiksi monipalveluinen käyttöönotto
    • Quick Start, Production ja Advanced -käyttöönottojen mallit
    • Valvonta, turvallisuus ja kustannusoptimoinnin ohjeet

Ulkoiset esimerkit - Yksinkertaiset sovellukset (Luvut 1–2)

Kloonaa nämä Azure Samples -repot päästäksesi alkuun:

Ulkoiset esimerkit - Tietokantaintegraatio (Luku 3-4)

Ulkoiset esimerkit - Kehittyneet mallit (luvut 4-8)

Ulkoiset mallikokoelmat

📚 Oppimateriaalit ja viitteet

Pikaviitteet

  • Command Cheat Sheet - Keskeiset azd-komennot järjestettyinä luvuittain
  • Glossary - Azure- ja azd-terminologia
  • FAQ - Yleisimmät kysymykset järjestettynä oppimislukuittain
  • Study Guide - Kattavat harjoitustehtävät

Käytännön työpajat

  • AI Workshop Lab - Tee tekoälyratkaisuistasi AZD:n avulla otettavissa käyttöön (2-3 hours)
  • Interactive Workshop - 8-moduulinen opastettu harjoitussarja MkDocsilla ja GitHub Codespacesilla
    • Sisältää: Johdanto → Valinta → Vahvistus → Rakenteen purku → Konfigurointi → Mukauttaminen → Purkutoimet → Yhteenveto

Ulkoiset oppimisresurssit

AI-agenttien taidot editorillesi

  • Microsoft Azure Skills on skills.sh - 37 avointa agenttitaitoa Azure AI:lle, Foundrylle, käyttöönotolle, diagnostiikalle, kustannusoptimoinnille ja muille. Asenna ne GitHub Copilotiin, Cursoriin, Claude Codeen tai mihin tahansa tuettuun agenttiin: 
    npx skills add microsoft/github-copilot-for-azure

🔧 Pikainen vianetsintäopas

Yleisimmät aloittelijoiden kohtaamat ongelmat ja nopeita ratkaisuja:

❌ "azd: command not found" 
# Asenna ensin 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

# Varmista asennus
azd version
❌ "No subscription found" or "Subscription not set" 
# Listaa saatavilla olevat tilaukset
az account list --output table

# Aseta oletustilaus
az account set --subscription "<subscription-id-or-name>"

# Aseta AZD-ympäristöä varten
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Tarkista
az account show
❌ "InsufficientQuota" or "Quota exceeded" 
# Kokeile eri Azure-aluetta
azd env set AZURE_LOCATION "westus2"
azd up

# Tai käytä kehityksessä pienempiä SKUja
# Muokkaa infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" fails halfway through 
# Vaihtoehto 1: Puhdista ja yritä uudelleen
azd down --force --purge
azd up

# Vaihtoehto 2: Korjaa vain infrastruktuuri
azd provision

# Vaihtoehto 3: Tarkista yksityiskohtainen tila
azd show

# Vaihtoehto 4: Tarkista lokit Azure Monitorista
azd monitor --logs
❌ "Authentication failed" or "Token expired" 
# Kirjaudu uudelleen AZD:lle
azd auth logout
azd auth login

# Valinnainen: päivitä myös Azure CLI, jos suoritat az-komentoja
az logout
az login

# Tarkista todennus
az account show
❌ "Resource already exists" or naming conflicts 
# AZD luo yksilöllisiä nimiä, mutta jos syntyy ristiriita:
azd down --force --purge

# Sitten yritä uudelleen uudessa ympäristössä
azd env new dev-v2
azd up
❌ Template deployment taking too long

Normaalit odotusajat:

  • Yksinkertainen web-sovellus: 5-10 minuuttia
  • Sovellus tietokannalla: 10-15 minuuttia
  • AI-sovellukset: 15-25 minuuttia (OpenAI:n provisiointi on hidasta)
# Tarkista edistyminen
azd show

# Jos jumissa yli 30 minuuttia, tarkista Azure-portaali:
azd monitor --overview
# Etsi epäonnistuneita käyttöönottoja
❌ "Permission denied" or "Forbidden" 
# Tarkista Azure-roolisi
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Tarvitset vähintään "Contributor"-roolin
# Pyydä Azure-järjestelmänvalvojaasi myöntämään:
# - Contributor (resursseille)
# - User Access Administrator (roolimäärityksiä varten)
❌ Can't find deployed application URL 
# Näytä kaikkien palveluiden päätepisteet
azd show

# Tai avaa Azure-portaali
azd monitor

# Tarkista tietty palvelu
azd env get-values
# Etsi *_URL-muuttujia

📚 Kattavat vianetsintäresurssit

🎓 Kurssin suoritus ja sertifiointi

Edistymisen seuranta

Seuraa oppimisesi edistymistä kunkin luvun kohdalla:

  • Luku 1: Perusteet & nopea aloitus ✅
  • Luku 2: AI-lähtöinen kehitys ✅
  • Luku 3: Konfigurointi & todennus ✅
  • Luku 4: Infrastruktuuri koodina & käyttöönotto ✅
  • Luku 5: Moniagenttiset AI-ratkaisut ✅
  • Luku 6: Ennakkovalidointi & suunnittelu ennen käyttöönottoa ✅
  • Luku 7: Vianetsintä & virheenkorjaus ✅
  • Luku 8: Tuotanto- ja yritysmallit ✅

Oppimisen varmistus

Kun olet suorittanut kunkin luvun, varmista osaamisesi seuraavasti:

  1. Käytännön harjoitus: Suorita luvun käytännön käyttöönotto
  2. Tiedon tarkistus: Käy läpi luvun UKK-osio
  3. Yhteisökeskustelu: Jaa kokemuksesi Azure Discordissa
  4. Seuraava luku: Siirry seuraavalle vaikeustasolle

Kurssin suorittamisen hyödyt

Kun olet suorittanut kaikki luvut, sinulla on:

  • Tuotantokokemus: Olet ottanut käyttöön todellisia AI-sovelluksia Azureen
  • Ammatilliset taidot: Yritysvalmiit käyttöönotto‑taidot
  • Yhteisön tunnustus: Aktiivinen jäsen Azure-kehittäjäyhteisössä
  • Uraedut: Kysytyt AZD- ja AI-käyttöönotto-osaamiset

🤝 Yhteisö & tuki

Hanki apua & tukea

Yhteisön näkemyksiä Microsoft Foundry Discordista

Viimeaikaiset äänestystulokset #Azure-kanavalta:

  • 45% kehittäjistä haluaa käyttää AZD:tä AI-työkuormiin
  • Suurimmat haasteet: Monipalveluiden käyttöönotot, tunnistetietojen hallinta, tuotantovalmius
  • Eniten pyydetyt: AI-spesifiset mallit, vianetsintäoppaat, parhaat käytännöt

Liity yhteisöömme saadaksesi:

  • Jaa AZD + AI -kokemuksiasi ja saa apua
  • Pääsy uusien AI-mallien varhaisiin esikatseluihin
  • Osallistu AI-käyttöönoton parhaiden käytäntöjen kehittämiseen
  • Vaikuta tulevaan AI + AZD -ominaisuuksien kehitykseen

Osallistuminen kurssin kehittämiseen

Olemme iloisia panoksestasi! Lue Osallistumisohjeet saadaksesi lisätietoja:

  • Sisällön parannukset: Paranna olemassa olevia lukuja ja esimerkkejä
  • Uudet esimerkit: Lisää reaalimaailman tilanteita ja malleja
  • Käännökset: Auta ylläpitämään monikielistä tukea
  • Bugiraportit: Paranna tarkkuutta ja selkeyttä
  • Yhteisön käytännöt: Noudata inklusiivisia yhteisöohjeitamme

📄 Kurssin tiedot

Lisenssi

Tämä projekti on lisensoitu MIT-lisenssillä - katso lisätiedot tiedostosta LICENSE.

Muut Microsoftin oppimateriaalit

Tiimimme tuottaa muita kattavia oppimiskursseja:

LangChain

LangChain4j aloittelijoille LangChain.js aloittelijoille LangChain aloittelijoille

Azure / Edge / MCP / Agentit

AZD aloittelijoille Edge AI aloittelijoille MCP aloittelijoille AI Agentit aloittelijoille

Generatiivinen AI -sarja

Generatiivinen AI aloittelijoille Generatiivinen AI (.NET) Generatiivinen AI (Java) Generatiivinen AI (JavaScript)

Perusopinnot

Koneoppiminen aloittelijoille Data-analytiikka aloittelijoille Tekoäly aloittelijoille Kyberturvallisuus aloittelijoille Verkkokehitys aloittelijoille IoT aloittelijoille XR-kehitys aloittelijoille

Copilot-sarja

Copilot tekoälypariohjelmointiin Copilot C#/.NET:lle Copilot-seikkailu

🗺️ Kurssin navigointi

🚀 Valmiina aloittamaan oppimisen?

Aloittelijat: Aloita Luku 1: Perusta & Pika-aloitus
Tekoälykehittäjät: Siirry kohtaan Luku 2: Tekoälylähtöinen kehitys
Kokeneet kehittäjät: Aloita Luku 3: Konfigurointi & Autentikointi

Seuraavat vaiheet: Aloita luku 1 - AZD-perusteet →

Disclaimer: Tämä asiakirja on käännetty käyttäen tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, ota huomioon, että automaattisissa käännöksissä saattaa olla virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäisellä kielellä tulisi pitää virallisena lähteenä. Kriittisten tietojen osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä johtuvista väärinkäsityksistä tai virheellisistä tulkinnoista.