Skip to content

README.md

Latest commit

 

History

History
1060 lines (799 loc) · 54.4 KB

README.md

File metadata and controls

1060 lines (799 loc) · 54.4 KB

AZD za početnike: Strukturirano putovanje učenjem

AZD-for-beginners

GitHub watchers GitHub forks GitHub stars

Azure Discord Microsoft Foundry Discord

Automatski prijevodi (Uvijek ažurirani)

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

Preferirate lokalno kloniranje?

Ovaj repozitorij uključuje prevode na preko 50 jezika što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite 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"

Time dobivate sve što vam treba za dovršetak tečaja s puno bržim preuzimanjem.

🆕 Što je novo u azd danas

Azure Developer CLI je narasla izvan tradicionalnih web aplikacija i API-ja. Danas je azd jedinstveni alat za implementaciju bilo koje aplikacije u Azure—uključujući AI-pokretane aplikacije i inteligentne agente.

Evo što to znači za vas:

  • AI agenti su sada primarni radni zadaci azd-a. Možete inicijalizirati, implementirati i upravljati AI agent projektima koristeći isti tijek rada azd init → azd up koji već poznajete.
  • Integracija s Microsoft Foundry donosi implementaciju modela, hostiranje agenata i konfiguraciju AI servisa izravno u azd ekosustav predložaka.
  • Osnovni tijek rada nije promijenjen. Bilo da implementirate todo aplikaciju, mikrouslugu ili višestruku AI agent rješenje, naredbe su iste.

Ako ste prije koristili azd, podrška za AI je prirodan nastavak—a ne zaseban alat ili napredni tečaj. Ako počinjete iznova, naučit ćete jedan tijek rada koji radi za sve.

🚀 Što je Azure Developer CLI (azd)?

Azure Developer CLI (azd) je komandni alat prilagođen programerima koji olakšava implementaciju aplikacija u Azure. Umjesto ručnog stvaranja i povezivanja desetaka Azure resursa, možete implementirati cijele aplikacije s jednom naredbom.

Čarolija azd up

# Ova jedina naredba radi sve:
# ✅ Stvara sve Azure resurse
# ✅ Konfigurira mrežu i sigurnost
# ✅ Gradi kod vaše aplikacije
# ✅ Raspoređuje na Azure
# ✅ Daje vam radni URL
azd up

To je to! Nema klikanja po Azure Portalu, nema učenja složenih ARM predložaka, nema ručne konfiguracije - samo funkcionalne aplikacije na Azureu.

❓ Azure Developer CLI vs Azure CLI: Koja je razlika?

Ovo je najčešće pitanje koje početnici postavljaju. Evo jednostavnog odgovora:

Značajka Azure CLI (az) Azure Developer CLI (azd)
Svrha Upravljanje pojedinačnim Azure resursima Implementacija kompletnih aplikacija
Način razmišljanja Fokus na infrastrukturi Fokus na aplikaciji
Primjer az webapp create --name myapp... azd up
Krivulja učenja Mora poznavati Azure servise Samo poznajte svoju aplikaciju
Najbolje za DevOps, Infrastruktura Programeri, Prototipiranje

Jednostavna analogija

  • Azure CLI je kao imati sve alate za izgradnju kuće - čekiće, pile, čavle. Možete izgraditi bilo što, ali morate znati graditeljstvo.
  • Azure Developer CLI je kao unajmiti izvođača radova - opišete što želite i on se brine o izgradnji.

Kada koristiti koji alat

Scenarij Koristite ovaj alat
"Želim brzo implementirati svoju web aplikaciju" azd up
"Trebam samo stvoriti račun za pohranu" az storage account create
"Gradim kompletnu AI aplikaciju" azd init --template azure-search-openai-demo
"Trebam debugirati specifični Azure resurs" az resource show
"Želim produkcijsku implementaciju za nekoliko minuta" azd up --environment production

Oni rade zajedno!

AZD koristi Azure CLI ispod haube. Možete koristiti oba:

# Implementirajte svoju aplikaciju pomoću AZD
azd up

# Zatim fino podesite određene resurse pomoću Azure CLI
az webapp config set --name myapp --always-on true

🌟 Pronađite predloške u Awesome AZD

Nemojte počinjati od nule! Awesome AZD je zajednički skup spremnih za implementaciju predložaka:

Resurs Opis
🔗 Awesome AZD Galerija Pregledajte 200+ predložaka s implementacijom jednim klikom
🔗 Pošaljite predložak Doprinesite vlastitim predloškom zajednici
🔗 GitHub Repozitorij Zapratite i istražite izvor

