Skip to content

README.md

Latest commit

 

History

History
1058 lines (801 loc) · 50.1 KB

README.md

File metadata and controls

1058 lines (801 loc) · 50.1 KB

AZD 初學者入門：有結構的學習旅程

AZD 初學者入門

GitHub 觀察者 GitHub 派生 GitHub 星標

Azure Discord Microsoft Foundry Discord

自動翻譯（隨時保持最新）

阿拉伯語 | 孟加拉語 | 保加利亞語 | 緬甸語 (Myanmar) | 中文（簡體） | 中文（繁體，香港） | 中文（繁體，澳門） | 中文（繁體，台灣） | 克羅地亞語 | 捷克語 | 丹麥語 | 荷蘭語 | 愛沙尼亞語 | 芬蘭語 | 法語 | 德語 | 希臘語 | 希伯來語 | 印地語 | 匈牙利語 | 印度尼西亞語 | 義大利語 | 日語 | 卡納達語 | 高棉語 | 韓語 | 立陶宛語 | 馬來語 | 馬拉雅拉姆語 | 馬拉地語 | 尼泊爾語 | 奈及利亞皮欽語 | 挪威語 | 波斯語（法爾西） | 波蘭語 | 葡萄牙語（巴西） | 葡萄牙語（葡萄牙） | 旁遮普語（Gurmukhi） | 羅馬尼亞語 | 俄語 | 塞爾維亞語（西里爾字母） | 斯洛伐克語 | 斯洛文尼亞語 | 西班牙語 | 斯瓦希里語 | 瑞典語 | 他加祿語（菲律賓語） | 泰米爾語 | 泰盧固語 | 泰語 | 土耳其語 | 烏克蘭語 | 烏都語 | 越南語

想要本機複製倉庫？

此儲存庫包含 50+ 種語言的翻譯檔，會顯著增加下載大小。若要在不下載翻譯的情況下複製，請使用稀疏簽出（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"

這樣可以讓你以更快的下載速度取得完成課程所需的所有內容。

🆕 今天 azd 有什麼新功能

Azure Developer CLI 已經超越傳統的 Web 應用與 API。如今，azd 是部署各類應用至 Azure 的單一工具 —— 包括以 AI 驅動的應用與智慧代理。

這對你的意義如下：

  • AI 代理現在是 azd 的一級工作負載。 你可以使用熟悉的 azd init → azd up 工作流程來初始化、部署和管理 AI 代理專案。
  • Microsoft Foundry 整合 將模型部署、代理託管和 AI 服務設定直接納入 azd 範本生態系統。
  • 核心工作流程沒有改變。 無論你部署的是待辦清單應用、微服務或多代理 AI 解決方案，指令都是一樣的。

如果你以前用過 azd，AI 支援是自然延伸，而不是另一個工具或進階心得。如果你是第一次接觸，你會學會一套適用於所有情境的工作流程。

🚀 什麼是 Azure Developer CLI (azd)？

Azure Developer CLI (azd) 是一個對開發者友好的命令列工具，使部署應用到 Azure 更為簡單。你可以不用手動建立和串接數十個 Azure 資源，只需一個指令就能部署整個應用程式。

azd up 的魔力

# 呢條單一指令完成所有工作：
# ✅ 建立所有 Azure 資源
# ✅ 配置網絡及安全性
# ✅ 建構你的應用程式代碼
# ✅ 部署到 Azure
# ✅ 提供你可用嘅 URL
azd up

就這樣！ 不需要點擊 Azure 入口網站，不需要先學習複雜的 ARM 範本，也不需要手動設定 —— 只要把應用程式部署到 Azure 上運行。

❓ Azure Developer CLI 與 Azure CLI：有什麼不同？

這是初學者最常問的問題。簡單回答如下：

