Instalace a konfigurace dovedností Azure

V tomto článku se dozvíte, jak nainstalovat Azure Dovednosti, ověřit Azure účet a ověřit instalaci. Po nastavení můžete spravovat Azure prostředky z rozhraní chatu.

Předpoklady

Ujistěte se, že máte:

• Node.js Long Term Support (LTS): Stáhněte si z nodejs.org nebo použijte správce verzí, jako je nvm.
• účet Azure: Vytvoření bezplatného účtu pokud ho nemáte.
• AI asistent: GitHub Copilot CLI, Claude Code nebo jiná kompatibilní platforma.
• Azure CLI (doporučeno pro místní vývoj): Zjednodušuje ověřování. Nainstalujte Azure CLI. Proměnné prostředí nebo spravovaná identita se dají použít jako alternativy v kanálech CI/CD.

Poznámka:

Azure Dovednosti používají stejné ověřování jako Azure MCP Server. Pokud jste už ověřili Azure serveru MCP, Azure Dovednosti tyto přihlašovací údaje používají.

Ověření v Azure

Azure Dovednosti potřebují přihlašovací údaje pro přístup k prostředkům Azure. Zvolte metodu, která odpovídá vašemu případu použití.

Azure CLI (doporučeno)

Tato metoda je nejjednodušší pro místní vývoj a testování.

1. Instalujte Azure CLI:

   • Navštivte průvodce instalací Azure CLI.
   • Nebo použijte správce balíčků: brew install azure-cli (macOS), apt-get install azure-cli (Linux).

2. Přihlaste se k Azure:

   az login
   

   Otevře se okno prohlížeče. Přihlaste se pomocí přihlašovacích údajů k účtu Azure.

3. Ověřte ověření:

   az account show
   

   Podrobnosti o předplatném se zobrazí v terminálu. Azure Schopnosti detekují toto ověřování.

Proměnné prostředí

Použijte proměnné prostředí pro skripty nebo kanály, kde Azure CLI není k dispozici. Nejprve vytvořte služební principál.

Bash nebo 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"

Windows příkazový řádek:

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

Azure Dovednosti rozpozná tyto proměnné prostředí automaticky.

Pokud spustíte Azure Dovednosti na prostředku Azure (virtuálním počítači, container Apps nebo Azure Functions), spravovaná identita zpracovává ověřování bez ručního nastavení.

Další informace najdete v tématu Azure spravované identity.

Instalace dovedností Azure

Zvolte metodu instalace pro pomocníka s AI.

GitHub Copilot

Přidejte marketplace (jenom poprvé):

/plugin marketplace add microsoft/azure-skills

Nainstalujte modul plug-in:

/plugin install azure@azure-skills

Aktualizujte modul plug-in:

/plugin update azure@azure-skills

Visual Studio Code

Nainstalujte rozšíření Azure MCP z webu Visual Studio Marketplace:

👉 Rozšíření Azure MCP

Rozšíření Azure MCP nainstaluje doprovodné rozšíření, které do Visual Studio Code přináší Azure Dovednosti. Společně nakonfigurují Azure MCP Server a celou vrstvu dovedností.

Poznámka:

Rozšíření dovedností vyžaduje, aby se na vašem počítači nainstalovalo Rozhraní příkazového řádku Gitu .

Claude kód

Přidejte marketplace (jenom poprvé):

/plugin marketplace add microsoft/azure-skills

Nainstalujte modul plug-in:

/plugin install azure@azure-skills

Aktualizace:

/plugin marketplace update azure-skills

Kurzor

Nainstalujte plugin Azure z Cursor Marketplace nebo přímo z nastavení Cursoru.

1. Přejděte na Nastavení>Pluginy.

2. Vyhledejte Azure.

3. Vyberte modul plug-in Azure, který chcete nainstalovat.

   

Modul plug-in automaticky nakonfiguruje Server Azure MCP, Foundry MCP a celou vrstvu dovedností.

IntelliJ IDEA

Před instalací dovedností Azure v IntelliJ IDEA se ujistěte, že máte:

• Node.js 18+ nainstalovaný v systému s npx dostupnými v PATH.
• Git je nainstalovaný a přístupný z příkazového řádku.

Spuštěním následujícího příkazu můžete ověřit tyto požadavky:

npx --version
git --version

Krok 1: Instalace modulu plug-in GitHub Copilot

1. Otevřete IntelliJ IDEA.
2. Přejděte doNastavení> (ve Windows/Linuxu) nebo Předvolby IntelliJ IDEA>(v macOS).
3. V levém bočním panelu přejděte na Pluginy.
4. Na kartě Marketplace vyhledejte GitHub Copilot .
5. Nainstalujte modul plug-in GitHub Copilot (vyžaduje verzi 1.5.64-242 nebo vyšší).
6. Po zobrazení výzvy restartujte IntelliJ IDEA.

Krok 2: Povolení dovedností pro GitHub Copilot

1. Znovu otevřete nastavení nebo předvolby IntelliJ IDEA.

2. Přejděte na Nástroje>GitHub Copilot>Chat.

3. Zaškrtněte políčko Povolit dovednosti .

4. Vyberte Použít a OK.

   

