本文介绍如何安装 Azure Skills、向Azure帐户进行身份验证以及验证安装。 设置后，可以从聊天界面管理Azure资源。
先决条件
请确保：
- Node.js 长期支持（LTS）： 从 nodejs.org 下载 或使用版本管理器（如 nvm）。
- Azure 帐户：创建免费帐户（如果没有）。
- 一个AI助手：GitHub Copilot CLI、Claude Code或其他兼容平台。
- Azure CLI（建议用于本地开发）：简化身份验证。 Install Azure CLI。 可以在 CI/CD 管道中使用环境变量或托管标识作为替代方案。
注释
Azure Skills 使用与 Azure MCP Server 相同的身份验证。 如果已针对 Azure MCP 服务器进行身份验证，Azure Skills 会使用这些凭据。
对Azure进行身份验证
Azure Skills 需要凭据才能访问Azure资源。 选择适合用例的方法。
此方法是本地开发和测试的最简单方法。
Install 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 Skills 存储库。
验证安装
安装后，确认Azure Skills 已准备好使用。
列出已安装的插件：
/plugin list输出包括
azure@azure-skills和可用的技能。使用快速命令进行测试：
/ask List my Azure subscriptionsAI 助手会查询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 Code：通过模型上下文协议（MCP）
- 其他与 MCP 兼容的 AI 助手：支持 MCP 的任何工具
有关支持Azure集成的工具的完整列表，请参阅 Azure MCP Server 支持的工具。
配置选项
遥测
默认情况下，Azure Skills 收集使用情况遥测来改进服务。
若要禁用遥测：
export AZURE_MCP_COLLECT_TELEMETRY=false
故障排除
“身份验证失败”错误
Problem： AI 助手无法对Azure进行身份验证。
解决方案：
-
Azure CLI： 再次运行
az login，并确保进行身份验证。 -
环境变量：请验证
AZURE_TENANT_ID、AZURE_CLIENT_ID和AZURE_CLIENT_SECRET是否正确设置。 - Managed identity： 确认Azure资源具有分配的托管标识。
“找不到插件”错误
Problem：未安装或识别Azure Skills 插件。
解决方案：
- 若要注册市场，请运行
/plugin marketplace add microsoft/azure-skills。 - 若要安装插件，请运行
/plugin install azure@azure-skills。 - 重启 AI 助手。
- 验证是否已安装 Node.js。
“权限不足”错误
Problem：你的Azure帐户没有所需的权限。
解决方案：
- 检查Azure 基于角色的访问控制 (RBAC) 的角色分配。
- 向您的Azure管理员申请更多的角色。
- 使用具有更高权限的其他订阅。
“订阅无效”错误
问题： Azure Skills 无法找到或访问您指定的订阅。
解决方案：
- 若要查看可用的订阅，请运行
az account list。 - 验证订阅 ID 或名称是否正确。
- 检查您的凭据是否有权访问该订阅。