AZD Untuk Pemula: Perjalanan Pembelajaran Berstruktur

Terjemahan Automatik (Sentiasa Dikemaskini)

Lebih Suka Klon Secara Tempatan?

Repositori ini merangkumi lebih daripada 50 terjemahan bahasa yang secara signifikan meningkatkan saiz muat turun. Untuk klon tanpa terjemahan, gunakan 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"
Ini memberikan anda segala yang anda perlukan untuk menyelesaikan kursus dengan muat turun yang lebih pantas.

🆕 Apa Yang Baru di azd Hari Ini

Azure Developer CLI telah berkembang melebihi aplikasi web dan API tradisional. Hari ini, azd adalah alat tunggal untuk menyebarkan mana-mana aplikasi ke Azure—termasuk aplikasi berkuasa AI dan agen pintar.

Ini maksudnya untuk anda:

Agen AI kini adalah beban kerja azd kelas pertama. Anda boleh memulakan, menyebar, dan mengurus projek agen AI menggunakan aliran kerja azd init → azd up yang anda sudah biasa.
Integrasi Microsoft Foundry membawa penyebaran model, penghosan agen, dan konfigurasi perkhidmatan AI terus ke dalam ekosistem templat azd.
Aliran kerja teras tidak berubah. Sama ada anda menyebarkan aplikasi todo, mikroservis, atau penyelesaian AI multi-agen, arahan adalah sama.

Jika anda pernah menggunakan azd sebelum ini, sokongan AI adalah peluasan semula jadi—bukan alat berasingan atau trek lanjutan. Jika anda baru bermula, anda akan belajar satu aliran kerja yang berfungsi untuk segala-galanya.

🚀 Apakah Azure Developer CLI (azd)?

Azure Developer CLI (azd) adalah alat baris arahan mesra pembangun yang memudahkan penyebaran aplikasi ke Azure. Daripada mencipta dan menyambungkan puluhan sumber Azure secara manual, anda boleh menyebarkan keseluruhan aplikasi dengan satu perintah.

Keajaiban `azd up`

# Perintah tunggal ini melakukan semuanya:
# ✅ Mencipta semua sumber Azure
# ✅ Mengkonfigurasi rangkaian dan keselamatan
# ✅ Membina kod aplikasi anda
# ✅ Menerapkan ke Azure
# ✅ Memberi anda URL yang berfungsi
azd up

Itu sahaja! Tiada klik di Azure Portal, tiada templat ARM yang kompleks untuk belajar terlebih dahulu, tiada konfigurasi manual - hanya aplikasi yang berfungsi di Azure.

❓ Azure Developer CLI vs Azure CLI: Apakah Bezanya?

Ini soalan paling biasa ditanya oleh pemula. Berikut jawapan ringkasnya:

Ciri	Azure CLI (`az`)	Azure Developer CLI (`azd`)
Tujuan	Mengurus sumber Azure individu	Menyebarkan aplikasi lengkap
Pemikiran	Fokus pada infrastruktur	Fokus pada aplikasi
Contoh	`az webapp create --name myapp...`	`azd up`
Lengkung Pembelajaran	Perlu tahu perkhidmatan Azure	Cuma tahu aplikasi anda
Terbaik untuk	DevOps, Infrastruktur	Pembangun, Prototip

Analogi Mudah

Azure CLI seperti mempunyai semua alat untuk membina rumah - tukul, gergaji, paku. Anda boleh bina apa saja, tapi anda perlu tahu pembinaan.
Azure Developer CLI seperti mengupah kontraktor - anda terangkan apa yang anda mahu, dan mereka urus pembinaan.

Bila Guna Setiap Satu

Senario	Gunakan Ini
"Saya mahu menyebarkan aplikasi web saya dengan cepat"	`azd up`
"Saya perlu buat akaun storan sahaja"	`az storage account create`
"Saya sedang membina aplikasi AI penuh"	`azd init --template azure-search-openai-demo`
"Saya mahu debug sumber Azure tertentu"	`az resource show`
"Saya mahu penyebaran sedia produksi dalam beberapa minit"	`azd up --environment production`

Mereka Bekerjasama!

AZD menggunakan Azure CLI di bawahnya. Anda boleh gunakan kedua-duanya:

# Sebarkan aplikasi anda dengan AZD
azd up

# Kemudian laraskan sumber tertentu dengan Azure CLI
az webapp config set --name myapp --always-on true

🌟 Cari Templat Dalam Awesome AZD

Jangan mula dari kosong! Awesome AZD adalah koleksi komuniti templat sedia untuk disebarkan:

Sumber	Penerangan
🔗 Galeril Awesome AZD	Layari 200+ templat dengan satu klik penyebaran
🔗 Hantar Templat	Sumbangkan templat anda sendiri kepada komuniti
🔗 Repositori GitHub	Bintang dan terokai sumbernya

Templat AI Popular dari Awesome AZD

# Sembang RAG dengan Model Foundry Microsoft + Carian AI
azd init --template azure-search-openai-demo

# Aplikasi Sembang AI Pantas
azd init --template openai-chat-app-quickstart

# Ejen AI dengan Ejen Foundry
azd init --template get-started-with-ai-agents

🎯 Mula Dalam 3 Langkah

Sebelum anda mula, pastikan mesin anda sudah bersedia untuk templat yang ingin anda sebarkan:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Jika terdapat sebarang pemeriksaan yang gagal, perbaiki yang itu dahulu dan kemudian teruskan dengan permulaan cepat.

Langkah 1: Pasang AZD (2 minit)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

Langkah 2: Autentikasi untuk AZD

# Pilihan jika anda merancang untuk menggunakan arahan Azure CLI secara langsung dalam kursus ini
az login

# Diperlukan untuk aliran kerja AZD
azd auth login

