Instalowanie i konfigurowanie umiejętności Azure

W tym artykule pokazano, jak zarejestrować się w witrynie Azure Skills Marketplace, zainstalować potrzebne wtyczki, uwierzytelnić się na koncie Azure i zweryfikować instalację. Marketplace zawiera podstawową wtyczkę Azure Skills i wyspecjalizowane wtyczki do ukierunkowanych scenariuszy Azure.

Wymagania wstępne

Upewnij się, że masz następujące:

  • Node.js long term support (LTS): Pobierz z nodejs.org lub użyj menedżera wersji, takiego jak nvm.
  • Azure konto: Utwórz bezpłatne konto jeśli go nie masz.
  • Asystent sztucznej inteligencji: GitHub Copilot CLI, Claude Code lub inna zgodna platforma.
  • Azure CLI (zalecane w przypadku programowania lokalnego): upraszcza uwierzytelnianie. Zainstaluj Azure CLI Zmienne środowiskowe lub tożsamość zarządzana mogą być używane jako alternatywy w pipeline'ach CI/CD.

Uwaga / Notatka

Azure Skills używa tego samego uwierzytelniania co Azure MCP Server. Jeśli już uwierzytelniłeś się w serwerze Azure MCP, Azure Skills używa tych poświadczeń.

Uwierzytelnianie w Azure

Azure Umiejętności wymagają poświadczeń, aby uzyskać dostęp do zasobów Azure. Wybierz metodę, która pasuje do twojego przypadku użycia.

Ta metoda jest najłatwiejsza w przypadku lokalnego programowania i testowania.

  1. Instalowanie interfejsu wiersza polecenia platformy Azure:

    • Odwiedź przewodnik instalacji Azure CLI.
    • Możesz też użyć menedżera pakietów: brew install azure-cli (macOS), apt-get install azure-cli (Linux).

  2. Zaloguj się do platformy Azure:

    az login

    Zostanie otwarte okno przeglądarki. Zaloguj się przy użyciu poświadczeń konta Azure.

  3. Weryfikowanie uwierzytelniania:

    az account show

    Szczegóły subskrypcji są widoczne w terminalu. Azure Skills wykrywa to uwierzytelnianie.

Instalowanie wtyczek Azure Skills

Wybierz metodę instalacji asystenta sztucznej inteligencji.

Dodaj Marketplace Azure Skills. Musisz zarejestrować go tylko raz:

/plugin marketplace add microsoft/azure-skills

Zainstaluj podstawową wtyczkę Azure Skills. Ta wtyczka jest zalecanym punktem wyjścia dla szerokiego zakresu przepływów pracy Azure i odnajdywania umiejętności:

/plugin install azure@azure-skills

Zaktualizuj wtyczkę:

/plugin update azure@azure-skills

Główna wtyczka zawiera discover-azure-skills. Jeśli zadanie nie jest objęte aktualnie zainstalowanym skillem, opisz zadanie Azure w interfejsie wiersza polecenia Copilot. Umiejętność Discovery przeszukuje katalog, sugeruje pasujące umiejętności, identyfikuje wtyczki, do których należą, i udostępnia wskazówki dotyczące instalacji.

Zainstaluj specjalistyczną wtyczkę bezpośrednio

Zainstaluj wyspecjalizowaną wtyczkę, gdy już wiesz, jakich ukierunkowanych możliwości potrzebujesz:

/plugin install <plugin-name>@azure-skills
Wtyczka Zainstaluj polecenie Fokus
Koszty Azure /plugin install azure-cost@azure-skills Analiza kosztów, szacowanie, optymalizacja i zarządzanie.
Azure Kusto Graph /plugin install azure-kusto-graph-skills@azure-skills analiza grafów Kusto, potoki IRQL i wizualizacja grafu.
Azure lokalnie /plugin install azure-local-skills@azure-skills Standardowe i wieloszafowe przepływy pracy Azure lokalnie.
Foundry IQ /plugin install foundry-iq-skills@azure-skills Tworzenie bazy wiedzy, pobieranie i połączenia z agentami w usłudze Foundry IQ.

Zainstalowanie wtyczki podstawowej nie powoduje zainstalowania tych wyspecjalizowanych wtyczek. Zapoznaj się z wykazem wtyczek Azure, aby uzyskać informacje o możliwościach i wymaganiach wstępnych specyficznych dla wtyczek.

Aby uzyskać bieżącą listę wtyczek i opcje instalacji, zobacz katalog wtyczek Azure i Azure Skills repository.

Weryfikowanie instalacji