Popularni AI predlošci iz Awesome AZD

# RAG chat s Microsoft Foundry modelima + AI pretraživanje
azd init --template azure-search-openai-demo

# Brza aplikacija za AI chat
azd init --template openai-chat-app-quickstart

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

🎯 Početak u 3 koraka

Prije nego što počnete, provjerite je li vaše računalo spremno za predložak koji želite implementirati:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Ako bilo koja potrebna provjera ne uspije, najprije ispravite problem, a zatim nastavite s brzim startom.

Korak 1: Instalirajte AZD (2 minute)

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: Autentificirajte se za AZD

# Opcionalno ako planirate izravno koristiti Azure CLI naredbe u ovom tečaju
az login

# Potreban za AZD tokove rada
azd auth login

Ako niste sigurni koji vam je potreban, pratite cijeli tijek postavljanja u Instalacija i postavljanje.

Korak 3: Implementirajte svoju prvu aplikaciju

# Inicijalizirajte iz predloška
azd init --template todo-nodejs-mongo

# Postavi na Azure (stvara sve!)
azd up

🎉 To je to! Vaša je aplikacija sada uživo na Azureu.

Čišćenje (Nemojte zaboraviti!)

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

📚 Kako koristiti ovaj tečaj

Ovaj tečaj je dizajniran za postupno učenje - počnite gdje vam je najugodnije i napredujte korak po korak:

Vaše iskustvo Počnite ovdje
Potpuni početnik s Azureom Poglavlje 1: Osnove
Poznajete Azure, novi ste u AZD-u Poglavlje 1: Osnove
Želite implementirati AI aplikacije Poglavlje 2: AI-prvo razvoj
Želite praktičnu radionicu 🎓 Interaktivna radionica - 3-4 sata vođenog laboratorija
Trebate produkcijske obrasce Poglavlje 8: Produkcija i poduzeće

Brzo postavljanje

  1. Forkajte ovaj repozitorij: GitHub forks
  2. Klonirajte ga: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. Potražite pomoć: Azure Discord zajednica

Preferirate lokalno kloniranje?

Ovaj repozitorij uključuje prevode na preko 50 jezika što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite 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'

Time dobivate sve što vam treba za dovršetak tečaja s puno bržim preuzimanjem.

Pregled tečaja

Ovladavajte Azure Developer CLI (azd) kroz strukturirana poglavlja dizajnirana za postupno učenje. Poseban fokus na implementaciju AI aplikacija s Microsoft Foundry integracijom.

Zašto je ovaj tečaj bitan za moderne programere

Prema uvidima Microsoft Foundry Discord zajednice, 45% programera želi koristiti AZD za AI radne zadatke ali nailaze na izazove:

  • Složene AI arhitekture s više servisa
  • Najbolje prakse implementacije AI u produkciju
  • Integracija i konfiguracija Azure AI servisa
  • Optimizacija troškova AI radnih zadataka
  • Rješavanje problema specifičnih za AI implementaciju

Ciljevi učenja

Završetkom ovog strukturiranog tečaja, naučit ćete:

  • Ovladati osnovama AZD-a: osnovni koncepti, instalacija i konfiguracija
  • Implementirati AI aplikacije: koristiti AZD s Microsoft Foundry servisima
  • Implementirati infrastrukturu kao kod: upravljati Azure resursima pomoću Bicep predložaka
  • Otkloniti poteškoće pri implementaciji: riješiti česte probleme i debugirati
  • Optimizirati za produkciju: sigurnost, skaliranje, nadzor i upravljanje troškovima
  • Izgraditi rješenja s više agenata: implementirati složene AI arhitekture

Prije nego što počnete: računi, pristup i pretpostavke

Prije početka poglavlja 1, provjerite imate li sljedeće pripremljeno. Koraci instalacije kasnije u ovom vodiču pretpostavljaju da su ove osnove već riješene.

  • Pretplata na Azure: Možete koristiti postojeću pretplatu s posla ili vlastiti račun, ili kreirati besplatno probno razdoblje za početak.
  • Dozvola za kreiranje Azure resursa: Za većinu vježbi trebali biste imati barem Contributor pristup na ciljanoj pretplati ili grupi resursa. Neki poglavlja također mogu pretpostaviti da možete kreirati grupe resursa, upravljane identitete i RBAC dodjele.
  • GitHub račun: Korisno za raspolaganje repozitorijem, praćenje vlastitih promjena i korištenje GitHub Codespaces za radionicu.
  • Preduvjeti za izvršavanje predložaka: Neki predlošci zahtijevaju lokalne alate kao što su Node.js, Python, Java ili Docker. Pokrenite validator postava prije početka da pravovremeno uočite nedostatak alata.
  • Osnovno poznavanje terminala: Ne morate biti stručnjak, ali trebali biste se osjećati ugodno pri izvršavanju naredbi kao što su git clone, azd auth login i azd up.