Jika anda tidak pasti yang mana satu anda perlukan, ikuti aliran tetapan penuh dalam Pemasangan & Persediaan.

Langkah 3: Sebarkan Aplikasi Pertama Anda

# Inisialisasi daripada templat
azd init --template todo-nodejs-mongo

# Sebarkan ke Azure (mencipta segala-galanya!)
azd up

🎉 Itu sahaja! Aplikasi anda kini hidup di Azure.

Bersihkan (Jangan Lupa!)

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

📚 Cara Menggunakan Kursus Ini

Kursus ini direka untuk pembelajaran progresif - mulakan di tempat yang anda selesa dan teruskan ke tahap seterusnya:

Pengalaman Anda	Mula Di Sini
Baru dalam Azure	Bab 1: Asas
Tahu Azure, baru dalam AZD	Bab 1: Asas
Mahukan penyebaran aplikasi AI	Bab 2: Pembangunan AI-First
Mahukan latihan praktikal	🎓 Bengkel Interaktif - makmal berpandu 3-4 jam
Perlukan corak produksi	Bab 8: Produksi & Perusahaan

Tetapan Pantas

Fork Repositori Ini:
Klon Ia: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
Dapatkan Bantuan: Azure Discord Community

Lebih Suka Klon Secara Tempatan?

Repositori ini merangkumi lebih daripada 50 terjemahan bahasa yang secara signifikan meningkatkan saiz muat turun. Untuk klon tanpa terjemahan, gunakan 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'
Ini memberikan anda segala yang anda perlukan untuk menyelesaikan kursus dengan muat turun yang lebih pantas.

Gambaran Keseluruhan Kursus

Kuasi Azure Developer CLI (azd) melalui bab berstruktur yang direka untuk pembelajaran progresif. Fokus khusus pada penyebaran aplikasi AI dengan integrasi Microsoft Foundry.

Mengapa Kursus Ini Penting untuk Pembangun Moden

Berdasarkan pandangan komuniti Microsoft Foundry Discord, 45% pembangun mahu menggunakan AZD untuk beban kerja AI tetapi menghadapi cabaran dengan:

Seni bina AI multi-perkhidmatan yang kompleks
Amalan terbaik penyebaran AI produksi
Integrasi dan konfigurasi perkhidmatan Azure AI
Pengoptimuman kos untuk beban kerja AI
Menyelesaikan masalah khusus penyebaran AI

Objektif Pembelajaran

Dengan melengkapkan kursus berstruktur ini, anda akan:

Menguasai Asas AZD: Konsep teras, pemasangan, dan konfigurasi
Menyebarkan Aplikasi AI: Menggunakan AZD dengan perkhidmatan Microsoft Foundry
Melaksanakan Infrastruktur sebagai Kod: Mengurus sumber Azure dengan templat Bicep
Menyelesaikan Masalah Penyebaran: Memperbaiki isu biasa dan debug masalah
Mengoptimumkan untuk Produksi: Keselamatan, penskalaan, pemantauan, dan pengurusan kos
Membina Penyelesaian Multi-Agen: Menyebarkan seni bina AI kompleks

Sebelum Anda Mula: Akaun, Akses, dan Asumsi

Sebelum anda mula Bab 1, pastikan anda mempunyai perkara berikut. Langkah pemasangan dalam panduan ini mengandaikan asas ini telah diuruskan.

Langganan Azure: Anda boleh menggunakan langganan sedia ada dari kerja atau akaun sendiri, atau buat percubaan percuma untuk bermula.
Kebenaran untuk mencipta sumber Azure: Untuk kebanyakan latihan, anda perlu mempunyai akses sekurang-kurangnya Contributor pada langganan atau kumpulan sumber sasaran. Sesetengah bab mungkin juga mengandaikan anda boleh mencipta kumpulan sumber, identiti yang diuruskan, dan tugasan RBAC.
Akaun GitHub: Ini berguna untuk membuat forking repositori, menjejaki perubahan sendiri, dan menggunakan GitHub Codespaces untuk bengkel.
Prasyarat runtime templat: Sesetengah templat memerlukan alat tempatan seperti Node.js, Python, Java, atau Docker. Jalankan validator persediaan sebelum memulakan supaya anda mengesan alat yang hilang awal.
Kemahiran asas terminal: Anda tidak perlu menjadi pakar, tetapi anda perlu selesa menjalankan arahan seperti git clone, azd auth login, dan azd up.

Bekerja dalam langganan perusahaan?
Jika persekitaran Azure anda diuruskan oleh pentadbir, sahkan terlebih dahulu bahawa anda boleh mengedepankan sumber dalam langganan atau kumpulan sumber yang anda rancangkan gunakan. Jika tidak, minta langganan sandbox atau akses Contributor sebelum mula.

Baru dengan Azure?
Mulakan dengan percubaan Azure sendiri atau langganan bayar-semasa penggunaan di https://aka.ms/azurefreetrial supaya anda dapat menyiapkan latihan sepenuhnya tanpa menunggu kelulusan tahap tenant.

🗺️ Peta Kursus: Navigasi Pantas mengikut Bab

Setiap bab mempunyai README khusus dengan objektif pembelajaran, permulaan pantas, dan latihan:

Bab	Topik	Pelajaran	Tempoh	Kerumitan
Bab 1: Asas	Bermula	Asas AZD \| Pemasangan \| Projek Pertama	30-45 min	⭐
Bab 2: Pembangunan AI	Aplikasi AI-Pertama	Integrasi Foundry \| Ejen AI \| Pengedepanan Model \| Bengkel	1-2 jam	⭐⭐
Bab 3: Konfigurasi	Auth & Keselamatan	Konfigurasi \| Auth & Keselamatan	45-60 min	⭐⭐
Bab 4: Infrastruktur	IaC & Pengedepanan	Panduan Pengedepanan \| Penyediaan	1-1.5 jam	⭐⭐⭐
Bab 5: Multi-Ejen	Penyelesaian Ejen AI	Senario Runcit \| Corak Penyelarasan	2-3 jam	⭐⭐⭐⭐
Bab 6: Pra-Pengedepanan	Perancangan & Pengesahan	Pemeriksaan Pra-Pengendalian \| Perancangan Kapasiti \| Pemilihan SKU \| App Insights	1 jam	⭐⭐
Bab 7: Penyelesaian Masalah	Debug & Betulkan	Isu Lazim \| Penyahpepijatan \| Isu AI	1-1.5 jam	⭐⭐
Bab 8: Pengeluaran	Corak Perusahaan	Amalan Pengeluaran	2-3 jam	⭐⭐⭐⭐
🎓 Bengkel	Bengkel Amali	Pengenalan \| Pemilihan \| Pengesahan \| Penderaan \| Konfigurasi \| Pengkhususan \| Pemusnahan \| Penutup	3-4 jam	⭐⭐

Jumlah Durasi Kursus: ~10-14 jam | Kemajuan Kemahiran: Pemula → Sedia Produksi

📚 Bab-Bab Pembelajaran

Pilih laluan pembelajaran berdasarkan tahap pengalaman dan matlamat

🚀 Bab 1: Asas & Permulaan Pantas

Prasyarat: Langganan Azure, pengetahuan asas baris arahan
Tempoh: 30-45 minit
Kerumitan: ⭐

Apa yang Akan Anda Pelajari

Memahami asas Azure Developer CLI
Memasang AZD pada platform anda
Pengedepanan pertama anda yang berjaya

Sumber Pembelajaran

🎯 Mula di Sini: Apa itu Azure Developer CLI?
📖 Teori: Asas AZD - Konsep teras dan terminologi
⚙️ Persediaan: Pemasangan & Persediaan - Panduan khusus platform
🛠️ Amali: Projek Pertama Anda - Tutorial langkah demi langkah
📋 Rujukan Pantas: Senarai Perintah

Latihan Praktikal

# Semakan pemasangan pantas
azd version

# Sebarkan aplikasi pertama anda
azd init --template todo-nodejs-mongo
azd up

💡 Hasil Bab: Berjaya mengedepan aplikasi web mudah ke Azure menggunakan AZD

✅ Pengesahan Kejayaan:

# Selepas menyiapkan Bab 1, anda harus dapat:
azd version              # Menunjukkan versi yang dipasang
azd init --template todo-nodejs-mongo  # Memulakan projek
azd up                  # Mengeluarkan ke Azure
azd show                # Memaparkan URL aplikasi yang sedang berjalan
# Aplikasi dibuka dalam pelayar dan berfungsi
azd down --force --purge  # Membersihkan sumber

📊 Masa Pelaburan: 30-45 minit
📈 Tahap Kemahiran Selepas: Boleh mengedepan aplikasi asas secara berdikari

🤖 Bab 2: Pembangunan AI-Pertama (Disyorkan untuk Pembangun AI)

Prasyarat: Bab 1 selesai
Tempoh: 1-2 jam
Kerumitan: ⭐⭐

Apa yang Akan Anda Pelajari

Integrasi Microsoft Foundry dengan AZD
Pengedepanan aplikasi berasaskan AI
Memahami konfigurasi perkhidmatan AI

Sumber Pembelajaran

🎯 Mula di Sini: Integrasi Microsoft Foundry
🤖 Ejen AI: Panduan Ejen AI - Edapkan ejen pintar dengan AZD
📖 Corak: Pengedepanan Model AI - Edapkan dan urus model AI
🛠️ Bengkel: Bengkel AI - Sediakan solusi AI anda agar sedia AZD
🎥 Panduan Interaktif: Bahan Bengkel - Pembelajaran berasaskan pelayar dengan MkDocs * Persekitaran DevContainer
📋 Templat: Templat Microsoft Foundry
📝 Contoh: Contoh Pengedepanan AZD

Latihan Praktikal

# Lancarkan aplikasi AI pertama anda
azd init --template azure-search-openai-demo
azd up

# Cuba templat AI tambahan
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Hasil Bab: Mengedepan dan mengkonfigurasi aplikasi chat AI dengan keupayaan RAG

✅ Pengesahan Kejayaan:

# Selepas Bab 2, anda sepatutnya boleh:
azd init --template azure-search-openai-demo
azd up
# Uji antara muka sembang AI
# Tanyakan soalan dan dapatkan respons yang dipacu AI dengan sumber
# Sahkan integrasi carian berfungsi
azd monitor  # Semak Application Insights menunjukkan telemetri
azd down --force --purge

📊 Masa Pelaburan: 1-2 jam
📈 Tahap Kemahiran Selepas: Boleh mengedepan dan mengkonfigurasi aplikasi AI sedia produksi
💰 Kesedaran Kos: Faham kos pembangunan $80-150/bulan, kos produksi $300-3500/bulan

💰 Pertimbangan Kos untuk Pengedepanan AI

Persekitaran Pembangunan (Anggaran $80-150/bulan):

Model Microsoft Foundry (Bayar-semasa penggunaan): $0-50/bulan (berdasarkan penggunaan token)
AI Search (Tier asas): $75/bulan
Container Apps (Penggunaan): $0-20/bulan
Penyimpanan (Standard): $1-5/bulan

Persekitaran Pengeluaran (Anggaran $300-3,500+/bulan):

Model Microsoft Foundry (PTU untuk prestasi konsisten): $3,000+/bulan ATAU Bayar-semasa dengan volume tinggi
AI Search (Tier standard): $250/bulan
Container Apps (Didedikasikan): $50-100/bulan
Application Insights: $5-50/bulan
Penyimpanan (Premium): $10-50/bulan

💡 Petua Pengoptimuman Kos:

Gunakan Model Microsoft Foundry Tier Percuma untuk pembelajaran (Azure OpenAI termasuk 50,000 token/bulan)
Jalankan azd down untuk melepaskan sumber apabila tidak mengembangkan secara aktif
Mula dengan pengebilan berasaskan penggunaan, naik taraf ke PTU hanya untuk produksi
Gunakan azd provision --preview untuk menganggarkan kos sebelum pengedepanan
Aktifkan auto-scaling: bayar hanya untuk penggunaan sebenar

Pemantauan Kos:

# Semak anggaran kos bulanan
azd provision --preview

# Pantau kos sebenar dalam Azure Portal
az consumption budget list --resource-group <your-rg>

⚙️ Bab 3: Konfigurasi & Pengesahan

Prasyarat: Bab 1 selesai
Tempoh: 45-60 minit
Kerumitan: ⭐⭐

Apa yang Akan Anda Pelajari

Konfigurasi dan pengurusan persekitaran
Amalan terbaik pengesahan dan keselamatan
Penamaan dan pengorganisasian sumber

Sumber Pembelajaran

📖 Konfigurasi: Panduan Konfigurasi - Persediaan persekitaran
🔐 Keselamatan: Corak pengesahan dan identiti yang diuruskan - Corak pengesahan
📝 Contoh: Contoh Aplikasi Pangkalan Data - Contoh Pangkalan Data AZD

Latihan Praktikal

Konfigurasikan pelbagai persekitaran (dev, staging, prod)
Sediakan pengesahan identiti yang diuruskan
Laksanakan konfigurasi khusus persekitaran

💡 Hasil Bab: Urus pelbagai persekitaran dengan pengesahan dan keselamatan yang betul

🏗️ Bab 4: Infrastruktur sebagai Kod & Pengedepanan

Prasyarat: Bab 1-3 selesai
Tempoh: 1-1.5 jam
Kerumitan: ⭐⭐⭐

Apa yang Akan Anda Pelajari

Corak pengedepanan lanjutan
Infrastruktur sebagai Kod menggunakan Bicep
Strategi penyediaan sumber

Sumber Pembelajaran

📖 Pengedepanan: Panduan Pengedepanan - Aliran kerja lengkap
🏗️ Penyediaan: Penyediaan Sumber - Pengurusan sumber Azure
📝 Contoh: Contoh Aplikasi Container - Pengedepanan berasaskan container

Latihan Praktikal

Cipta templat Bicep tersuai
Edapkan aplikasi pelbagai perkhidmatan
Laksanakan strategi pengedepanan blue-green

💡 Hasil Bab: Mengedepan aplikasi pelbagai perkhidmatan kompleks menggunakan templat infrastruktur tersuai

🎯 Bab 5: Penyelesaian AI Multi-Ejen (Lanjutan)

Prasyarat: Bab 1-2 selesai
Tempoh: 2-3 jam
Kerumitan: ⭐⭐⭐⭐

Apa yang Akan Anda Pelajari

Corak seni bina multi-ejen
Orkestrasi dan penyelarasan ejen
Pengedepanan AI sedia produksi

Sumber Pembelajaran

🤖 Projek Unggulan: Penyelesaian Multi-Ejen Runcit - Pelaksanaan lengkap
🛠️ Templat ARM: Pakej Templat ARM - Pengedepanan satu klik
📖 Seni Bina: Corak penyelarasan multi-ejen - Corak

Latihan Praktikal

# Lancarkan penyelesaian multi-ejen runcit lengkap
cd examples/retail-multiagent-arm-template
./deploy.sh

# Terokai konfigurasi ejen
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Hasil Bab: Mengedepan dan mengurus penyelesaian AI multi-ejen yang sedia produksi dengan ejen Pelanggan dan Inventori

🔍 Bab 6: Pengesahan & Perancangan Pra-Pengedepanan

Prasyarat: Bab 4 selesai
Tempoh: 1 jam
Kerumitan: ⭐⭐

Apa Yang Anda Akan Pelajari

Perancangan kapasiti dan pengesahan sumber
Strategi pemilihan SKU
Pemeriksaan pra-penerbangan dan automasi

Sumber Pembelajaran

📊 Perancangan: Perancangan Kapasiti - Pengesahan sumber
💰 Pemilihan: Pemilihan SKU - Pilihan kos efektif
✅ Pengesahan: Pemeriksaan Pra-penerbangan - Skrip automatik

Latihan Praktikal

Jalankan skrip pengesahan kapasiti
Optimumkan pemilihan SKU untuk kos
Laksanakan pemeriksaan pra-penerbangan automatik

💡 Hasil Bab: Sah dan optimumkan pengeluaran sebelum pelaksanaan

🚨 Bab 7: Penyelesaian Masalah & Debugging

Prasyarat: Bab pengeluaran mana-mana selesai
Tempoh: 1-1.5 jam
Kerumitan: ⭐⭐

Apa Yang Anda Akan Pelajari

Pendekatan sistematik debugging
Masalah biasa dan penyelesaiannya
Penyelesaian masalah khusus AI

Sumber Pembelajaran

🔧 Masalah Biasa: Masalah Biasa - Soalan Lazim dan penyelesaian
🕵️ Debugging: Panduan Debugging - Strategi langkah demi langkah
🤖 Masalah AI: Penyelesaian Masalah Khusus AI - Masalah perkhidmatan AI

Latihan Praktikal

Diagnosa kegagalan pengeluaran
Selesaikan masalah pengesahan
Debug sambungan perkhidmatan AI

💡 Hasil Bab: Diagnosa dan selesaikan sendiri masalah pengeluaran biasa

🏢 Bab 8: Pola Pengeluaran & Perusahaan

Prasyarat: Bab 1-4 selesai
Tempoh: 2-3 jam
Kerumitan: ⭐⭐⭐⭐

Apa Yang Anda Akan Pelajari

