Instalar e configurar o Azure Skills

Este artigo mostra-lhe como instalar o Azure Skills, autenticar-se na sua conta Azure e verificar a instalação. Depois da configuração, pode gerir os recursos do Azure a partir da sua interface de chat.

Pré-requisitos

Certifique-se de que tem:

• Node.js Suporte a Longo Prazo (LTS):Descarregue do nodejs.org ou use um gestor de versões como o nvm.
• Azure conta: Cria uma conta gratuita se não tiveres 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. Instala Azure CLI. Variáveis de ambiente ou identidade gerida podem ser usadas como alternativas em pipelines CI/CD.

Observação

Azure Skills usa a mesma autenticação que Azure MCP Server. Se já te autenticaste para o Azure MCP Server, o Azure Skills usa essas credenciais.

Autenticar no Azure

O Azure Skills precisa de credenciais para aceder aos seus recursos Azure. Escolhe o método que se adequa ao teu caso de uso.

Azure CLI (recomendado)

Este método é o mais fácil para desenvolvimento e testes locais.

1. Instalar Azure CLI:

   • Consulte o guia de instalação Azure CLI.
   • Ou usar um gestor de pacotes: brew install azure-cli (macOS), apt-get install azure-cli (Linux).

2. Iniciar sessão no Azure:

   az login
   

   Abre-se uma janela do browser. Inicie sessão usando as credenciais da sua conta Azure.

3. Verificar autenticação:

   az account show
   

   Vê os detalhes da sua subscrição no terminal. O Azure Skills deteta esta autenticação.

Variáveis de ambiente

Use variáveis de ambiente para scripts ou pipelines onde a Azure CLI não esteja disponível. Crie primeiro um princípio de serviço .

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"

Linha de Comandos do Windows:

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

O Azure Skills deteta automaticamente estas variáveis de ambiente.

Identidade gerenciada

Se correr o Azure Skills num recurso Azure (máquina virtual, Container Apps ou Azure Functions), a identidade gerida gere a autenticação sem configuração manual.

Para mais informações, consulte Identidades Geridas do Azure.

Instalar o Azure Skills

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

GitHub Copilot CLI

Adicione o mercado (apenas pela primeira vez):

/plugin marketplace add microsoft/azure-skills

Instale o plugin:

/plugin install azure@azure-skills

Atualize o plugin:

/plugin update azure@azure-skills

Código do Visual Studio

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

👉 Azure MCP Extension

A extensão Azure MCP instala uma extensão complementar que integra o Azure Skills para o Visual Studio Code. Juntos, configuram o Azure MCP Server e toda a camada de competências.

Observação

A extensão de competências exige que o Git CLI esteja instalado na sua máquina.

Código Claude

Adicione o mercado (apenas pela primeira vez):

/plugin marketplace add microsoft/azure-skills

Instale o plugin:

/plugin install azure@azure-skills

Atualizar:

/plugin marketplace update azure-skills

Cursor

Instale o plugin Azure a partir do Cursor Marketplace ou diretamente pelas definições do Cursor:

1. Vai a Definições>Plugins.

2. Pesquisar Azure.

3. Selecione o plugin Azure para o instalar.

   

O plugin configura automaticamente o Azure MCP Server, o Foundry MCP e toda a camada de skills.

IntelliJ IDEA

Antes de instalar o Azure Skills no IntelliJ IDEA, certifique-se de que tem:

• Node.js 18+ instalado no seu sistema e npx disponível no seu PATH.
• Git instalado e acessível a partir da linha de comandos.

Pode verificar estes pré-requisitos executando:

npx --version
git --version

Passo 1: Instalar o plugin GitHub Copilot

1. Abra o IntelliJ IDEA.
2. Vai àsDefinições> (no Windows/Linux) ouàs Preferências> (no macOS).
3. Navega até Plugins na barra lateral esquerda.
4. Pesquise por GitHub Copilot na aba Marketplace.
5. Instala o plugin GitHub Copilot (requer a versão 1.5.64-242 ou superior).
6. Reinicie o IntelliJ IDEA quando solicitado.

Passo 2: Ativar competências para o GitHub Copilot

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

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

3. Assinala a caixa de seleção Ativar Competências .

4. Seleciona Candidatar e OK.

   