Feature Azure CLI (az) Azure Developer CLI (azd)
目的 管理單一 Azure 資源 部署完整應用程式
思維模式 基礎設施為主 應用程式為主
範例 az webapp create --name myapp... azd up
學習曲線 需了解 Azure 各項服務 只要了解你的應用程式
適合對象 DevOps、基礎設施工程師 開發者、原型設計

簡單類比

  • Azure CLI 就像擁有建房子的所有工具 —— 錘子、鋸子、釘子。你可以建任何東西，但你得懂施工。
  • Azure Developer CLI 就像請了承包商 —— 你描述想要的，他們處理建造。

何時使用哪一個

情境 使用這個
「我想快速部署我的 web 應用」 azd up
「我只需要建立一個儲存帳號」 az storage account create
「我要建立完整的 AI 應用」 azd init --template azure-search-openai-demo
「我需要除錯特定的 Azure 資源」 az resource show
「我想在幾分鐘內完成生產就緒的部署」 azd up --environment production

它們可以一起使用！

AZD 在底層使用 Azure CLI。你可以同時使用兩者：

# 使用 AZD 部署你的應用程式
azd up

# 然後使用 Azure CLI 微調特定資源
az webapp config set --name myapp --always-on true

🌟 在 Awesome AZD 找到範本

不用從零開始！Awesome AZD 是社群彙整的即用型範本集：

資源 說明
🔗 Awesome AZD Gallery 瀏覽 200+ 範本並一鍵部署
🔗 Submit a Template 向社群貢獻你的範本
🔗 GitHub Repository 按星號並探索原始碼

Awesome AZD 熱門的 AI 範本

# 與 Microsoft Foundry 模型 + AI 搜尋的 RAG 聊天
azd init --template azure-search-openai-demo

# 快速 AI 聊天應用程式
azd init --template openai-chat-app-quickstart

# 使用 Foundry 代理的 AI 代理
azd init --template get-started-with-ai-agents

🎯 以 3 個步驟快速開始

開始之前，請確保你的機器已為你想部署的範本做好準備：

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

如果任何必要檢查未通過，請先修正再繼續快速開始流程。

第 1 步：安裝 AZD（2 分鐘）

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

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

第 2 步：為 AZD 驗證身分

# 如果您計劃在本課程中直接使用 Azure CLI 命令，則此項為可選
az login

# 對於 AZD 工作流程是必需的
azd auth login

如果你不確定需要哪一個驗證方式，請依照 Installation & Setup 中的完整設定流程。

第 3 步：部署你的第一個應用程式

# 從範本初始化
azd init --template todo-nodejs-mongo

# 部署到 Azure（會建立所有東西！）
azd up

🎉 就完成了！ 你的應用程式現在已在 Azure 上線。

清理（別忘了！）

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

📚 如何使用本課程

本課程以「漸進式學習」設計 —— 從你熟悉的地方開始，逐步往上學習：

你的經驗 從這裡開始
完全沒接觸過 Azure Chapter 1: Foundation
懂 Azure，但不熟 AZD Chapter 1: Foundation
想部署 AI 應用 Chapter 2: AI-First Development
想要實作練習 🎓 Interactive Workshop - 3-4 小時的實作實驗
需要生產級範式 Chapter 8: Production & Enterprise

快速設定

  1. 派生此儲存庫（Fork）: GitHub 派生
  2. 複製此儲存庫: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
  3. 尋求幫助: Azure Discord 社群

想要本機複製倉庫？

此儲存庫包含 50+ 種語言的翻譯檔，會顯著增加下載大小。若要在不下載翻譯的情況下複製，請使用稀疏簽出（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'

這樣可以讓你以更快的下載速度取得完成課程所需的所有內容。

課程概覽

透過有結構的章節掌握 Azure Developer CLI (azd)，課程設計為漸進式學習。特別強調 Microsoft Foundry 整合下的 AI 應用部署。

為什麼這門課對現代開發者至關重要

