narzędzia Azure MCP Server dla Azure Advisor

Serwer Azure MCP ułatwia zarządzanie zasobami Azure Advisor, w tym stosowanie zaleceń, uzyskiwanie szczegółowych informacji, wyświetlanie listy zaleceń i dostarczanie podsumowań za pośrednictwem monitów języka naturalnego.

Azure Advisor analizuje zasoby Azure i dostarcza spersonalizowane zalecenia umożliwiające podejmowanie działań w celu zoptymalizowania kosztów, wydajności, niezawodności i zabezpieczeń. Aby uzyskać więcej informacji, zobacz dokumentację Azure Advisor.

Uwaga / Notatka

Parametry narzędzia: Narzędzia serwera MCP platformy Azure definiują parametry dla danych potrzebnych do ukończenia zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.

Metadane: Pobierz

Pobiera metadane usługi Azure Advisor dla określonego typu zalecenia. Zwraca nazwę wyświetlaną typu rekomendacji, kategorię, podkategorię, wpływ, obsługiwane typy zasobów, opis, potencjalne korzyści i akcje korygowania. Użyj metadanych, aby zrozumieć zalecenie, ocenić jego wpływ i zaplanować kroki korygowania.

Przykładowe polecenie CLI

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parametr Typ Required Opis
recommendation-type-id ciąg Yes Stabilny identyfikator typu rekomendacji usługi Advisor (properties.recommendationTypeId) do wyszukania w globalnym katalogu metadanych rekomendacji. Ten identyfikator to klucz łączenia współdzielony z indywidualnymi rekomendacjami.
language ciąg No Ustawienia regionalne katalogu używane do filtrowania (properties.language). Wartość domyślna to en. Nie ma znaczenia wielkość liter. Obsługiwane wartości: en, cszh-hanstrsvrupt-ptpt-brplnldekojafreshuidit. zh-hant Usługa Advisor akceptuje tagi zawierające oznaczenie regionu, takie jak en-US, i mapuje je do języka bazowego (en).

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Metadane: lista

Wyświetla listę metadanych rekomendacji usługi Azure Advisor, określanych również jako typy rekomendacji. Pomaga sprawdzić, jakie zalecenia może wygenerować usługa Azure Advisor jeszcze przed wdrożeniem zasobów, takich jak maszyny wirtualne, nawet gdy brak aktywnych zaleceń. Wyświetla wycofania usług usługi Advisor, które występują w dniu określonej daty wycofania, przed nią lub po niej, oraz znajduje metadane dotyczące wycofania usługi według identyfikatora śledzenia usługi Service Health. Obsługuje wykrywanie środowisk greenfield przy użyciu globalnego katalogu Azure Resource Graph oraz filtrowania według typu zasobów na potrzeby wdrażania środowisk brownfield. Akceptuje opcjonalne filtry dla języka, typu zasobu, wpływu, kategorii, podkategorii, identyfikatora śledzenia i daty wycofania. Zwraca zlokalizowane identyfikatory typów, nazwy, kategorie, podkategorie, wpływ, priorytet, opisy, korzyści, akcje, zakres, zapytanie źródłowe i szczegóły wycofania usługi. Sortuje wyniki według wpływu od wysokiego przez średni do niskiego, a następnie według nazwy wyświetlanej.

Przykładowe polecenie CLI

azmcp advisor metadata list \
  [--language <language>] \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>] \
  [--sub-category <sub-category>] \
  [--tracking-id <tracking-id>] \
  [--retirement-date <retirement-date>]