Krok 3: Instalace dovedností Azure

Varianta 1: Azure Toolkit for IntelliJ

1. Nainstalujte modul plug-in Azure Toolkit for IntelliJ z Marketplace JetBrains.

2. Restartujte IntelliJ IDEA a dokončete instalaci modulu plug-in.

3. Po restartování se zobrazí oznámení, které nabízí instalaci dovedností Azure. Vyberte Nainstalovat a přidejte funkce Azure do svého prostředí.

   

4. Ověřte instalaci tak, že otevřete okno chatu GitHub Copilot a zadáte /skill:azure. Tento příkaz zobrazí všechny dostupné dovednosti Azure.

   

Možnost 2: Ruční instalace

1. Otevřete terminál nebo příkazový řádek.

2. Spuštěním následujícího příkazu nainstalujte azure Skills globálně pro GitHub Copilot:

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

3. Počkejte na dokončení instalace. Po úspěšném přidání dovedností Azure se zobrazí potvrzovací zpráva.

Úplný seznam podporovaných hostitelů a možností instalace najdete v úložišti Azure Skills.

Ověření instalace

Po instalaci potvrďte, že Azure dovednosti jsou připravené k použití.

1. Výpis nainstalovaných modulů plug-in:

   /plugin list
   

   Výstup zahrnuje azure@azure-skills a dostupné dovednosti.

2. Testování pomocí rychlého příkazu:

   /ask List my Azure subscriptions
   

   Váš asistent AI se dotazuje na váš účet Azure a zobrazí vaše předplatná.

Vyzkoušení dovedností Azure

Po instalaci a ověření dovedností Azure vyzkoušejte tyto výzvy v okně chatu asistenta AI:

Příprava plánu nasazení pro váš projekt:

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?

Očekávaná odpověď: Asistent analyzuje základ kódu a vygeneruje šablony infrastruktury jako kódu. Vytvoří plán nasazení na .azure/plan.md a požádá o vaše schválení.

Diagnostika potíží se stavem prostředku Azure:

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

Očekávaná odpověď: Asistent zkontroluje vaši službu App Service, zkontroluje protokoly a zkontroluje nedávná nasazení. Identifikuje problémy a poskytuje nápravné kroky.

Nastavení monitorování a pozorovatelnosti:

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

Očekávaná odpověď: Asistent navrhuje strategii monitorování a generuje instrumentační kód. Konfiguruje Azure Alerts pro kritické metriky, které jsou přizpůsobené vašemu aplikačnímu zásobníku.

Podporované asistenty AI

Dovednosti Azure můžete používat na těchto platformách:

• GitHub Copilot CLI: Úplná integrace s nástroji GitHub Copilot
• Claude Code: Prostřednictvím protokolu MCP (Model Context Protocol)
• Ostatní asistenti AI kompatibilní s MCP: Jakýkoli nástroj, který podporuje MCP

Úplný seznam nástrojů, které podporují integraci Azure, najdete v tématu Azure podporované nástroje MCP Serveru.

Možnosti konfigurace

Telemetrie

Ve výchozím nastavení Azure Dovednosti shromažďují telemetrii využití, aby se služba zlepšila.

Zakázání telemetrie:

export AZURE_MCP_COLLECT_TELEMETRY=false

Troubleshooting

Chyba: „Neúspěšné ověření“

Problem: Váš asistent AI se nemůže ověřit v Azure.

Řešení:

• Azure CLI: Spusťte az login znovu a ujistěte se, že jste ověřeni.
• Proměnné prostředí: Ověřte AZURE_TENANT_ID, AZURE_CLIENT_IDa AZURE_CLIENT_SECRET jsou správně nastaveny.
• Managed identity: Potvrďte, že má prostředek Azure přiřazenou spravovanou identitu.

Chyba "Modul plug-in nebyl nalezen"

Problem: Modul plug-in Azure Skills není nainstalovaný nebo rozpoznaný.

Řešení:

• Pokud chcete zaregistrovat marketplace, spusťte /plugin marketplace add microsoft/azure-skills příkaz .
• Pokud chcete nainstalovat modul plug-in, spusťte /plugin install azure@azure-skillspříkaz .
• Restartujte asistenta AI.
• Ověřte, že je nainstalovaný Node.js.

Chyba Nedostatečná oprávnění

Problem: Váš účet Azure nemá požadovaná oprávnění.

Řešení:

• Zkontrolujte své přiřazení řízení přístupu na základě rolí (RBAC) v Azure.
• Požádejte o další role od správce Azure.
• Použijte jiné předplatné, ve kterém máte vyšší oprávnění.

Chyba Neplatné předplatné

Problem: Azure Dovednosti nemůžou najít nebo získat přístup k zadanému předplatnému.

Řešení:

• Pokud chcete zobrazit dostupná předplatná, spusťte az account listpříkaz .
• Ověřte správnost ID nebo názvu předplatného.
• Zkontrolujte, jestli vaše přihlašovací údaje mají přístup k předplatnému.

Související obsah

• Začněte s dovednostmi pro Azure
• Přehled dovedností Azure
• GitHub Copilot pro Azure
• Úvodní příručka k Azure MCP Serveru