根據 Microsoft Foundry Discord 社群的洞察，45% 的開發者想使用 AZD 來處理 AI 工作負載，但會遇到以下挑戰：

  • 複雜的多服務 AI 架構
  • 生產環境 AI 部署的最佳實踐
  • Azure AI 服務的整合與設定
  • AI 工作負載的成本優化
  • 排查 AI 特有的部署問題

學習目標

完成本結構化課程後，你將能：

  • 掌握 AZD 基礎：核心概念、安裝與設定
  • 部署 AI 應用：使用 AZD 與 Microsoft Foundry 服務
  • 實現基礎設施即程式碼：使用 Bicep 範本管理 Azure 資源
  • 排除部署問題：解決常見問題並進行除錯
  • 為生產環境優化：安全性、擴展性、監控與成本管理
  • 構建多代理解決方案：部署複雜的 AI 架構

在開始之前：帳戶、存取與假設

在開始第 1 章之前，請確保你已準備好以下項目。本指南後續的安裝步驟假設這些基礎已經處理完成。

  • Azure 訂閱：你可以使用公司或你自己的現有訂閱，或建立一個 free trial 開始使用。
  • 建立 Azure 資源的權限：對於大多數練習，你應至少在目標訂閱或資源群組擁有 Contributor 存取權。一些章節也可能假設你可以建立資源群組、託管身分識別，以及 RBAC 指派。
  • 一個 GitHub 帳戶：這對 fork 儲存庫、追蹤你自己的變更，以及使用 GitHub Codespaces 進行工作坊很有幫助。
  • 範本執行環境需求：某些範本需要本機工具，例如 Node.js、Python、Java 或 Docker。開始之前執行設定驗證工具，以便及早發現缺少的工具。
  • 基本終端機使用經驗：你不需要成為專家，但應該能熟悉執行像 git clone、azd auth login、和 azd up 這類命令。

在企業訂閱中工作？ 如果你的 Azure 環境由管理員管理，請事先確認你可以在計劃使用的訂閱或資源群組中部署資源。如果不能，請在開始之前申請沙盒訂閱或 Contributor 存取權。

剛接觸 Azure？ 從你的 Azure 試用或隨用隨付訂閱開始（https://aka.ms/azurefreetrial），這樣你就可以不用等待租戶層級的核准而完成整個練習。

🗺️ 課程地圖：按章節快速導航

每個章節都有專屬的 README，包含學習目標、快速入門與練習：

Chapter Topic Lessons Duration Complexity
Ch 1: Foundation 開始上手 AZD 基礎 | 安裝與設定 | 你的第一個專案 30-45 分鐘 ⭐
Ch 2: AI Development 以 AI 為先的應用 Foundry 整合 | AI 代理 | 模型部署 | 工作坊 1-2 小時 ⭐⭐
Ch 3: Configuration 驗證與安全 設定 | 驗證與安全 45-60 分鐘 ⭐⭐
Ch 4: Infrastructure 基礎架構即程式碼與部署 部署指南 | 資源部署 1-1.5 小時 ⭐⭐⭐
Ch 5: Multi-Agent AI 代理方案 零售情境 | 協調模式 2-3 小時 ⭐⭐⭐⭐
Ch 6: Pre-Deployment 規劃與驗證 預檢查 | 容量規劃 | SKU 選擇 | 應用程式洞察 1 小時 ⭐⭐
Ch 7: Troubleshooting 偵錯與修復 常見問題 | 除錯 | AI 問題 1-1.5 小時 ⭐⭐
Ch 8: Production 企業模式 生產實務 2-3 小時 ⭐⭐⭐⭐
🎓 Workshop 實作實驗室 介紹 | 選擇 | 驗證 | 剖析 | 設定 | 自訂 | 拆除 | 總結 3-4 小時 ⭐⭐

總課程時長： 約 10-14 小時 | 技能進展： 初學者 → 生產準備就緒

📚 學習章節

根據經驗和目標選擇你的學習路徑

🚀 第 1 章：基礎與快速起步