Radite u poslovnoj pretplati?
Ako vaš Azure okoliš upravlja administrator, unaprijed potvrdite da možete postavljati resurse u pretplatu ili grupu resursa koju planirate koristiti. Ako ne, zamolite za sandbox pretplatu ili Contributor pristup prije početka.

Novi ste u Azure?
Počnite s vlastitom Azure probnom ili plaćajte prema korištenju na https://aka.ms/azurefreetrial kako biste mogli završiti vježbe do kraja bez čekanja na odobrenja na razini najma.

🗺️ Mapa tečaja: Brza navigacija po poglavljima

Svako poglavlje ima namjenski README s ciljevima učenja, brzim početcima i vježbama:

Poglavlje Tema Lekcije Trajanje Kompleksnost
Poglavlje 1: Temelj Početak AZD Osnove | Instalacija | Prvi projekt 30-45 min ⭐
Poglavlje 2: Razvoj AI-a Aplikacije s fokusom na AI Integracija Foundry | AI agenti | Postavljanje modela | Radionica 1-2 sata ⭐⭐
Poglavlje 3: Konfiguracija Autentifikacija i sigurnost Konfiguracija | Autentifikacija i sigurnost 45-60 min ⭐⭐
Poglavlje 4: Infrastruktura IaC i implementacija Vodič za implementaciju | Provisioning 1-1.5 sati ⭐⭐⭐
Poglavlje 5: Više agenata AI agentska rješenja Scenarij maloprodaje | Koordinacijski obrasci 2-3 sata ⭐⭐⭐⭐
Poglavlje 6: Priprema za implementaciju Planiranje i validacija Preflight provjere | Planiranje kapaciteta | Odabir SKU-a | App Insights 1 sat ⭐⭐
Poglavlje 7: Rješavanje problema Debugiranje i ispravljanje Česti problemi | Debugging | AI problemi 1-1.5 sati ⭐⭐
Poglavlje 8: Produkcija Poslovni obrasci Prakse za produkciju 2-3 sata ⭐⭐⭐⭐
🎓 Radionica Praktični laboratorij Uvod | Odabir | Validacija | Dekonstrukcija | Konfiguracija | Prilagodba | Odbacivanje | Zaključak 3-4 sata ⭐⭐

Ukupno trajanje tečaja: ~10-14 sati | Razina vještina: Početnik → Pripremljen za produkciju

📚 Poglavlja za učenje

Odaberite svoj put učenja prema razini iskustva i ciljevima

🚀 Poglavlje 1: Temelj i brz početak

Preduvjeti: Pretplata na Azure, osnovno znanje komandne linije
Trajanje: 30-45 minuta
Kompleksnost: ⭐

Što ćete naučiti

  • Razumjeti osnove Azure Developer CLI-a
  • Instalirati AZD na svom sustavu
  • Vašu prvu uspješnu implementaciju

Izvori za učenje

Praktične vježbe

# Brza provjera instalacije
azd version

# Postavite svoju prvu aplikaciju
azd init --template todo-nodejs-mongo
azd up

💡 Ishod poglavlja: Uspješno implementirati jednostavnu web aplikaciju na Azure koristeći AZD

✅ Validacija uspjeha:

# Nakon dovršetka poglavlja 1 trebali biste moći:
azd version              # Prikazuje instaliranu verziju
azd init --template todo-nodejs-mongo  # Inicijalizira projekt
azd up                  # Distribuira na Azure
azd show                # Prikazuje URL pokrenute aplikacije
# Aplikacija se otvara u pregledniku i radi
azd down --force --purge  # Čisti resurse

📊 Uloženo vrijeme: 30-45 minuta
📈 Razina vještina nakon: Mogućnost samostalnog postavljanja osnovnih aplikacija

🤖 Poglavlje 2: Razvoj fokusiran na AI (Preporučeno za AI developere)

Preduvjeti: Poglavlje 1 završeno
Trajanje: 1-2 sata
Kompleksnost: ⭐⭐

Što ćete naučiti

  • Integracija Microsoft Foundry s AZD-om
  • Postavljanje AI-pokretanih aplikacija
  • Razumijevanje konfiguracija AI servisa

Izvori za učenje

Praktične vježbe

