Instalar e configurar habilidades de Azure

Este artigo mostra como instalar Azure Skills, autenticar em sua conta Azure e verificar a instalação. Após a configuração, você pode gerenciar os recursos do Azure a partir de sua interface de chat.

Pré-requisitos

Certifique-se de que tem:

• Node.js LTS (Suporte a Longo Prazo): baixe de nodejs.org ou use um gerenciador de versões como o nvm.
• Azure conta: Criar uma conta gratuita se você não tiver uma.
• Um assistente de IA: GitHub Copilot CLI, Claude Code ou outra plataforma compatível.
• Azure CLI (recomendado para desenvolvimento local): simplifica a autenticação. Instalar Azure CLI. Variáveis de ambiente ou identidade gerenciada podem ser usadas como alternativas em pipelines de CI/CD.

Observação

Azure Skills usa a mesma autenticação que Azure MCP Server. Se você já tiver se autenticado para Azure SERVIDOR MCP, Azure Skills usará essas credenciais.

Autenticar no Azure

Azure Skills precisa de credenciais para acessar seus recursos de Azure. Escolha o método que se ajusta ao seu caso de uso.

Azure CLI (recomendado)

Esse método é o mais fácil para desenvolvimento e teste local.

1. Instalar Azure CLI:

   • Visite o guia de instalação Azure CLI.
   • Ou use um gerenciador de pacotes: brew install azure-cli (macOS) apt-get install azure-cli (Linux).

2. Entre no Azure:

   az login
   

   Uma janela do navegador é aberta. Entre usando suas credenciais de conta Azure.

3. Verifique a autenticação:

   az account show
   

   Você verá os detalhes da assinatura no terminal. Azure Skills detecta essa autenticação.

Variáveis de ambiente

Use variáveis de ambiente para scripts ou pipelines em que o Azure CLI não está disponível. Crie uma service principal primeiro.

Bash ou Zsh:

export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"

PowerShell:

$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"

Prompt de Comando do Windows:

set AZURE_TENANT_ID=your-tenant-id
set AZURE_CLIENT_ID=your-client-id
set AZURE_CLIENT_SECRET=your-client-secret

Azure Skills detecta essas variáveis de ambiente automaticamente.

Identidade gerenciada

Se você executar Azure Skills em um recurso de Azure (máquina virtual, Aplicativos de Contêiner ou Azure Functions), a identidade gerenciada manipulará a autenticação sem configuração manual.

Para obter mais informações, consulte Azure identidades gerenciadas.

Instalar habilidades de Azure

Escolha o método de instalação para seu assistente de IA.

GitHub Copilot CLI

Adicionar o marketplace (somente pela primeira vez):

/plugin marketplace add microsoft/azure-skills

Instale o plug-in:

/plugin install azure@azure-skills

Atualize o plug-in:

/plugin update azure@azure-skills

Código do Visual Studio

Instale a extensão Azure MCP do Visual Studio Marketplace:

👉 Azure MCP Extensão

A extensão Azure MCP instala uma extensão complementar que traz Azure Skills para Visual Studio Code. Juntos, eles configuram o servidor MCP Azure e a camada de habilidades completa.

Observação

A extensão de habilidades requer que a CLI do Git seja instalada em seu computador.

Código Claude

Adicionar o marketplace (somente pela primeira vez):

/plugin marketplace add microsoft/azure-skills

Instale o plug-in:

/plugin install azure@azure-skills

Atualização:

/plugin marketplace update azure-skills

Cursor

Instale o plug-in do Azure no Marketplace do Cursor ou diretamente das configurações do Cursor:

1. Vá para Configurações>Plug-ins.

2. Pesquise pelo Azure.

3. Selecione o plug-in do Azure para instalá-lo.

   

O plug-in configura automaticamente o Servidor MCP do Azure, o MCP do Foundry e a camada de habilidades completa.

Ideia do IntelliJ

Antes de instalar o Azure Skills no IntelliJ IDEA, verifique se você tem:

• Node.js 18+ instalado em seu sistema com npx disponível no PATH.
• Git instalado e acessível na linha de comando.

Você pode verificar esses pré-requisitos executando:

npx --version
git --version

Etapa 1: instalar o plug-in do GitHub Copilot

1. Abra o IntelliJ IDEA.
2. Vá paraConfigurações> (no Windows/Linux) ouPreferências> do IntelliJ (no macOS).
3. Navegue até Plug-ins na barra lateral esquerda.
4. Pesquise GitHub Copilot na guia Marketplace.
5. Instale o plug-in do GitHub Copilot (requer a versão 1.5.64-242 ou superior).
6. Reinicie o IntelliJ IDEA quando solicitado.

Etapa 2: Habilitar habilidades para o GitHub Copilot

1. Abra as configurações ou preferências do IntelliJ IDEA novamente.

2. Navegue até Ferramentas>GitHub Copilot>Chat.

3. Marque a caixa de seleção Habilitar Habilidades .