Parametr Typ Required Opis
language ciąg No Język zlokalizowanych metadanych rekomendacji. Domyślnym językiem jest angielski (en). Obsługiwane języki katalogu to en, de, ru, cs, ja, it, ko, id, nl, hu, pl, pt-BR, fr, es, sv, tr, pt-PT, zh-Hans i zh-Hant. Warianty regionalne są mapowane na obsługiwany język bazowy, jeśli taki jest dostępny, na przykład en-US na en oraz fr-CA na fr; języki katalogu specyficzne dla ustawień regionalnych pozostają odrębne.
resource-type ciąg No Opcjonalny dokładny filtr typu zasobu platformy Azure, na przykład microsoft.compute/virtualmachines. Użyj go podczas wdrażania zasobów typu brownfield, aby wykryć typy rekomendacji, które mają zastosowanie do tego typu zasobu. Filtr jest niewrażliwy na wielkość liter.
impact ciąg No Opcjonalny filtr wpływu rekomendacji. Dozwolone wartości to High, Mediumlub Low. Filtr jest niewrażliwy na wielkość liter. Domyślnie wyniki są wyświetlane w kolejności: High, następnie Medium, a potem Low.
category ciąg No Opcjonalny dokładny filtr kategorii Advisor. Dozwolone wartości to Cost, HighAvailability, Security, Performancei OperationalExcellence. Filtr jest niewrażliwy na wielkość liter.
sub-category ciąg No Opcjonalny dokładny filtr podkategorii rekomendacji. Filtr jest niewrażliwy na wielkość liter. Znane wartości katalogu obejmują ComputeOptimization, DataPerformance, Scalability, DataProtectionAndRecovery, Other, NetworkOptimization, Personalized, MonitoringAndAlerting, RegionalResiliency, GovernanceAndCompliance, Reservations, SafeAndSecureDeployment, FailureMitigation, EfficiencyOptimization, ServiceUpgradeAndRetirement, StorageOptimization, SavingsPlan, UsageOptimization oraz ZoneResiliency. Wykaz może dodawać wartości w czasie, więc narzędzie akceptuje inne podkategorie.
tracking-id ciąg No Opcjonalny dokładny filtr identyfikatora śledzenia kondycji usługi, taki jak QNY1-HB8. Filtr jest niewrażliwy na wielkość liter i ma zastosowanie w metadanych ServiceUpgradeAndRetirement . Można pominąć --sub-category, ale nie można podać innej wartości.
retirement-date ciąg No Opcjonalny filtr daty wycofania usługi w formacie <operator>:<yyyy-MM-dd>, np. ge:2026-03-31. Obsługiwane operatory to eq, , lt, legt, i ge. Dotyczy tylko ServiceUpgradeAndRetirement podkategorii. Można pominąć --sub-category, ale nie można podać innej wartości.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Zalecenie: Zastosuj

Ułatwia wdrażanie zaleceń usługi Azure Advisor w plikach infrastruktury jako kodu (IaC), takich jak szablony Azure Resource Manager (ARM) i konfiguracje Terraform. Zwraca reguły, które mają być stosowane do pliku IaC.

Przykładowe polecenie CLI

azmcp advisor recommendation apply \
  --resource <resource>
Parametr Typ Required Opis
resource ciąg Yes Typ zasobu platformy Azure, dla którego mają zostać pobrane reguły dla plików IaC. Dostępne opcje: aad_domainservices, apimanagement_service, cognitiveservices_accounts, compute_virtualmachines, compute_virtualmachinescalesets, containerregistry_registries, containerservice_managedclusters, dbforpostgresql_flexibleservers, documentdb_databaseaccounts, keyvault_vaults, kubernetes_connectedclusters, kubernetesconfiguration_extensions, netapp_volumes, network_applicationgatewaywebapplicationfirewallpolicies, network_expressrouteports, network_frontdoorwebapplicationfirewallpolicies, sql_managedinstances, storage_storageaccounts, web_serverfarms, web_staticsites

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Zalecenie: Lista

Wyświetla poszczególne zalecenia usługi Azure Advisor dla subskrypcji, zwracając jeden rekord dla każdego zalecenia. To polecenie służy tylko do wyświetlania zawartości i szczegółów rekomendacji. W przypadku pytań agregacji, klasyfikacji, porównywania lub liczby użyj advisor recommendation summary zamiast tego. Zwraca tylko aktywne rekomendacje ze stanem New i wyklucza odrzucone i odroczone zalecenia. Obsługuje opcjonalne filtry według kategorii, wpływu, typu zasobu, zasobu i wyszukiwania pełnotekstowego. Parametr top ogranicza liczbę zwracanych elementów do 50 domyślnie i maksymalnie do 100. Ponieważ polecenie zwraca co najwyżej 100 rekordów, wykorzystanie tych wyników do obliczeń agregowanych może prowadzić do zaniżenia łącznej wartości.