Strategi pengeluaran aplikasi
Pola keselamatan perusahaan
Pemantauan dan pengoptimuman kos

Sumber Pembelajaran

🏭 Pengeluaran: Amalan Terbaik AI Pengeluaran - Pola perusahaan
📝 Contoh: Contoh Mikroservis - Seni bina kompleks
📊 Pemantauan: Integrasi Application Insights - Pemantauan

Latihan Praktikal

Laksanakan pola keselamatan perusahaan
Sediakan pemantauan menyeluruh
Keluarkan ke pengeluaran dengan tadbir urus betul

💡 Hasil Bab: Keluarkan aplikasi sedia perusahaan dengan kebolehan pengeluaran penuh

🎓 Gambaran Keseluruhan Bengkel: Pengalaman Pembelajaran Praktikal

⚠️ STATUS BENGKEL: Pembangunan Aktif
Bahan bengkel sedang dibangunkan dan diperbaiki. Modul teras berfungsi, namun beberapa bahagian lanjutan belum lengkap. Kami sedang berusaha menyiapkan semua kandungan. Jejak kemajuan →

Bahan Bengkel Interaktif

Pembelajaran praktikal komprehensif dengan alat berasaskan pelayar dan latihan berpanduan

Bahan bengkel kami menyediakan pengalaman pembelajaran terstruktur dan interaktif yang melengkapkan kurikulum berasaskan bab di atas. Bengkel direka untuk pembelajaran kendiri dan sesi dikendalikan pengajar.

🛠️ Ciri-ciri Bengkel

Antaramuka Berasaskan Pelayar: Bengkel lengkap menggunakan MkDocs dengan fungsi carian, salin, dan tema
Integrasi GitHub Codespaces: Penyediaan persekitaran pembangunan satu klik
Jalur Pembelajaran Terstruktur: 8 modul latihan berpanduan (3-4 jam keseluruhan)
Metodologi Berperingkat: Pengenalan → Pemilihan → Pengesahan → Penguraian → Konfigurasi → Penyesuaian → Penutupan → Ulasan
Persekitaran DevContainer Interaktif: Alat dan pergantungan pra-konfigurasi

📚 Struktur Modul Bengkel

Bengkel mengikuti metodologi berperingkat 8 modul yang membawa anda dari penemuan ke kemahiran pengeluaran:

Modul	Topik	Apa Yang Anda Akan Lakukan	Tempoh
0. Pengenalan	Gambaran Bengkel	Fahami objektif pembelajaran, prasyarat, dan struktur bengkel	15 min
1. Pemilihan	Penemuan Templat	Teroka templat AZD dan pilih templat AI sesuai untuk senario anda	20 min
2. Pengesahan	Keluarkan & Sahkan	Keluarkan templat dengan `azd up` dan sahkan infrastruktur berfungsi	30 min
3. Penguraian	Fahami Struktur	Gunakan GitHub Copilot untuk teroka seni bina templat, fail Bicep, dan organisasi kod	30 min
4. Konfigurasi	Penyelaman azure.yaml	Kuasai konfigurasi `azure.yaml`, lifecycle hooks, dan pembolehubah persekitaran	30 min
5. Penyesuaian	Jadikannya Milik Anda	Aktifkan Pencarian AI, penjejakan, penilaian, dan sesuaikan mengikut senario	45 min
6. Penutupan	Bersihkan	Nyahperuntukkan sumber dengan selamat menggunakan `azd down --purge`	15 min
7. Ulasan	Langkah Seterusnya	Semak pencapaian, konsep utama, dan teruskan perjalanan pembelajaran anda	15 min

Aliran Bengkel:

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

🚀 Memulakan Bengkel

# Pilihan 1: GitHub Codespaces (Disyorkan)
# Klik "Code" → "Create codespace on main" dalam repositori

# Pilihan 2: Pembangunan Tempatan
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Ikuti arahan penyediaan dalam workshop/README.md

🎯 Hasil Pembelajaran Bengkel

Dengan menyiapkan bengkel, peserta akan:

Keluarkan Aplikasi AI Pengeluaran: Gunakan AZD dengan perkhidmatan Microsoft Foundry
Kuasa Seni Bina Multi-Ejen: Laksanakan penyelesaian ejen AI terkoordinasi
Laksanakan Amalan Keselamatan Terbaik: Konfigurasi pengesahan dan kawalan akses
Optimumkan Skala: Reka bentuk pengeluaran kos efektif dan berprestasi
Selesaikan Masalah Pengeluaran: Tetapkan isu biasa secara berdikari

📖 Sumber Bengkel

🎥 Panduan Interaktif: Bahan Bengkel - Persekitaran pembelajaran berasaskan pelayar
📋 Arahan Modul demi Modul:
- 0. Pengenalan - Gambaran bengkel dan objektif
- 1. Pemilihan - Cari dan pilih templat AI
- 2. Pengesahan - Keluarkan dan sahkan templat
- 3. Penguraian - Teroka seni bina templat
- 4. Konfigurasi - Kuasai azure.yaml
- 5. Penyesuaian - Sesuaikan mengikut senario
- 6. Penutupan - Bersihkan sumber
- 7. Ulasan - Semak dan langkah seterusnya
🛠️ Makmal AI Bengkel: Makmal AI Bengkel - Latihan fokus AI
💡 Mula Cepat: Panduan Persediaan Bengkel - Konfigurasi persekitaran

Sesuai untuk: Latihan korporat, kursus universiti, pembelajaran kendiri, dan bootcamp pembangun.

📖 Penyelaman Mendalam: Kebolehan AZD

Selain asas, AZD menyediakan ciri-ciri hebat untuk pengeluaran:

Pengeluaran berasaskan templat - Gunakan templat siap untuk pola aplikasi biasa
Infrastruktur sebagai Kod - Urus sumber Azure menggunakan Bicep atau Terraform
Aliran kerja bersepadu - Penyediaan, pengeluaran, dan pemantauan aplikasi lancar
Mesra pembangun - Dioptimumkan untuk produktiviti dan pengalaman pembangun

AZD + Microsoft Foundry: Sempurna untuk Pengeluaran AI

Mengapa AZD untuk Penyelesaian AI? AZD menangani cabaran utama pembangun AI:

Templat Sedia AI - Templat pra-konfigurasi untuk Model Microsoft Foundry, Perkhidmatan Kognitif, dan beban kerja ML
Pengeluaran AI Selamat - Pola keselamatan terbina dalam untuk perkhidmatan AI, kunci API, dan titik akhir model
Pola AI Pengeluaran - Amalan terbaik untuk pengeluaran aplikasi AI yang skala dan kos efektif
Aliran Kerja AI Menyeluruh - Dari pembangunan model ke pengeluaran dengan pemantauan betul
Pengoptimuman Kos - Strategi alokasi sumber dan penskalaan pintar untuk beban kerja AI
Integrasi Microsoft Foundry - Sambungan lancar ke katalog model dan titik akhir Microsoft Foundry

🎯 Perpustakaan Templat & Contoh

Sorotan: Templat Microsoft Foundry

Mula di sini jika anda mengeluarkan aplikasi AI!

Nota: Templat ini menunjukkan pelbagai pola AI. Ada yang contoh Azure luaran, ada pula pelaksanaan tempatan.

Templat	Bab	Kerumitan	Perkhidmatan	Jenis
Mulakan dengan AI chat	Bab 2	⭐⭐	AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights	Luaran
Mulakan dengan agen AI	Bab 2	⭐⭐	Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights	Luaran
Demo Azure Search + OpenAI	Bab 2	⭐⭐	AzureOpenAI + Azure AI Search + App Service + Storage	Luaran
Mula cepat Apl Chat OpenAI	Bab 2	⭐	AzureOpenAI + Container Apps + Application Insights	Luaran
Agent OpenAI Python Prompty	Bab 5	⭐⭐⭐	AzureOpenAI + Azure Functions + Prompty	Luaran
Contoso Chat RAG	Bab 8	⭐⭐⭐⭐	AzureOpenAI + AI Search + Cosmos DB + Container Apps	Luaran
Penyelesaian Multi-Ejen Runcit	Bab 5	⭐⭐⭐⭐	AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB	Tempatan

Sorotan: Senario Pembelajaran Lengkap

Templat aplikasi sedia pengeluaran dipetakan ke bab pembelajaran

Templat	Bab Pembelajaran	Kerumitan	Pembelajaran Utama
openai-chat-app-quickstart	Bab 2	⭐	Pola pengeluaran AI asas
azure-search-openai-demo	Bab 2	⭐⭐	Pelaksanaan RAG dengan Azure AI Search
ai-document-processing	Bab 4	⭐⭐	Integrasi Kecerdasan Dokumen
agent-openai-python-prompty	Bab 5	⭐⭐⭐	Rangka kerja agen dan panggilan fungsi
contoso-chat	Bab 8	⭐⭐⭐	Orkestrasi AI perusahaan
retail-multi-agent-solution	Bab 5	⭐⭐⭐⭐	Seni bina multi-ejen dengan agen Pelanggan dan Inventori

Pembelajaran Mengikut Jenis Contoh

📌 Contoh Tempatan vs Luaran:
Contoh Tempatan (dalam repo ini) = Sedia guna segera
Contoh Luaran (Azure Samples) = Klon dari repositori pautan

Contoh Tempatan (Sedia guna)

Penyelesaian Multi-Ejen Runcit - Pelaksanaan lengkap sedia pengeluaran dengan templat ARM
- Seni bina multi-ejen (agen Pelanggan + Inventori)
- Pemantauan dan penilaian menyeluruh
- Pengeluaran satu klik menggunakan templat ARM

Contoh Tempatan - Aplikasi Kontena (Bab 2-5)

Contoh pengeluaran kontena komprehensif dalam repositori ini:

Contoh Aplikasi Kontena - Panduan lengkap ke pengeluaran berasaskan kontena
- API Flask Mudah - API REST asas dengan skala-ke-nol
- Seni Bina Mikroservis - Pengeluaran perkhidmatan pelbagai sedia produksi
- Pola pengeluaran Mula Cepat, Pengeluaran, dan Lanjutan
- Panduan pemantauan, keselamatan, dan pengoptimuman kos

Contoh Luaran - Aplikasi Mudah (Bab 1-2)

Klon repositori Azure Samples berikut untuk mula:

Apl Web Mudah - Node.js + MongoDB - Pola pengeluaran asas
Laman Statik - React SPA - Pengeluaran kandungan statik
Aplikasi Kontena - Python Flask - Pengeluaran API REST

Contoh Luaran - Integrasi Pangkalan Data (Bab 3-4)

Aplikasi Pangkalan Data - C# + SQL - Corak sambungan pangkalan data
Fungsi + Cosmos DB - Aliran kerja data tanpa pelayan

Contoh Luaran - Corak Lanjutan (Bab 4-8)

Mikroservis Java - Seni bina perkhidmatan berganda
Tugas Aplikasi Bekas - Pemprosesan latar belakang
Saluran ML Perusahaan - Corak ML sedia produksi

Koleksi Templat Luaran

Galeri Templat Rasmi AZD - Koleksi templat rasmi dan komuniti yang terpilih
Templat Azure Developer CLI - Dokumentasi templat Microsoft Learn
Direktori Contoh - Contoh pembelajaran tempatan dengan penjelasan terperinci

📚 Sumber Pembelajaran & Rujukan

Rujukan Pantas