# Implementirajte svoju prvu AI aplikaciju
azd init --template azure-search-openai-demo
azd up

# Isprobajte dodatne AI predloške
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Ishod poglavlja: Postaviti i konfigurirati AI-chat aplikaciju s RAG mogućnostima

✅ Validacija uspjeha:

# Nakon poglavlja 2, trebali biste moći:
azd init --template azure-search-openai-demo
azd up
# Testirati AI chat sučelje
# Postavljati pitanja i dobivati AI-pokretane odgovore sa izvorima
# Provjeriti radi li integracija pretrage
azd monitor  # Provjeriti prikazuje li Application Insights telemetriju
azd down --force --purge

📊 Uloženo vrijeme: 1-2 sata
📈 Razina vještina nakon: Mogućnost postavljanja i konfiguriranja AI aplikacija spremnih za produkciju
💰 Svijest o troškovima: Razumijevanje troškova razvoja od 80-150$/mjesec, troškova produkcije od 300-3500$/mjesec

💰 Troškovi kod AI implementacija

Razvojno okruženje (procjena 80-150$/mj):

  • Microsoft Foundry modeli (plaćanje po korištenju): 0-50$/mj (ovisno o korištenju tokena)
  • AI pretraživanje (osnovni sloj): 75$/mj
  • Container Apps (potrošnja): 0-20$/mj
  • Pohrana (standardna): 1-5$/mj

Produkcijsko okruženje (procjena 300-3.500+$/mj):

  • Microsoft Foundry modeli (PTU za konzistentne performanse): 3.000+$/mj ILI plaćanje po korištenju s velikim obujmom
  • AI pretraživanje (standardni sloj): 250$/mj
  • Container Apps (dedicirano): 50-100$/mj
  • Application Insights: 5-50$/mj
  • Pohrana (premium): 10-50$/mj

💡 Savjeti za optimizaciju troškova:

  • Koristite besplatni sloj Microsoft Foundry modela za učenje (uključeno 50.000 tokena/mj s Azure OpenAI)
  • Pokrenite azd down za prekid resursa kad ne razvijate aktivno
  • Počnite s potrošnjom po korištenju, PTU koristite samo za produkciju
  • Koristite azd provision --preview za procjenu troškova prije implementacije
  • Omogućite automatsko skaliranje: plaćajte samo za stvarnu upotrebu

Praćenje troškova:

# Provjerite procijenjene mjesečne troškove
azd provision --preview

# Pratite stvarne troškove u Azure portalu
az consumption budget list --resource-group <your-rg>

⚙️ Poglavlje 3: Konfiguracija i autentifikacija

Preduvjeti: Poglavlje 1 završeno
Trajanje: 45-60 minuta
Kompleksnost: ⭐⭐

Što ćete naučiti

  • Konfiguracija i upravljanje okolinama
  • Najbolje prakse za autentifikaciju i sigurnost
  • Imenovanje i organizacija resursa

Izvori za učenje

Praktične vježbe

  • Konfigurirati više okolina (razvojna, testna, produkcija)
  • Postaviti autentifikaciju upravljanim identitetom
  • Implementirati konfiguracije specifične za okoliš

💡 Ishod poglavlja: Upravljajte višestrukim okolinama s pravom autentifikacijom i sigurnošću

🏗️ Poglavlje 4: Infrastruktura kao kod i implementacija

Preduvjeti: Poglavlja 1-3 završena
Trajanje: 1-1.5 sati
Kompleksnost: ⭐⭐⭐

Što ćete naučiti

  • Napredni obrasci implementacije
  • Infrastruktura kao kod s Bicep-om
  • Strategije za provisioning resursa

Izvori za učenje

Praktične vježbe

  • Kreirati prilagođene Bicep predloške
  • Implementirati višeservisne aplikacije
  • Primijeniti strategije plavo-zelene implementacije

💡 Ishod poglavlja: Implementirati složene višeservisne aplikacije koristeći prilagođene infrastrukture

🎯 Poglavlje 5: Više-agentna AI rješenja (Napredno)

Preduvjeti: Poglavlja 1-2 završena
Trajanje: 2-3 sata
Kompleksnost: ⭐⭐⭐⭐

Što ćete naučiti

  • Obrasci arhitekture s više agenata
  • Orkestracija i koordinacija agenata
  • Produkcijski spremne AI implementacije

Izvori za učenje

Praktične vježbe

# Implementirajte kompletno maloprodajno višekwintu rješenje
cd examples/retail-multiagent-arm-template
./deploy.sh

