安裝與配置 Azure Skills

本文將教你如何安裝 Azure Skills、驗證你的 Azure 帳號,以及驗證安裝。 設定完成後,你可以從聊天介面管理 Azure 資源。

先決條件

請確保您具備:

備註

Azure Skills 使用與 Azure MCP Server 相同的認證。 如果你已經為 Azure MCP Server 認證過,Azure Skills 會使用這些憑證。

驗證至 Azure

Azure Skills 需要憑證才能存取你的 Azure 資源。 選擇最適合你使用情境的方法。

此方法最容易在地開發與測試。

  1. 安裝 Azure CLI:

    • 請參考 Azure CLI 安裝指南
    • 或者使用套件管理器: brew install azure-cli (macOS)、 apt-get install azure-cli (Linux)。
  2. 請登入 Azure:

    az login
    

    瀏覽器視窗隨即開啟。 請使用您的 Azure 帳號憑證登入。

  3. 驗證身份:

    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 是否準備好使用。

  1. 列出已安裝的外掛:

    /plugin list
    

    產出包含 azure@azure-skills 及可用的技能。

  2. 用快速指令測試:

    /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_IDAZURE_CLIENT_IDAZURE_CLIENT_SECRET 和 是否正確設定。
  • Managed ID: 確認您的Azure資源有指定的管理身份。

「找不到外掛」錯誤

Problem: Azure Skills 外掛未安裝或被識別。

解決方案:

  • 要註冊市集,請執行 /plugin marketplace add microsoft/azure-skills
  • 要安裝外掛,請執行 /plugin install azure@azure-skills
  • 重新啟動你的 AI 助理。
  • 確認 Node.js 已安裝。

「權限不足」錯誤

Problem: 你的Azure帳號沒有所需的權限。

解決方案:

「訂閱無效」錯誤

Problem: Azure 技能無法找到或存取您指定的訂閱。

解決方案:

  • 要查看可用訂閱,請執行 az account list
  • 請確認訂閱ID或名稱是否正確。
  • 請確認你的憑證是否能存取訂閱內容。