Po zakończeniu instalacji upewnij się, że Azure Umiejętności są gotowe do użycia.

  1. Lista zainstalowanych wtyczek:

    /plugin list

    Wynik obejmuje azure@azure-skills i wszelkie wyspecjalizowane wtyczki, które zainstalowano.

  2. Przetestuj za pomocą szybkiego polecenia:

    /ask List my Azure subscriptions

    Asystent sztucznej inteligencji wysyła zapytanie do konta Azure i wyświetla subskrypcje.

Wypróbuj umiejętności Azure

Po zainstalowaniu i zweryfikowaniu umiejętności platformy Azure spróbuj wykonać następujące monity w oknie czatu asystenta sztucznej inteligencji:

Przygotuj plan wdrożenia dla projektu:

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?

Oczekiwana odpowiedź: Asystent analizuje bazę kodu i generuje szablony infrastruktury jako kodu. Tworzy plan wdrożenia w witrynie .azure/plan.md i prosi o zatwierdzenie.

Zdiagnozuj problem zdrowotny zasobu Azure:

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

Oczekiwana odpowiedź: Asystent sprawdza usługę aplikacji, sprawdza dzienniki i przegląda ostatnie wdrożenia. Identyfikuje problemy i udostępnia kroki korygowania.

Konfigurowanie monitorowania i obserwowania:

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

Oczekiwana odpowiedź: Asystent proponuje strategię monitorowania i generuje kod instrumentacji. Konfiguruje Azure Alerty dla krytycznych metryk dostosowanych do stosu aplikacji.

Obsługiwane asystenty sztucznej inteligencji

Możesz użyć Azure umiejętności na tych platformach:

  • GitHub Copilot CLI: pełna integracja z narzędziami GitHub Copilot
  • Claude Code: za pośrednictwem protokołu MCP (Model Context Protocol)
  • Inne asystenty sztucznej inteligencji zgodne z mcP: dowolne narzędzie obsługujące mcp

Aby uzyskać pełną listę narzędzi, które obsługują integrację Azure, zobacz Azure narzędzia obsługiwane przez serwer MCP.

Opcje konfiguracji

Telemetria

Domyślnie Azure Umiejętności zbierają dane telemetryczne użycia, aby ulepszyć usługę.

Aby wyłączyć telemetrię:

export AZURE_MCP_COLLECT_TELEMETRY=false

Troubleshooting

Błąd „Uwierzytelnianie nie powiodło się”

Problem: Asystent sztucznej inteligencji nie może uwierzytelnić się w Azure.

Rozwiązania:

  • Azure CLI: Uruchom az login ponownie i upewnij się, że uwierzytelnisz się.
  • Zmienne środowiskowe: Sprawdź, czy AZURE_TENANT_ID, AZURE_CLIENT_ID oraz AZURE_CLIENT_SECRET są poprawnie ustawione.
  • Zarządzana tożsamość: Upewnij się, że zasób Azure ma przypisaną tożsamość zarządzaną.

Błąd "Nie znaleziono wtyczki"

Problem: Wtyczka Azure Skills nie jest zainstalowana ani rozpoznawana.

Rozwiązania:

  • Aby zarejestrować witrynę Marketplace, uruchom polecenie /plugin marketplace add microsoft/azure-skills .
  • Aby zainstalować wtyczkę podstawową, uruchom polecenie /plugin install azure@azure-skills.
  • Aby zainstalować wyspecjalizowaną wtyczkę, uruchom polecenie /plugin install <plugin-name>@azure-skills.
  • Uruchom ponownie asystenta sztucznej inteligencji.
  • Sprawdź, czy Node.js jest zainstalowana.

Błąd "Niewystarczające uprawnienia"

Problem: Twoje konto Azure nie ma wymaganych uprawnień.

Rozwiązania:

  • Sprawdź przypisania ról w ramach Azure kontroli dostępu opartej na rolach (RBAC).
  • Zażądaj większej liczby ról od administratora Azure.
  • Użyj innej subskrypcji, w której masz wyższe uprawnienia.

Błąd "Nieprawidłowa subskrypcja"

Problem: Azure Umiejętności nie mogą znaleźć określonej subskrypcji ani uzyskać do jej dostępu.

Rozwiązania:

  • Aby wyświetlić dostępne subskrypcje, uruchom polecenie az account list.
  • Sprawdź, czy identyfikator subskrypcji lub nazwa są poprawne.
  • Sprawdź, czy Twoje poświadczenia mają dostęp do subskrypcji.

Treści powiązane

  • Ostatnia aktualizacja o