# Istražite konfiguracije agenata
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Ishod poglavlja: Implementirati i upravljati produkcijskim rješenjem AI s više agenata s agentima za korisnike i inventar

🔍 Poglavlje 6: Validacija i planiranje prije implementacije

Preduvjeti: Poglavlje 4 završeno
Trajanje: 1 sat
Kompleksnost: ⭐⭐

Što ćete naučiti

  • Planiranje kapaciteta i provjera resursa
  • Strategije odabira SKU
  • Provjere prije pokretanja i automatizacija

Resursi za učenje

Praktične vježbe

  • Pokretanje skripti za validaciju kapaciteta
  • Optimizacija odabira SKU za trošak
  • Implementacija automatiziranih provjera prije implementacije

💡 Ishod poglavlja: Validirati i optimizirati implementacije prije izvršenja

🚨 Poglavlje 7: Otklanjanje poteškoća i ispravljanje pogrešaka

Preduvjeti: Bilo koje poglavlje o implementaciji završeno
Trajanje: 1-1,5 sati
Složenost: ⭐⭐

Što ćete naučiti

  • Sustavni pristupi ispravljanju pogrešaka
  • Uobičajeni problemi i rješenja
  • Otklanjanje poteškoća specifičnih za AI

Resursi za učenje

Praktične vježbe

  • Dijagnosticiranje neuspjeha implementacije
  • Rješavanje problema s autentifikacijom
  • Otklanjanje pogrešaka povezivanja AI servisa

💡 Ishod poglavlja: Samostalno dijagnosticirati i riješiti uobičajene probleme implementacije

🏢 Poglavlje 8: Obrasci za produkciju i poduzeća

Preduvjeti: Poglavlja 1-4 završena
Trajanje: 2-3 sata
Složenost: ⭐⭐⭐⭐

Što ćete naučiti

  • Strategije implementacije u produkciji
  • Obrasci sigurnosti za poduzeća
  • Praćenje i optimizacija troškova

Resursi za učenje

Praktične vježbe

  • Implementirati obrasce sigurnosti za poduzeća
  • Postaviti opsežno praćenje
  • Implementirati u produkciju s odgovarajućim upravljanjem

💡 Ishod poglavlja: Implementirati aplikacije spremne za poduzeća s potpunim produkcijskim mogućnostima

🎓 Pregled radionice: Praktično iskustvo učenja

⚠️ STATUS RADIONICE: Aktivni razvoj
Materijali radionice trenutno se razvijaju i usavršavaju. Osnovni moduli su funkcionalni, ali neki napredni dijelovi nisu dovršeni. Aktivno radimo na dovršavanju cjelokupnog sadržaja. Prati napredak →

Interaktivni materijali radionice

Kompletno praktično učenje s alatima u pregledniku i vođenim vježbama

Naši materijali radionice pružaju strukturirano, interaktivno iskustvo učenja koje nadopunjuje poglavlja iz kurikuluma gore. Radionica je namijenjena za samostalno učenje i vođene sesije.

🛠️ Značajke radionice

  • Sučelje u pregledniku: Kompletna radionica temeljena na MkDocs-u s pretragom, kopiranjem i temama
  • Integracija GitHub Codespaces: Jednim klikom postavljanje razvojne okoline
  • Strukturirani put učenja: 8 modula vođenih vježbi (ukupno 3-4 sata)
  • Postupna metodologija: Uvod → Odabir → Validacija → Razgradnja → Konfiguracija → Prilagodba → Rastavljanje → Zaključak
  • Interaktivno DevContainer okruženje: Prekonfigurirani alati i ovisnosti

📚 Struktura modula radionice

Radionica slijedi 8-modulnu progresivnu metodologiju koja vodi od otkrića do majstorstva implementacije:

Modul Tema Što ćete raditi Trajanje
0. Uvod Pregled radionice Razumjeti ciljeve učenja, preduvjete i strukturu radionice 15 min
1. Odabir Otkrivanje predložaka Istražiti AZD predloške i odabrati pravi AI predložak za svoj slučaj 20 min
2. Validacija Implementacija i provjera Implementirati predložak pomoću azd up i potvrditi funkcioniranje infrastrukture 30 min
3. Razgradnja Razumjeti strukturu Koristiti GitHub Copilot za istraživanje arhitekture predloška, Bicep datoteka i organizacije koda 30 min
4. Konfiguracija duboko u azure.yaml Savladati konfiguraciju azure.yaml, lifecycle hooks i varijable okoline 30 min
5. Prilagodba Prilagoditi sebi Omogućiti AI pretraživanje, praćenje, evaluaciju i prilagoditi za svoj scenarij 45 min
6. Rastavljanje Očistiti Sigurno ukloniti resurse s azd down --purge 15 min
7. Zaključak Sljedeći koraci Pregledati postignuća, ključne koncepte i nastaviti učenje 15 min