先決條件: Azure 訂閱，基本指令列知識
時長: 30-45 分鐘
複雜度: ⭐

你會學到

  • 了解 Azure Developer CLI 的基本概念
  • 在你的平台上安裝 AZD
  • 你的第一個成功部署

學習資源

實作練習

# 快速安裝檢查
azd version

# 部署你的第一個應用程式
azd init --template todo-nodejs-mongo
azd up

💡 章節成果: 成功使用 AZD 將一個簡單的網頁應用程式部署到 Azure

✅ 成功驗證：

# 完成第一章後，你應該能夠：
azd version              # 顯示已安裝的版本
azd init --template todo-nodejs-mongo  # 初始化專案
azd up                  # 部署到 Azure
azd show                # 顯示運行中應用程式的 URL
# 應用程式在瀏覽器中開啟並正常運作
azd down --force --purge  # 清理資源

📊 投入時間： 30-45 分鐘
📈 完成後技能等級： 能獨立部署基本應用程式 📈 完成後技能等級： 能獨立部署基本應用程式

🤖 第 2 章：以 AI 為先的開發（建議 AI 開發者）

先決條件: 已完成第 1 章
時長: 1-2 小時
複雜度: ⭐⭐

你會學到

  • Microsoft Foundry 與 AZD 的整合
  • 部署由 AI 驅動的應用程式
  • 了解 AI 服務設定

學習資源

實作練習

# 部署你的第一個 AI 應用程式
azd init --template azure-search-openai-demo
azd up

# 試用更多 AI 範本
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 章節成果: 部署並設定具有 RAG 功能的 AI 聊天應用程式

✅ 成功驗證：

# 完成第 2 章後，你應該能夠：
azd init --template azure-search-openai-demo
azd up
# 測試 AI 聊天介面
# 提出問題並取得附有來源的 AI 回應
# 驗證搜尋整合是否運作
azd monitor  # 檢查 Application Insights 是否顯示遙測資料
azd down --force --purge

📊 投入時間： 1-2 小時
📈 完成後技能等級： 能部署並設定可上線的 AI 應用程式
💰 成本意識： 了解開發 $80-150/月，生產 $300-3500/月 的成本

💰 AI 部署的成本考量

開發環境（估計 $80-150/月）：

  • Microsoft Foundry Models（隨用隨付）：$0-50/月（依 token 使用量）
  • AI Search（基本層）：$75/月
  • Container Apps（消耗計費）：$0-20/月
  • 儲存（標準）：$1-5/月

生產環境（估計 $300-3,500+/月）：

  • Microsoft Foundry Models（PTU 以確保持續效能）：$3,000+/月 或 高流量下的隨用隨付
  • AI Search（標準層）：$250/月
  • Container Apps（專屬）：$50-100/月
  • Application Insights：$5-50/月
  • 儲存（高階）：$10-50/月

💡 成本優化小提示：

  • 對於學習使用 免費層 的 Microsoft Foundry Models（Azure OpenAI 每月含 50,000 tokens）
  • 在不主動開發時執行 azd down 以解除佔用資源
  • 先從消耗型計費開始，僅在生產時升級到 PTU
  • 使用 azd provision --preview 在部署前估算成本
  • 啟用自動調整：只為實際使用付費

成本監控：

# 檢查預計每月費用
azd provision --preview

# 在 Azure 入口網站監察實際費用
az consumption budget list --resource-group <your-rg>

⚙️ 第 3 章：設定與驗證

先決條件: 已完成第 1 章
時長: 45-60 分鐘
複雜度: ⭐⭐

你會學到

  • 環境設定與管理
  • 驗證與安全最佳實務
  • 資源命名與組織

學習資源

實作練習

  • 配置多個環境（dev、staging、prod）
  • 設定託管身分識別驗證
  • 實作環境專屬設定

💡 章節成果：以妥善的驗證與安全性管理多個環境

🏗️ 第 4 章：基礎架構即程式碼與部署