Lembaran Panduan Perintah - Perintah azd penting disusun mengikut bab
Glosari - Terminologi Azure dan azd
Soalan Lazim - Soalan umum disusun mengikut bab pembelajaran
Panduan Kajian - Latihan amali menyeluruh

Bengkel Praktikal

Makmal Bengkel AI - Jadikan penyelesaian AI anda boleh diterapkan dengan AZD (2-3 jam)
Bengkel Interaktif - Latihan berpandu 8 modul dengan MkDocs dan GitHub Codespaces
- Mengikuti: Pengenalan → Pemilihan → Pengesahan → Dekonstruksi → Konfigurasi → Penyesuaian → Pembongkaran → Penutup

Sumber Pembelajaran Luaran

Dokumentasi Azure Developer CLI
Pusat Seni Bina Azure
Kalkulator Harga Azure
Status Azure

Kemahiran Ejen AI untuk Penyunting Anda

Kemahiran Microsoft Azure di skills.sh - 37 kemahiran ejen terbuka untuk Azure AI, Foundry, penyebaran, diagnostik, pengoptimuman kos, dan banyak lagi. Pasang dalam GitHub Copilot, Cursor, Claude Code, atau mana-mana ejen yang disokong:
```
npx skills add microsoft/github-copilot-for-azure
```

🔧 Panduan Penyelesaian Masalah Pantas

Isu biasa yang dihadapi pemula dan penyelesaian segera:

❌ "azd: command not found"

# Pasang AZD terlebih dahulu
# Windows (PowerShell):
winget install microsoft.azd

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

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

# Sahkan pemasangan
azd version

❌ "No subscription found" atau "Subscription not set"

# Senaraikan langganan yang tersedia
az account list --output table

# Tetapkan langganan lalai
az account set --subscription "<subscription-id-or-name>"

# Tetapkan untuk persekitaran AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Sahkan
az account show

❌ "InsufficientQuota" atau "Quota exceeded"

# Cuba wilayah Azure yang berbeza
azd env set AZURE_LOCATION "westus2"
azd up

# Atau gunakan SKU yang lebih kecil dalam pembangunan
# Sunting infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}

❌ "azd up" gagal di tengah jalan

# Pilihan 1: Bersihkan dan cuba semula
azd down --force --purge
azd up

# Pilihan 2: Betulkan infrastruktur sahaja
azd provision

# Pilihan 3: Semak status terperinci
azd show

# Pilihan 4: Semak log dalam Azure Monitor
azd monitor --logs

❌ "Authentication failed" atau "Token expired"

# Sahkan semula untuk AZD
azd auth logout
azd auth login

# Pilihan: segarkan juga Azure CLI jika anda menjalankan arahan az
az logout
az login

# Sahkan pengesahan
az account show

❌ "Resource already exists" atau konflik penamaan

# AZD menjana nama unik, tetapi jika berlaku konflik:
azd down --force --purge

# Kemudian cuba semula dengan persekitaran baru
azd env new dev-v2
azd up

❌ Penyebaran templat mengambil masa terlalu lama

Masa menunggu biasa:

Aplikasi web mudah: 5-10 minit
Aplikasi dengan pangkalan data: 10-15 minit
Aplikasi AI: 15-25 minit (penyediaan OpenAI lambat)

# Semak kemajuan
azd show

# Jika tersekat >30 minit, semak Portal Azure:
azd monitor --overview
# Cari penempatan yang gagal

❌ "Permission denied" atau "Forbidden"

# Semak peranan Azure anda
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Anda memerlukan sekurang-kurangnya peranan "Contributor"
# Minta pentadbir Azure anda untuk memberi:
# - Contributor (untuk sumber)
# - User Access Administrator (untuk penugasan peranan)

❌ Tidak dapat mencari URL aplikasi yang diterapkan

# Tunjukkan semua titik akhir perkhidmatan
azd show

# Atau buka Portal Azure
azd monitor

# Semak perkhidmatan tertentu
azd env get-values
# Cari pembolehubah *_URL

📚 Sumber Penyelesaian Masalah Penuh

Panduan Isu Umum: Penyelesaian Terperinci
Isu Khusus AI: Penyelesaian Masalah AI
Panduan Penyahpepijatan: Penyahpepijatan Langkah demi Langkah
Dapatkan Bantuan: Azure Discord #azure-developer-cli

🎓 Penyiapan Kursus & Pensijilan

Penjejakan Kemajuan

Jejaki kemajuan pembelajaran anda melalui setiap bab:

Bab 1: Asas & Mula Pantas ✅
Bab 2: Pembangunan AI-Pertama ✅
Bab 3: Konfigurasi & Pengesahan ✅
Bab 4: Infrastruktur sebagai Kod & Penyebaran ✅
Bab 5: Penyelesaian AI Ejen Berganda ✅
Bab 6: Pengesahan & Perancangan Pra-Penyebaran ✅
Bab 7: Penyelesaian Masalah & Penyahpepijatan ✅
Bab 8: Corak Produksi & Perusahaan ✅

Pengesahan Pembelajaran

Selepas menyiapkan setiap bab, sahkan pengetahuan anda dengan:

Latihan Praktikal: Selesaikan penyebaran praktikal bab tersebut
Semakan Pengetahuan: Tinjau bahagian FAQ untuk bab anda
Perbincangan Komuniti: Kongsi pengalaman anda di Azure Discord
Bab Seterusnya: Beralih ke tahap kerumitan berikutnya

Faedah Penyiapan Kursus

Apabila menyiapkan semua bab, anda akan mempunyai:

Pengalaman Produksi: Menerapkan aplikasi AI sebenar ke Azure
Kemahiran Profesional: Keupayaan penyebaran sedia perusahaan
Pengiktirafan Komuniti: Ahli aktif komuniti pemaju Azure
Kemajuan Kerjaya: Kepakaran AZD dan penyebaran AI yang diperlukan

🤝 Komuniti & Sokongan