Passo 3: Instalar o Azure Skills

Opção 1: Azure Toolkit for IntelliJ

1. Instale o plugin Azure Toolkit for IntelliJ a partir do JetBrains Marketplace.

2. Reinicie o IntelliJ IDEA para concluir a instalação do plugin.

3. Após reiniciar, aparece uma notificação a oferecer a instalação do Azure Skills. Selecione Instalar para adicionar as competências Azure ao seu ambiente.

   

4. Verifique a instalação abrindo a janela de chat do GitHub Copilot e escrevendo /skill:azure. Este comando mostra todas as competências Azure disponíveis.

   

Opção 2: Instalação manual

1. Abra um terminal ou uma linha de comandos.

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. Aparece uma mensagem de confirmação quando as competências Azure são adicionadas com sucesso.

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

Verificar a instalação

Após a instalação, confirme que o Azure Skills está pronto a usar.

1. Lista dos plugins instalados:

   /plugin list
   

   O resultado inclui azure@azure-skills e as competências disponíveis.

2. Teste com um comando rápido:

   /ask List my Azure subscriptions
   

   O seu assistente de IA consulta a sua conta Azure e mostra as suas subscrições.

Experimente as Competências Azure

Depois de instalar e verificar o Azure Skills, experimente estes prompts na janela de chat do seu assistente de IA:

Prepare um plano de implementação para o 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 a sua base de código e gera modelos de infraestrutura como código. Cria um plano de implantação em .azure/plan.md e pede a sua aprovação.

Diagnosticar um problema de saúde de recurso Azure:

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

Resposta esperada: O assistente inspeciona o seu serviço de aplicações, verifica registos e analisa implementações recentes. Identifica problemas e fornece passos de remediação.

Configurar monitorização e 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 monitorização e gera código de instrumentação. Configura o Azure Alerts para métricas críticas adaptadas à sua stack de aplicações.

Assistentes de IA suportados

Pode usar o Azure Skills nestas plataformas:

• GitHub Copilot CLI: Integração total com ferramentas GitHub Copilot
• Código Claude: Por meio do Protocolo de Contexto do Modelo (MCP)
• Outros assistentes de IA compatíveis com MCP: Qualquer ferramenta que suporte MCP

Para uma lista completa de ferramentas que suportam integração Azure, veja Azure MCP Server supported tools.

Opções de configuração

Telemetria

Por defeito, o Azure Skills recolhe dados de telemetria de utilização para melhorar o serviço.

Para desativar a telemetria:

export AZURE_MCP_COLLECT_TELEMETRY=false

Troubleshooting

Erro de "Falha na autenticação"

Problema: O seu assistente de IA não consegue autenticar-se a Azure.

Soluções:

• Azure CLI: Executa novamente az login e certifica-te de que estás autenticado.
• Variáveis de ambiente: Verificar AZURE_TENANT_ID, AZURE_CLIENT_ID, e AZURE_CLIENT_SECRET estão corretamente definidos.
• Identidade gerida: Confirme que o seu recurso de Azure tem uma identidade gerida atribuída.

"Erro: 'Plugin não encontrado'"

Problema: O plugin Azure Skills não está instalado nem reconhecido.

Soluções:

• Para registar o marketplace, execute /plugin marketplace add microsoft/azure-skills .
• Para instalar o plugin, execute /plugin install azure@azure-skills.
• Reinicia o teu assistente de IA.
• Verifique Node.js está instalado.

Erro "Permissões insuficientes"

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

Soluções:

• Verifica as atribuições de funções de controlo de acesso baseado em funções (RBAC) do Azure.
• Solicite mais funções ao seu administrador do Azure.
• Usa uma subscrição diferente onde tens permissões mais altas.

"Erro de subscrição inválida"

Problema: As Azure Skills não conseguem encontrar ou aceder à subscrição especificada.

Soluções:

• Para ver as subscrições disponíveis, execute az account list.
• Verifique se o ID da subscrição ou o nome está correto.
• Verifica se as tuas credenciais têm acesso à subscrição.

Conteúdo relacionado

• Comece com Azure Competências
• Visão Geral das Competências Azure
• GitHub Copilot para Azure
• Guia de Início do Servidor MCP do Azure