先決條件: 已完成第 1-3 章
時長: 1-1.5 小時
複雜度: ⭐⭐⭐

你會學到

  • 進階部署模式
  • 使用 Bicep 的基礎架構即程式碼
  • 資源佈建策略

學習資源

實作練習

  • 建立自訂 Bicep 範本
  • 部署多服務應用程式
  • 實作藍綠部署策略

💡 章節成果：使用自訂基礎架構範本部署複雜的多服務應用程式

🎯 第 5 章：多代理 AI 解決方案（進階）

先決條件: 已完成第 1-2 章
時長: 2-3 小時
複雜度: ⭐⭐⭐⭐

你會學到

  • 多代理架構模式
  • 代理編排與協調
  • 可投入生產的 AI 部署

學習資源

實作練習

# 部署完整的零售多代理解決方案
cd examples/retail-multiagent-arm-template
./deploy.sh

# 探索代理配置
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 章節成果：部署並管理一個具備客服與庫存代理的可投入生產的多代理 AI 解決方案

🔍 第 6 章：部署前驗證與規劃

先決條件: 已完成第 4 章
時長: 1 小時
複雜度: ⭐⭐

你將會學到

  • 容量規劃與資源驗證
  • SKU 選擇策略
  • 部署前檢查與自動化

學習資源

實作練習

  • 執行容量驗證腳本
  • 為成本最佳化 SKU 選擇
  • 實作自動化部署前檢查

💡 章節成果: 在執行前驗證並優化部署

🚨 第 7 章：故障排除與除錯

先決條件：已完成任一部署章節
時長：1-1.5 小時
複雜度：⭐⭐

你將會學到

  • 系統化除錯方法
  • 常見問題與解決方案
  • 特定於 AI 的故障排除

學習資源

實作練習

  • 診斷部署失敗
  • 排解認證問題
  • 除錯 AI 服務連線問題

💡 章節成果：能獨立診斷並解決常見部署問題

🏢 第 8 章：生產與企業模式

先決條件：完成第 1 至 4 章
時長：2-3 小時
複雜度：⭐⭐⭐⭐

你將會學到

  • 生產部署策略
  • 企業安全模式
  • 監控與成本優化

學習資源

實作練習

  • 實作企業安全模式
  • 設置完整監控
  • 在適當治理下部署到生產環境

💡 章節成果：部署具備完整生產能力的企業級應用程式

🎓 工作坊概覽：實作學習體驗

⚠️ 工作坊狀態：開發中
工作坊教材目前正開發與修訂中。核心模組已可運作，但部分進階單元尚未完成。我們正積極補齊所有內容。追蹤進度 →

互動式工作坊教材

提供完整的瀏覽器工具與引導練習的實作學習

我們的工作坊教材提供有結構、互動式的學習體驗，補充上方的章節式課程。工作坊同時適合自學與講師帶領的課程。

🛠️ 工作坊特色

  • 瀏覽器介面：完整的 MkDocs 支援工作坊，包含搜尋、複製與主題功能
  • GitHub Codespaces 整合：一鍵建立開發環境
  • 結構化學習路徑：8 個模組引導練習（總計 3-4 小時）
  • 漸進式方法論：介紹 → 選擇 → 驗證 → 解構 → 設定 → 客製化 → 清理 → 總結
  • 互動式 DevContainer 環境：預先配置的工具與相依套件

📚 工作坊模組結構

工作坊採用 8 模組的漸進式方法論，帶你從探索到部署精通：