Tijek radionice:

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

🚀 Početak radionice

# Opcija 1: GitHub Codespaces (Preporučeno)
# Kliknite "Code" → "Create codespace on main" u spremištu

# Opcija 2: Lokalni razvoj
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Slijedite upute za postavljanje u workshop/README.md

🎯 Ishodi učenja radionice

Kroz završetak radionice sudionici će:

  • Implementirati AI aplikacije za produkciju: Koristiti AZD s Microsoft Foundry servisima
  • Ovladati višestrukim AI agent arhitekturama: Implementirati koordinirane AI agentske rješenja
  • Primijeniti najbolje prakse sigurnosti: Konfigurirati autentifikaciju i kontrolu pristupa
  • Optimizirati za skaliranje: Dizajnirati isplative i učinkovite implementacije
  • Otklanjati probleme implementacije: Samostalno rješavati uobičajene probleme

📖 Resursi radionice

Idealno za: korporativnu obuku, sveučilišne tečajeve, samostalno učenje i bootcampove za developere.

📖 Dubinski pregled: Mogućnosti AZD-a

Osim osnovnih funkcionalnosti, AZD nudi moćne značajke za produkcijske implementacije:

  • Implementacije temeljene na predlošcima - Koristite unaprijed izrađene predloške za uobičajene obrasce aplikacija
  • Infrastruktura kao kod - Upravljanje Azure resursima koristeći Bicep ili Terraform
  • Integrirani tijekovi rada - Besprijekorno postavljanje, implementacija i praćenje aplikacija
  • Prijateljski nastrojen prema developerima - Optimiziran za produktivnost i iskustvo developera

AZD + Microsoft Foundry: Savršeno za AI implementacije

Zašto AZD za AI rješenja? AZD rješava glavne izazove s kojima se suočavaju AI developeri:

  • AI-spremni predlošci - Pred-konfigurirani predlošci za Microsoft Foundry modele, Cognitive Services i ML workload-e
  • Sigurne AI implementacije - Ugrađeni sigurnosni obrasci za AI servise, API ključeve i krajnje točke modela
  • Proizvodni AI obrasci - Najbolje prakse za skalabilne, isplative AI aplikacije
  • End-to-End AI tijekovi rada - Od razvoja modela do produkcijske implementacije s pravilnim praćenjem
  • Optimizacija troškova - Pametna alokacija resursa i strategije skaliranja za AI workload-e
  • Integracija Microsoft Foundry-ja - Besprijekorna veza s katalogom i krajnjim točkama Microsoft Foundry modela

🎯 Knjižnica predložaka i primjera

Izbor: Microsoft Foundry predlošci

Započnite ovdje ako implementirate AI aplikacije!

Napomena: Ovi predlošci prikazuju različite AI obrasce. Neki su vanjski Azure uzorci, drugi su lokalne implementacije.

Predložak Poglavlje Složenost Servisi Tip
Započni s AI chatom Poglavlje 2 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights Vanjski
Započni s AI agentima Poglavlje 2 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights Vanjski
Azure Search + OpenAI Demo Poglavlje 2 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage Vanjski
OpenAI Chat App Brzi početak Poglavlje 2 ⭐ AzureOpenAI + Container Apps + Application Insights Vanjski
Agent OpenAI Python Prompty Poglavlje 5 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty Vanjski
Contoso Chat RAG Poglavlje 8 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps Vanjski
Retail Multi-Agent Rješenje Poglavlje 5 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB Lokalno

Izbor: Kompletični scenariji učenja

Predlošci aplikacija spremni za produkciju usklađeni s poglavljima za učenje

Predložak Poglavlje Složenost Ključna lekcija
openai-chat-app-quickstart Poglavlje 2 ⭐ Osnovni obrasci AI implementacije
azure-search-openai-demo Poglavlje 2 ⭐⭐ RAG implementacija s Azure AI Search
ai-document-processing Poglavlje 4 ⭐⭐ Integracija obrade dokumenata
agent-openai-python-prompty Poglavlje 5 ⭐⭐⭐ Agent okvir i pozivanje funkcija
contoso-chat Poglavlje 8 ⭐⭐⭐ Orkestracija Enterprise AI
retail-multi-agent-solution Poglavlje 5 ⭐⭐⭐⭐ Višestruka agent arhitektura s Customer i Inventory agentima