Dapatkan Bantuan & Sokongan

Isu Teknikal: Laporkan pepijat dan minta ciri
Soalan Pembelajaran: Komuniti Discord Microsoft Azure dan
Bantuan Khusus AI: Sertai
Dokumentasi: Dokumentasi rasmi Azure Developer CLI

Wawasan Komuniti dari Microsoft Foundry Discord

Hasil Tinjauan Terkini dari Saluran #Azure:

45% pemaju mahu menggunakan AZD untuk beban kerja AI
Cabaran utama: Penyebaran perkhidmatan berganda, pengurusan kelayakan, kesiapsiagaan produksi
Permintaan tertinggi: Templat khusus AI, panduan penyelesaian masalah, amalan terbaik

Sertai komuniti kami untuk:

Kongsi pengalaman AZD + AI anda dan dapatkan bantuan
Akses pratonton awal templat baru AI
Menyumbang kepada amalan terbaik penyebaran AI
Mempengaruhi pembangunan ciri AI + AZD masa depan

Menyumbang kepada Kursus

Kami mengalu-alukan sumbangan! Sila baca Panduan Menyumbang kami untuk maklumat mengenai:

Penambahbaikan Kandungan: Memperbaiki bab dan contoh sedia ada
Contoh Baru: Tambah senario dan templat dunia sebenar
Terjemahan: Bantu mengekalkan sokongan pelbagai bahasa
Laporan Pepijat: Tingkatkan ketepatan dan kejelasan
Standard Komuniti: Ikuti garis panduan komuniti inklusif kami

📄 Maklumat Kursus

Lesen

Projek ini dilesenkan di bawah Lesen MIT - lihat fail LICENSE untuk butiran.

Sumber Pembelajaran Berkaitan Microsoft

Pasukan kami menghasilkan kursus pembelajaran menyeluruh lain:

LangChain

Azure / Edge / MCP / Ejen

Siri AI Generatif

Pembelajaran Teras

Siri Copilot

🗺️ Navigasi Kursus

🚀 Sedia untuk Mula Belajar?

Pemula: Mulakan dengan Bab 1: Asas & Mula Pantas
Pembangun AI: Teruskan ke Bab 2: Pembangunan AI-Utama
Pembangun Berpengalaman: Mulakan dengan Bab 3: Konfigurasi & Pengesahan

Langkah Seterusnya: Mulakan Bab 1 - Asas AZD →

Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk ketepatan, sila ambil maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

AZD Untuk Pemula: Perjalanan Pembelajaran Berstruktur

Terjemahan Automatik (Sentiasa Dikemaskini)

🆕 Apa Yang Baru di azd Hari Ini

🚀 Apakah Azure Developer CLI (azd)?

Keajaiban azd up

❓ Azure Developer CLI vs Azure CLI: Apakah Bezanya?

Analogi Mudah

Bila Guna Setiap Satu

Mereka Bekerjasama!

🌟 Cari Templat Dalam Awesome AZD

Templat AI Popular dari Awesome AZD

🎯 Mula Dalam 3 Langkah

Langkah 1: Pasang AZD (2 minit)

Langkah 2: Autentikasi untuk AZD

Langkah 3: Sebarkan Aplikasi Pertama Anda

Bersihkan (Jangan Lupa!)

📚 Cara Menggunakan Kursus Ini

Tetapan Pantas

Gambaran Keseluruhan Kursus

Mengapa Kursus Ini Penting untuk Pembangun Moden

Objektif Pembelajaran

Sebelum Anda Mula: Akaun, Akses, dan Asumsi

🗺️ Peta Kursus: Navigasi Pantas mengikut Bab

📚 Bab-Bab Pembelajaran

🚀 Bab 1: Asas & Permulaan Pantas

Apa yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktikal

🤖 Bab 2: Pembangunan AI-Pertama (Disyorkan untuk Pembangun AI)

Apa yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktikal

💰 Pertimbangan Kos untuk Pengedepanan AI

⚙️ Bab 3: Konfigurasi & Pengesahan

Apa yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktikal

🏗️ Bab 4: Infrastruktur sebagai Kod & Pengedepanan

Apa yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktikal

🎯 Bab 5: Penyelesaian AI Multi-Ejen (Lanjutan)

Apa yang Akan Anda Pelajari

Sumber Pembelajaran

Latihan Praktikal

🔍 Bab 6: Pengesahan & Perancangan Pra-Pengedepanan

Apa Yang Anda Akan Pelajari

Sumber Pembelajaran

Latihan Praktikal

🚨 Bab 7: Penyelesaian Masalah & Debugging

Apa Yang Anda Akan Pelajari

Sumber Pembelajaran

Latihan Praktikal

🏢 Bab 8: Pola Pengeluaran & Perusahaan

Apa Yang Anda Akan Pelajari

Sumber Pembelajaran

Latihan Praktikal

🎓 Gambaran Keseluruhan Bengkel: Pengalaman Pembelajaran Praktikal

Bahan Bengkel Interaktif

🛠️ Ciri-ciri Bengkel

📚 Struktur Modul Bengkel

🚀 Memulakan Bengkel

🎯 Hasil Pembelajaran Bengkel

📖 Sumber Bengkel

📖 Penyelaman Mendalam: Kebolehan AZD

AZD + Microsoft Foundry: Sempurna untuk Pengeluaran AI

🎯 Perpustakaan Templat & Contoh

Sorotan: Templat Microsoft Foundry

Sorotan: Senario Pembelajaran Lengkap

Pembelajaran Mengikut Jenis Contoh

Contoh Tempatan (Sedia guna)

Contoh Tempatan - Aplikasi Kontena (Bab 2-5)

Contoh Luaran - Aplikasi Mudah (Bab 1-2)

Contoh Luaran - Integrasi Pangkalan Data (Bab 3-4)

Keajaiban `azd up`