Przykładowe polecenie CLI

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parametr Typ Required Opis
category ciąg No Filtruj rekomendacje według kategorii (na przykład Security, , CostPerformance, HighAvailability, OperationalExcellence). Dokładne dopasowanie bez uwzględniania wielkości liter.
impact ciąg No Filtruj rekomendacje według wpływu na działalność biznesową (High, Mediumlub Low). Dokładne dopasowanie bez uwzględniania wielkości liter.
resource-type ciąg No Filtruj rekomendacje według typu zasobu platformy Azure, którego dotyczy problem (na przykład Microsoft.Storage/storageAccounts). Dokładne dopasowanie bez uwzględniania wielkości liter.
resource ciąg No Filtruj rekomendacje według nazwy zasobu, którego dotyczy problem, lub pełnego identyfikatora zasobu ARM. Dopasowanie podciągów bez uwzględniania wielkości liter.
search ciąg No Stosuje filtr wolnego tekstu do tekstu problemu zalecenia (dopasowanie podciągów bez uwzględniania wielkości liter). Użyj tego za każdym razem, gdy żądanie zawiera frazę tematową, taką jak related to Microsoft Foundry, about encryption, mentioning right-sizelub for Key Vault. Wyodrębnij ważne rzeczowniki z frazy (na przykład Foundry, , encryptright-size, ), Key Vaulta następnie przekaż je tutaj.
top liczba całkowita No Maksymalna liczba elementów do zwrócenia. W przypadku list: wartość domyślna to 50 z zakresem po stronie serwera 1–100. Dla summary: opcjonalne ograniczenie liczby zwracanych koszyków do wyświetlenia (domyślnie: wszystkie). TotalRecommendations zawsze odzwierciedla pełną odfiltrowaną populację niezależnie od --top.
resource-group ciąg No Nazwa grupy zasobów platformy Azure.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Zalecenie: podsumowanie

To polecenie agreguje aktywne zalecenia usługi Azure Advisor o stanie New i zwraca liczbę dla każdego zasobnika oraz dokładną łączną liczbę. Użyj tego polecenia w przypadku pytań dotyczących agregacji, rankingu, porównań i zliczania. Filtry mają zastosowanie przed agregacją. Grupuj wyniki według recommendation-type, , categoryimpactlub resource-type. Domyślne grupowanie to category, która przedstawia motywy wysokiego poziomu, takie jak Koszt, Zabezpieczenia i Niezawodność. Parametr top ogranicza wyświetlane zasobniki, ale TotalRecommendations zawsze odzwierciedla pełną przefiltrowaną populację. Polecenie zachowuje koszyk Unknown jako wynik końcowy; uwzględnij go jako ostatni wiersz podczas wyświetlania grup w tabeli.

Przykładowe polecenie CLI

azmcp advisor recommendation summary \
  [--group-by <group-by>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parametr Typ Required Opis
group-by ciąg No Pole, według którego grupowane jest podsumowanie. Jeden z: recommendation-type, , categoryimpact, resource-type. Domyślnie jest ustawione na category, co pokazuje główne obszary tematyczne (Koszt, Bezpieczeństwo, Niezawodność i inne), dzięki czemu prompty takie jak summarize the key themes from my Advisor recommendations działają bez podawania nazwy pola.
category ciąg No Filtruj rekomendacje według kategorii (na przykład Security, , CostPerformance, HighAvailability, OperationalExcellence). Dokładne dopasowanie bez uwzględniania wielkości liter.
impact ciąg No Filtruj rekomendacje według wpływu na działalność biznesową (High, Mediumlub Low). Dokładne dopasowanie bez uwzględniania wielkości liter.
resource-type ciąg No Filtruj rekomendacje według typu zasobu platformy Azure, którego dotyczy problem (na przykład Microsoft.Storage/storageAccounts). Dokładne dopasowanie bez uwzględniania wielkości liter.
resource ciąg No Filtruj rekomendacje według nazwy zasobu, którego dotyczy problem, lub pełnego identyfikatora zasobu ARM. Dopasowanie podciągów bez uwzględniania wielkości liter.
search ciąg No Filtr wolnego tekstu zastosowany do tekstu problemu zalecenia (dopasowanie podciągów bez uwzględniania wielkości liter). Użyj tego filtru zawsze, gdy żądanie zawiera frazę tematową, taką jak related to Microsoft Foundry, about encryption, mentioning right-sizelub for Key Vault. Wyodrębnij ważne rzeczowniki z frazy (na przykład Foundry, , encryptright-size, ), Key Vaulta następnie przekaż je tutaj.
top liczba całkowita No Maksymalna liczba elementów do zwrócenia. W przypadku list: wartość domyślna to 50, zaciśnięta do 1–100 (limit po stronie serwera). Dla summary: opcjonalne ograniczenie liczby zwracanych koszyków do wyświetlenia (domyślnie: wszystkie). TotalRecommendations zawsze odzwierciedla pełną odfiltrowaną populację niezależnie od --top.
resource-group ciąg No Nazwa grupy zasobów platformy Azure.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Treści powiązane

  • Last updated on