Učenje kroz tip primjera

📌 Lokalni vs. Vanjski primjeri:
Lokalni primjeri (u ovom repozitoriju) = Spremni za trenutnu upotrebu
Vanjski primjeri (Azure uzorci) = Klonirati iz povezanih repozitorija

Lokalni primjeri (spremni za upotrebu)

  • Retail Multi-Agent Rješenje - Kompletna produkcijska implementacija s ARM predlošcima
    • Višestruka agentska arhitektura (Customer + Inventory agenti)
    • Opsežno praćenje i evaluacija
    • Jednim klikom postavljanje putem ARM predloška

Lokalni primjeri - Container aplikacije (Poglavlja 2-5)

Kompletni primjeri implementacije kontejnera u ovom spremištu:

Vanjski primjeri - Jednostavne aplikacije (Poglavlja 1-2)

Klonirajte ove Azure uzorke da započnete:

Vanjski primjeri - Integracija baza podataka (Poglavlja 3-4)

Vanjski Primjeri - Napredni Obrasci (Poglavlja 4-8)

Vanjske Kolekcije Predložaka

📚 Resursi za Učenje & Reference

Brzi Reference

Radionice s Praktičnim Radom

  • AI Radionica Laboratorij - Omogućite svoje AI rješenja za AZD implementaciju (2-3 sata)
  • Interaktivna Radionica - 8-modulni vođeni zadaci s MkDocs i GitHub Codespaces
    • Slijedi: Uvod → Odabir → Validacija → Dekonstrukcija → Konfiguracija → Prilagodba → Rastavljanje → Zaključak

Vanjski Resursi za Učenje

Vještine AI Agenta za Tvoj Editor

  • Microsoft Azure Vještine na skills.sh - 37 otvorenih vještina agenta za Azure AI, Foundry, implementaciju, dijagnostiku, optimizaciju troškova i još mnogo toga. Instalirajte ih u GitHub Copilot, Cursor, Claude Code ili bilo kojeg podržanog agenta: 
    npx skills add microsoft/github-copilot-for-azure

🔧 Brzi Vodič za Otklanjanje Problema

Česti problemi s kojima se početnici susreću i brza rješenja:

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

# Provjerite instalaciju
azd version
❌ "Nije pronađena pretplata" ili "Pretplata nije postavljena" 
# Popis dostupnih pretplata
az account list --output table

# Postavi zadanu pretplatu
az account set --subscription "<subscription-id-or-name>"

# Postavi za AZD okruženje
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Provjeri
az account show
❌ "Nedovoljna Kvota" ili "Kvota premašena" 
# Pokušajte različitu Azure regiju
azd env set AZURE_LOCATION "westus2"
azd up

# Ili koristite manje SKU-ove u razvoju
# Uredite infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" prekida se na pola puta 
# Opcija 1: Očistite i pokušajte ponovo
azd down --force --purge
azd up

# Opcija 2: Samo popravite infrastrukturu
azd provision

# Opcija 3: Provjerite detaljni status
azd show

# Opcija 4: Provjerite zapise u Azure Monitoru
azd monitor --logs
❌ "Autentikacija nije uspjela" ili "Token je istekao" 
# Ponovno se autentificirajte za AZD
azd auth logout
azd auth login

# Opcionalno: osvježite i Azure CLI ako koristite az naredbe
az logout
az login

# Provjerite autentifikaciju
az account show
❌ "Resurs već postoji" ili sukobi u imenovanju 
# AZD generira jedinstvena imena, ali ako dođe do sukoba:
azd down --force --purge

# Zatim pokušajte ponovo s novim okruženjem
azd env new dev-v2
azd up
❌ Implementacija predloška traje predugo

Uobičajena vremena čekanja:

  • Jednostavna web aplikacija: 5-10 minuta
  • Aplikacija s bazom podataka: 10-15 minuta
  • AI aplikacije: 15-25 minuta (Provisioning OpenAI-ja je spor)
# Provjeri napredak
azd show

# Ako je zapelo >30 minuta, provjeri Azure Portal:
azd monitor --overview
# Potraži neuspjele implementacije
❌ "Dozvola odbijena" ili "Zabranjeno" 
# Provjerite svoju Azure ulogu
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Potrebna vam je barem uloga "Suradnik"
# Zamolite svog Azure administratora da omogući:
# - Suradnik (za resurse)
# - Administrator pristupa korisnika (za dodjelu uloga)
❌ Ne može se pronaći URL implementirane aplikacije 
# Prikaži sve krajnje točke usluge
azd show