模組 主題 你會做什麼 時長
0. 介紹 工作坊概覽 了解學習目標、先決條件與工作坊架構 15 分鐘
1. 選擇 模板探索 探索 AZD 模板並為你的情境選擇合適的 AI 模板 20 分鐘
2. 驗證 部署與驗證 使用 azd up 部署模板並驗證基礎設施是否運作 30 分鐘
3. 解構 理解結構 使用 GitHub Copilot 探索模板架構、Bicep 檔案和程式碼組織 30 分鐘
4. 設定 azure.yaml 深入解析 精通 azure.yaml 設定、生命週期鉤子與環境變數 30 分鐘
5. 客製化 使其成為你的 啟用 AI Search、追蹤、評估，並為你的情境進行客製化 45 分鐘
6. 清除 清理 使用 azd down --purge 安全移除資源 15 分鐘
7. 總結 下一步 回顧成果、重點概念，並繼續你的學習旅程 15 分鐘

工作坊流程：

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

🚀 開始使用工作坊

# 選項 1：GitHub Codespaces（建議）
# 在儲存庫中點擊「Code」→「Create codespace on main」

# 選項 2：本地開發
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# 按照 workshop/README.md 的設定說明操作

🎯 工作坊學習成果

完成工作坊後，參與者將會：

  • 部署生產等級 AI 應用：使用 AZD 與 Microsoft Foundry 服務
  • 精通多代理架構：實作協調的 AI 代理解決方案
  • 實施安全最佳實務：設定驗證與存取控制
  • 為擴展做優化：設計具成本效益且具效能的部署
  • 故障排除部署問題：能獨立解決常見問題

📖 工作坊資源

適合對象：企業培訓、大學課程、自學，以及開發者訓練營。

📖 深入探討：AZD 能力

除了基本功能，AZD 為生產部署提供強大的功能：

  • 基於模板的部署 - 使用預建模板來應對常見應用模式
  • 基礎設施即程式碼 - 使用 Bicep 或 Terraform 管理 Azure 資源
  • 整合式工作流程 - 無縫地配置、部署與監控應用程式
  • 開發者友好 - 為開發者生產力與體驗最佳化

AZD + Microsoft Foundry：AI 部署的理想選擇

為何選擇 AZD 用於 AI 解決方案？ AZD 解決 AI 開發者面臨的主要挑戰：

  • AI 準備就緒的模板 - 為 Microsoft Foundry 模型、Cognitive Services 與機器學習工作負載提供預先配置的模板
  • 安全的 AI 部署 - 內建 AI 服務、API 金鑰與模型端點的安全模式
  • 生產級 AI 模式 - 可擴展且具成本效益的 AI 應用部署最佳實務
  • 端到端 AI 工作流程 - 從模型開發到生產部署，並搭配適當的監控
  • 成本優化 - 為 AI 工作負載提供聰明的資源分配與擴充策略
  • 與 Microsoft Foundry 的整合 - 與 Microsoft Foundry 模型目錄與端點的無縫連接

🎯 模板與範例庫

精選：Microsoft Foundry 模板

如果你要部署 AI 應用，從這裡開始！

注意： 這些模板示範各種 AI 模式。有些來自外部的 Azure 範例，其他則是本地實作。

模板 章節 複雜度 服務 類型
開始使用 AI 聊天 第 2 章 ⭐⭐ AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights 外部
開始使用 AI 代理 第 2 章 ⭐⭐ Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights 外部
Azure Search + OpenAI 示範 第 2 章 ⭐⭐ AzureOpenAI + Azure AI Search + App Service + Storage 外部
OpenAI 聊天應用 快速入門 第 2 章 ⭐ AzureOpenAI + Container Apps + Application Insights 外部
Agent OpenAI Python Prompty 第 5 章 ⭐⭐⭐ AzureOpenAI + Azure Functions + Prompty 外部
Contoso Chat RAG 第 8 章 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Cosmos DB + Container Apps 外部
零售多代理解決方案 第 5 章 ⭐⭐⭐⭐ AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB 本地

精選：完整學習情境

對應到學習章節的生產就緒應用模板