4. Selecione Aplicar e OK.

   

Etapa 3: Instalar as Habilidades do Azure

Opção 1: Kit de Ferramentas do Azure para IntelliJ

1. Instale o plug-in Azure Toolkit para IntelliJ do JetBrains Marketplace.

2. Reinicie o IntelliJ IDEA para concluir a instalação do plug-in.

3. Após a reinicialização, uma notificação é exibida oferecendo a instalação do Azure Skills. Selecione Instalar para adicionar as habilidades do Azure ao seu ambiente.

   

4. Verifique a instalação abrindo a janela de chat do GitHub Copilot e digitando /skill:azure. Esse comando exibe todas as habilidades disponíveis do Azure.

   

Opção 2: instalação manual

1. Abra um terminal ou prompt de comando.

2. Execute o seguinte comando para instalar o Azure Skills globalmente para o GitHub Copilot:

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

3. Aguarde a conclusão da instalação. Uma mensagem de confirmação é exibida quando as habilidades do Azure são adicionadas com êxito.

Para obter a lista completa de hosts com suporte e opções de instalação, consulte o repositório Azure Skills.

Verifique a instalação

Após a instalação, confirme se Azure Skills está pronto para uso.

1. Listar plug-ins instalados:

   /plugin list
   

   A saída inclui azure@azure-skills e as habilidades disponíveis.

2. Teste com um comando rápido:

   /ask List my Azure subscriptions
   

   Seu assistente de IA consulta sua conta Azure e exibe suas assinaturas.

Experimentar habilidades de Azure

Depois de instalar e verificar as Habilidades do Azure, experimente estes prompts na janela de chat do assistente de IA:

Prepare um plano de implantação para seu projeto:

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?

Resposta esperada: o assistente analisa sua base de código e gera modelos de infraestrutura como código. Ele cria um plano de implantação em .azure/plan.md e pede sua aprovação.

Diagnosticar um problema de integridade do recurso do Azure:

I'm getting errors from my Azure App Service. What's wrong and how do I fix it?

Resposta esperada: o assistente inspeciona seu serviço de aplicativo, verifica logs e analisa implantações recentes. Ele identifica problemas e fornece etapas de correção.

Configurar o monitoramento e a observabilidade:

Configure monitoring and alerting for my application. Which Application Insights features should I enable? What metrics should I track?

Resposta esperada: o assistente propõe uma estratégia de monitoramento e gera código de instrumentação. Ele configura alertas de Azure para métricas críticas adaptadas à pilha de aplicativos.

Assistentes de IA com suporte

Você pode usar Azure Skills entre estas plataformas:

• GitHub Copilot CLI: integração completa com ferramentas de GitHub Copilot
• Claude Code: por meio do PROTOCOLO MCP (Model Context Protocol)
• Outros assistentes de IA compatíveis com MCP: qualquer ferramenta que dê suporte ao MCP

Para obter uma lista completa de ferramentas que suportam a integração com Azure, consulte ferramentas suportadas pelo Servidor Azure MCP.

Opções de configuração

Telemetria

Por padrão, Azure Skills coletam telemetria de uso para melhorar o serviço.

Para desabilitar a telemetria:

export AZURE_MCP_COLLECT_TELEMETRY=false

Solução de problemas

Erro "Falha na autenticação"

Problem: seu assistente de IA não pode se autenticar no Azure.

Soluções:

• Azure CLI: Execute az login novamente e verifique se você está autenticado.
• Variáveis de ambiente: Verifique AZURE_TENANT_IDe AZURE_CLIENT_IDAZURE_CLIENT_SECRET esteja definido corretamente.
• Identidade gerenciada: Confirme se o recurso do Azure tem uma identidade gerenciada atribuída.

Erro "Plug-in não encontrado"

Problem: O plug-in Azure Skills não está instalado ou reconhecido.

Soluções:

• Para registrar o marketplace, execute /plugin marketplace add microsoft/azure-skills .
• Para instalar o plug-in, execute /plugin install azure@azure-skills.
• Reinicie o assistente de IA.
• Verifique se Node.js está instalado.

Erro de "permissões insuficientes"

Problem: sua conta de Azure não tem as permissões necessárias.

Soluções:

• Verifique suas atribuições de função no controle de acesso baseado em função (RBAC) do Azure.
• Solicite mais funções do administrador do Azure.
• Use uma assinatura diferente em que você tenha permissões mais altas.

Erro de "assinatura inválida"

Problem: Azure Skills não consegue localizar ou acessar sua assinatura especificada.

Soluções:

• Para ver as assinaturas disponíveis, execute az account list.
• Verifique se a ID ou o nome da assinatura está correto.
• Verifique se suas credenciais têm acesso à assinatura.

Conteúdo relacionado

• Comece com o Azure Skills
• Visão Geral das Habilidades do Azure
• GitHub Copilot para Azure
• guia de introdução Azure MCP Server