本文將教你如何安裝 Azure Skills、驗證你的 Azure 帳號,以及驗證安裝。 設定完成後,你可以從聊天介面管理 Azure 資源。
先決條件
請確保您具備:
- Node.js 長期支援(LTS):從 nodejs.org 下載 或使用像 NVM 這樣的版本管理器。
- Azure 帳號:如果還沒有,請建立一個免費帳號。
- 人工智慧助理:GitHub Copilot CLI、Claude Code 或其他相容平台。
- Azure CLI(建議用於地方開發):簡化認證。 安裝 Azure CLI。 環境變數或管理身份可作為 CI/CD 管線中的替代方案使用。
備註
Azure Skills 使用與 Azure MCP Server 相同的認證。 如果你已經為 Azure MCP Server 認證過,Azure Skills 會使用這些憑證。
驗證至 Azure
Azure Skills 需要憑證才能存取你的 Azure 資源。 選擇最適合你使用情境的方法。
此方法最容易在地開發與測試。
安裝 Azure CLI:
- 請參考 Azure CLI 安裝指南。
- 或者使用套件管理器:
brew install azure-cli(macOS)、apt-get install azure-cli(Linux)。
請登入 Azure:
az login瀏覽器視窗隨即開啟。 請使用您的 Azure 帳號憑證登入。
驗證身份:
az account show你會在終端機看到你的訂閱詳情。 Azure Skills 會偵測這種認證。
安裝 Azure 技能
為您的 AI 助理選擇安裝方式。
新增市集(僅限首次):
/plugin marketplace add microsoft/azure-skills
安裝外掛:
/plugin install azure@azure-skills
更新插件:
/plugin update azure@azure-skills
欲了解完整的支援主機與安裝選項,請參閱 Azure 技能資料庫。
確認安裝
安裝後,確認 Azure Skills 是否準備好使用。
列出已安裝的外掛:
/plugin list產出包含
azure@azure-skills及可用的技能。用快速指令測試:
/ask List my Azure subscriptions你的 AI 助理會查詢你的 Azure 帳號並顯示你的訂閱內容。
試試 Azure 技能
安裝並驗證 Azure Skills 後,請試試 AI 助理聊天視窗中的以下提示:
為您的專案準備部署計畫:
Analyze my project structure and prepare a deployment plan for deploying to Azure. What infrastructure do I need and how should I set it up?
預期回應:助理會分析你的程式碼庫並產生基礎設施即程式碼範本。 它會建立部署計畫 .azure/plan.md 並請求您的核准。
診斷Azure資源健康問題:
I'm getting errors from my Azure App Service. What's wrong and how do I fix it?
預期回應:助理會檢查你的應用程式服務、檢查日誌,並檢視近期部署。 它能識別問題並提供補救步驟。
建立監控與可觀察性:
Configure monitoring and alerting for my application. Which Application Insights features should I enable? What metrics should I track?
預期回應:助理提出監控策略並產生儀器程式碼。 它會根據你的應用堆疊,針對關鍵指標配置 Azure 警示。
支援的 AI 助理
你可以在以下平台上使用 Azure 技能:
- GitHub Copilot CLI:與GitHub Copilot工具的完整整合
- Claude 程式碼:透過模型上下文協定(MCP)
- 其他支援 MCP 的 AI 助理:任何支援 MCP 的工具
欲了解支援Azure整合的完整工具清單,請參見 Azure MCP Server 支援工具。
設定選項
遙測
預設情況下,Azure Skills 會收集使用遙測數據以改善服務。
要停用遙測:
export AZURE_MCP_COLLECT_TELEMETRY=false
Troubleshooting
「驗證失敗」錯誤
Problem: 你的 AI 助理無法向 Azure 進行認證。
解決方案:
-
Azure CLI: 再次執行
az login,並確保你已取得認證。 -
環境變數: 請驗證
AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET和 是否正確設定。 - Managed ID: 確認您的Azure資源有指定的管理身份。
「找不到外掛」錯誤
Problem: Azure Skills 外掛未安裝或被識別。
解決方案:
- 要註冊市集,請執行
/plugin marketplace add microsoft/azure-skills。 - 要安裝外掛,請執行
/plugin install azure@azure-skills。 - 重新啟動你的 AI 助理。
- 確認 Node.js 已安裝。
「權限不足」錯誤
Problem: 你的Azure帳號沒有所需的權限。
解決方案:
- 請檢查您的 Azure 基於角色的存取控制(RBAC)角色分配。
- 向你的 Azure 管理員申請更多角色。
- 使用權限較高的其他訂閱。
「訂閱無效」錯誤
Problem: Azure 技能無法找到或存取您指定的訂閱。
解決方案:
- 要查看可用訂閱,請執行
az account list。 - 請確認訂閱ID或名稱是否正確。
- 請確認你的憑證是否能存取訂閱內容。