模板 學習章節 複雜度 主要學習重點
openai-chat-app-quickstart 第 2 章 ⭐ 基本的 AI 部署模式
azure-search-openai-demo 第 2 章 ⭐⭐ 使用 Azure AI Search 的 RAG 實作
ai-document-processing 第 4 章 ⭐⭐ 文件智能整合
agent-openai-python-prompty 第 5 章 ⭐⭐⭐ 代理框架與函式呼叫
contoso-chat 第 8 章 ⭐⭐⭐ 企業級 AI 編排
retail-multi-agent-solution 第 5 章 ⭐⭐⭐⭐ 具有客戶與庫存代理的多代理架構

按範例類型學習

📌 本地與外部範例：
本地範例（在此倉庫中） = 可立即使用
外部範例（Azure 範例） = 從連結的倉庫克隆

本地範例（可立即使用）

  • 零售多代理解決方案 - 完整的生產就緒實作，含 ARM 模板
    • 多代理架構（客戶 + 庫存 代理）
    • 完整的監控與評估
    • 透過 ARM 模板一鍵部署

本地範例 - 容器應用（第 2-5 章）

本倉庫中的完整容器部署範例：

外部範例 - 簡單應用（第 1-2 章）

克隆這些 Azure 範例倉庫開始：

外部範例 - 資料庫整合（第 3-4 章）

外部範例 - 進階模式（第 4-8 章）

外部範本集合

📚 學習資源與參考

快速參考

實作工作坊

  • AI Workshop Lab - 讓你的 AI 解決方案可用 AZD 部署（2-3 小時）
  • Interactive Workshop - 使用 MkDocs 和 GitHub Codespaces 的 8 模組引導練習
    • 流程：介紹 → 選擇 → 驗證 → 解構 → 設定 → 客製化 → 拆除 → 總結

外部學習資源

編輯器用的 AI Agent 技能

  • Microsoft Azure Skills on skills.sh - 37 個開放代理技能，涵蓋 Azure AI、Foundry、部署、診斷、成本優化等。可安裝到 GitHub Copilot、Cursor、Claude Code 或任何支援的代理： 
    npx skills add microsoft/github-copilot-for-azure

🔧 快速疑難排解指南

初學者常見問題與即時解法：

❌ "azd: command not found" 
# 先安裝 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

# 驗證安裝
azd version
❌ "No subscription found" or "Subscription not set" 
# 列出可用的訂閱
az account list --output table

# 設定預設訂閱
az account set --subscription "<subscription-id-or-name>"

# 為 AZD 環境設定
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# 驗證
az account show
❌ "InsufficientQuota" or "Quota exceeded" 
# 嘗試使用不同的 Azure 區域
azd env set AZURE_LOCATION "westus2"
azd up

# 或在開發環境中使用較小的 SKU
# 編輯 infra/main.parameters.json：
{
  "sku": "B1"  // Instead of "P1V2"
}
❌ "azd up" fails halfway through 
# 清除並重試
azd down --force --purge
azd up

# 只修復基礎架構
azd provision

# 檢查詳細狀態
azd show

# 在 Azure Monitor 檢查日誌
azd monitor --logs
❌ "Authentication failed" or "Token expired" 
# 為 AZD 重新驗證
azd auth logout
azd auth login

# 可選：如果你正在執行 az 指令，也可刷新 Azure CLI
az logout
az login

# 驗證身份
az account show
❌ "Resource already exists" or naming conflicts 
# AZD 會產生唯一名稱，但如遇衝突：
azd down --force --purge

# 然後在全新環境中重試
azd env new dev-v2
azd up
❌ Template deployment taking too long

正常等待時間：

  • 簡單網站應用：5-10 分鐘
  • 含資料庫的應用：10-15 分鐘
  • AI 應用：15-25 分鐘（OpenAI 供應較慢）
# 檢查進度
azd show

# 如果卡住超過 30 分鐘，請檢查 Azure 入口網站：
azd monitor --overview
# 尋找失敗的部署
❌ "Permission denied" or "Forbidden" 
# 檢查你在 Azure 的角色
az role assignment list --assignee $(az account show --query user.name -o tsv)