# Ili otvorite Azure Portal
azd monitor

# Provjerite određenu uslugu
azd env get-values
# Potražite *_URL varijable

📚 Potpuni Resursi za Otklanjanje Problema

🎓 Završetak Tečaja & Certifikacija

Praćenje Napretka

Pratite svoj napredak kroz svako poglavlje:

  • Poglavlje 1: Osnove & Brzi Start ✅
  • Poglavlje 2: AI-Prvo Razvijanje ✅
  • Poglavlje 3: Konfiguracija & Autentikacija ✅
  • Poglavlje 4: Infrastruktura kao Kod & Implementacija ✅
  • Poglavlje 5: Višeagentna AI Rješenja ✅
  • Poglavlje 6: Validacija & Planiranje Prije Implementacije ✅
  • Poglavlje 7: Otklanjanje Problema & Debugiranje ✅
  • Poglavlje 8: Proizvodni i Enterprise Obrasci ✅

Provjera Znanja

Nakon završetka svakog poglavlja, provjerite svoje znanje:

  1. Praktična Vježba: Završite poglavlje praktičnom implementacijom
  2. Provjera Znanja: Pregledajte FAQ za svoje poglavlje
  3. Društvena Rasprava: Podijelite iskustvo na Azure Discord-u
  4. Sljedeće Poglavlje: Krenite na sljedeću razinu složenosti

Prednosti Završetka Tečaja

Nakon završetka svih poglavlja, dobit ćete:

  • Iskustvo u Proizvodnji: Implementirane stvarne AI aplikacije na Azure
  • Profesionalne Vještine: Spremnost za enterprise implementaciju
  • Priznanje u Zajednici: Aktivni član Azure developerske zajednice
  • Napredovanje u Karijeri: Potražena AZD i AI stručnost za implementaciju

🤝 Zajednica & Podrška

Dobivanje Pomoći & Podrške

Uvidi Zajednice iz Microsoft Foundry Discorda

Nedavni Rezultati Anketa s #Azure Kanala:

  • 45% developera želi koristiti AZD za AI zadatke
  • Glavni izazovi: Implementacije s više usluga, upravljanje pristupnim podacima, spremnost za produkciju
  • Najtraženije: Predlošci za AI, vodiči za otklanjanje problema, najbolje prakse

Pridružite se našoj zajednici da:

  • Dijelite svoja iskustva s AZD + AI i dobijete pomoć
  • Imate pristup ranim pregledima novih AI predložaka
  • Doprinijete najboljim praksama za AI implementacije
  • Utičete na budući razvoj AI + AZD značajki

Sudjelovanje u Tečaju

Pozivamo vas da doprinesete! Molimo pročitajte naš Vodič za doprinos za detalje o:

  • Poboljšanju sadržaja: Unaprijedite postojeća poglavlja i primjere
  • Novim Primjerima: Dodajte stvarne scenarije i predloške
  • Prijevodu: Pomozite u održavanju podrške za više jezika
  • Izvještavanju o Greškama: Poboljšajte točnost i jasnoću
  • Standardima Zajednice: Slijedite naše smjernice za inkluzivnu zajednicu

📄 Informacije o Tečaju

Licenca

Ovaj projekt licenciran je pod MIT licencom - pogledajte datoteku LICENSE za detalje.

Povezani Microsoft resursi za učenje

Naš tim producira druge sveobuhvatne tečajeve za učenje:

LangChain

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

Azure / Edge / MCP / Agenti

AZD za početnike Edge AI za početnike MCP za početnike AI Agenti za početnike

Serijal Generativnog AI

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

Osnovno Učenje

ML za početnike Data Science for Beginners AI for Beginners Cybersecurity for Beginners Web Dev for Beginners IoT for Beginners XR Development for Beginners

Copilot Serija

Copilot for AI Paired Programming Copilot for C#/.NET Copilot Adventure

🗺️ Navigacija kroz tečaj

🚀 Spremni za početak učenja?

Početnici: Započnite s Poglavlje 1: Osnove i Brzi početak
AI programeri: Preskočite na Poglavlje 2: AI-prvi razvoj
Iskusni programeri: Počnite s Poglavlje 3: Konfiguracija i autentifikacija

Sljedeći koraci: Započnite Poglavlje 1 - Osnove AZD-a →

Odricanje od odgovornosti:
Ovaj dokument je preveden korištenjem AI prevodilačke usluge Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Nismo odgovorni za bilo kakva nesporazuma ili pogrešne interpretacije koje mogu proizaći iz korištenja ovog prijevoda.
⚡