# 你至少需要「Contributor」角色
# 請向你的 Azure 管理員要求授予：
# - Contributor（用於資源）
# - User Access Administrator（用於角色指派）
❌ Can't find deployed application URL 
# 顯示所有服務端點
azd show

# 或開啟 Azure 入口網站
azd monitor

# 檢查指定的服務
azd env get-values
# 尋找 *_URL 變數

📚 完整疑難排解資源

🎓 課程完成與證書

進度追蹤

追蹤你每章的學習進度：

  • Chapter 1: Foundation & Quick Start ✅
  • Chapter 2: AI-First Development ✅
  • Chapter 3: Configuration & Authentication ✅
  • Chapter 4: Infrastructure as Code & Deployment ✅
  • Chapter 5: Multi-Agent AI Solutions ✅
  • Chapter 6: Pre-Deployment Validation & Planning ✅
  • Chapter 7: Troubleshooting & Debugging ✅
  • Chapter 8: Production & Enterprise Patterns ✅

學習驗證

完成每章後，確認你的知識：

  1. 實作練習：完成該章的實作部署
  2. 知識檢核：檢視該章的常見問題區
  3. 社群討論：在 Azure Discord 分享你的經驗
  4. 下一章：進入下一個難度層級

課程完成的好處

完成所有章節後，你將會擁有：

  • 生產經驗：在 Azure 上部署過真正的 AI 應用
  • 專業技能：企業就緒的部署能力
  • 社群認可：成為活躍的 Azure 開發者社群成員
  • 職涯提升：具需求的 AZD 與 AI 部署專長

🤝 社群與支援

獲得幫助與支援

來自 Microsoft Foundry Discord 的社群洞見

#Azure 頻道最近投票結果：

  • 45% 的開發者希望在 AI 工作負載上使用 AZD
  • 主要挑戰：多服務部署、憑證管理、生產就緒性
  • 最多人要求：AI 專用範本、疑難排解指南、最佳實踐

加入我們的社群來：

  • 分享你的 AZD + AI 經驗並獲得協助
  • 優先取得新 AI 範本預覽
  • 為 AI 部署最佳實務做出貢獻
  • 影響未來 AI + AZD 功能開發

對課程做出貢獻

我們歡迎貢獻！請閱讀我們的 Contributing Guide 了解細節：

  • 內容改進：強化現有章節與範例
  • 新增範例：加入真實世界情境與範本
  • 翻譯：協助維護多語言支援
  • 錯誤回報：提升準確性與清晰度
  • 社群準則：遵守我們的包容性社群指引

📄 課程資訊

授權

本專案採用 MIT License 授權 - 詳情請見 LICENSE 檔案。

相關的 Microsoft 學習資源

我們的團隊也製作其他完整的學習課程：

LangChain

LangChain4j 初學者 LangChain.js 初學者 LangChain 初學者

Azure / Edge / MCP / Agents

AZD 初學者 Edge AI 初學者 MCP 初學者 AI Agents 初學者

生成式 AI 系列

Generative AI 初學者 生成式 AI (.NET) 生成式 AI (Java) 生成式 AI (JavaScript)

核心學習

ML 初學者 數據科學入門 AI 入門 網絡安全入門 網頁開發入門 物聯網入門 XR 開發入門

Copilot 系列

AI 配對編程的 Copilot C#/.NET 的 Copilot Copilot 冒險

🗺️ 課程導航

🚀 準備好開始學習？

初學者: 從 第 1 章：基礎與快速上手
AI 開發者: 跳至 第 2 章：以 AI 為先的開發
進階開發者: 從 第 3 章：設定與驗證 開始

下一步: 開始第 1 章 - AZD 基礎 →

Disclaimer: 本文件已使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始語言版本的文件應視為具權威性的來源。對於重要或關鍵資訊，建議採用專業人工翻譯。對於因使用此翻譯而引致的任何誤解或誤釋，我們概不負責。
⚡