Strumenti di Azure MCP Server per Azure Advisor

Il server MCP Azure consente di gestire le risorse Azure Advisor, tra cui l'applicazione di raccomandazioni, il recupero di dettagli, l'inserimento di raccomandazioni e la fornitura di riepiloghi, tramite prompt del linguaggio naturale.

Azure Advisor analizza le risorse Azure e offre raccomandazioni personalizzate e utilizzabili per ottimizzare costi, prestazioni, affidabilità e sicurezza. Per altre informazioni, vedere Azure Advisor documentazione.

Annotazioni

Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Metadati: Get

Ottiene Azure Advisor metadati per un tipo di raccomandazione specifico. Restituisce il nome visualizzato, la categoria, la sottocategoria, l'impatto, i tipi di risorse supportati, la descrizione, i potenziali vantaggi e le azioni correttive del tipo di raccomandazione. Usare i metadati per comprendere la raccomandazione, valutarne l'impatto e pianificare i passaggi di correzione.

Comando CLI di esempio

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parametro Type Obbligatorio Descrizione
recommendation-type-id string Yes ID stabile del tipo di raccomandazione di Advisor (properties.recommendationTypeId) da ricercare nel catalogo globale dei metadati delle raccomandazioni. Questo ID è la chiave di collegamento condivisa con le singole raccomandazioni.
language string No Impostazione locale del catalogo in base a cui filtrare (properties.language). Di default è en. Senza distinzione tra maiuscole e minuscole. Valori supportati: en, cs, de, es, fr, hu, id, ja, ko, nl, ru, pt-br, pl, it, sv, tr, pt-pt, zh-hant, zh-hans. Advisor accetta tag qualificati per l'area, ad esempio en-US e li esegue il mapping alla lingua di base (en).

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Metadati: Elenco

Elenca i metadati delle raccomandazioni di Azure Advisor, noti anche come tipi di raccomandazione. Consente di individuare le raccomandazioni che Azure Advisor possono produrre prima di distribuire risorse come le macchine virtuali, anche quando non esistono raccomandazioni attive. Mostra i ritiri dei servizi Advisor che si verificano nella, prima o dopo una data di ritiro specificata e trova i metadati relativi al ritiro del servizio in base all'ID di monitoraggio di Service Health. Supporta il rilevamento di risorse greenfield con il catalogo globale di Azure Resource Graph e il filtro per tipo di risorsa per l'integrazione di risorse brownfield. Accetta filtri facoltativi per lingua, tipo di risorsa, impatto, categoria, sottocategoria, ID di rilevamento e data di ritiro. Restituisce identificatori di tipo localizzati, nomi, categorie, sottocategorie, impatto, priorità, descrizioni, vantaggi, azioni, ambito, query di origine e dettagli sul ritiro dei servizi. Ordina i risultati in base all'impatto da Alto a Medio a Basso, quindi in base al nome visualizzato.

Comando CLI di esempio

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>]
Parametro Type Obbligatorio Descrizione
language string No Lingua per i metadati delle raccomandazioni localizzate. L'impostazione predefinita è Inglese (en). Le lingue del catalogo supportate sono es, id, hu, ja, nl, ru, pt-BR, tr, zh-Hans, sv, pt-PT, pl, it, ko, zh-Hant, fr, de, cs e en. Le varianti regionali vengono ricondotte, quando disponibile, a una lingua di base supportata, ad esempio en-US a en e fr-CA a fr; le lingue di catalogo specifiche delle impostazioni locali rimangono distinte.
resource-type string No Filtro esatto facoltativo per il tipo di risorsa di Azure, ad esempio microsoft.compute/virtualmachines. Usalo durante l'onboarding di tipo brownfield per identificare i tipi di raccomandazione applicabili a quel tipo di risorsa. Il filtro non fa distinzione tra maiuscole e minuscole.
impact string No Filtro di impatto facoltativo per le raccomandazioni. I valori consentiti sono High, Mediumo Low. Il filtro non fa distinzione tra maiuscole e minuscole. Per impostazione predefinita, i risultati vengono visualizzati in High, Mediume quindi Low nell'ordine.
category string No Filtro di categoria di Advisor facoltativo esatto. I valori consentiti sono Cost, HighAvailability, Security, Performance e OperationalExcellence. Il filtro non fa distinzione tra maiuscole e minuscole.
sub-category string No Filtro facoltativo per la sottocategoria esatta delle raccomandazioni. Il filtro non fa distinzione tra maiuscole e minuscole. I valori noti del catalogo includono ComputeOptimization, DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, Personalized, StorageOptimization, RegionalResiliency, Reservations, SafeAndSecureDeployment, Other, NetworkOptimization, Scalability, ServiceUpgradeAndRetirement, SavingsPlan, UsageOptimization e ZoneResiliency. Il catalogo può aggiungere valori nel tempo, quindi lo strumento accetta altre sottocategorie.
tracking-id string No Filtro opzionale per l'ID di rilevamento esatto di Service Health, ad esempio QNY1-HB8. Il filtro non fa distinzione tra maiuscole e minuscole e si applica all'interno ServiceUpgradeAndRetirement dei metadati. È possibile omettere --sub-category, ma non è possibile specificare un valore diverso.
retirement-date string No Filtro facoltativo della data di ritiro del servizio nel <operator>:<yyyy-MM-dd> formato, ad esempio ge:2026-03-31. Gli operatori supportati sono eq, lt, gtle, e ge. Si applica solo alla ServiceUpgradeAndRetirement sottocategoria. È possibile omettere --sub-category, ma non è possibile specificare un valore diverso.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Raccomandazione: Applica

Consente di applicare le raccomandazioni di Azure Advisor ai file di infrastruttura come codice (IaC), come i modelli di Azure Resource Manager (ARM) e le configurazioni di Terraform. Restituisce le regole da applicare al file IaC.

Comando CLI di esempio

azmcp advisor recommendation apply \
  --resource <resource>
Parametro Type Obbligatorio Descrizione
resource string Yes Tipo di risorsa Azure per cui ottenere le regole del file IaC. Opzioni disponibili: 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

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Raccomandazione: Elenco

Elenca le singole raccomandazioni di Azure Advisor per una sottoscrizione, con un record per ogni raccomandazione. Usare questo comando solo per visualizzare i contenuti e i dettagli delle raccomandazioni. Per domande di aggregazione, classificazione, confronto o conteggio, usare advisor recommendation summary invece . Restituisce solo raccomandazioni attive con stato New ed esclude le raccomandazioni ignorate e posticipate. Supporta filtri facoltativi per categoria, impatto, tipo di risorsa, risorsa e ricerca senza testo. Un top parametro contiene gli elementi restituiti, con un valore predefinito pari a 50 e un massimo di 100. Poiché il comando restituisce al massimo 100 record, l'uso di tali risultati per i calcoli aggregati potrebbe sottostimare il totale.

Comando CLI di esempio

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parametro Type Obbligatorio Descrizione
category string No Filtrare le raccomandazioni per categoria (ad esempio, Security, CostPerformance, HighAvailability). OperationalExcellence Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
impact string No Filtrare le raccomandazioni in base all'impatto aziendale (High, Mediumo Low). Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
resource-type string No Filtrare le raccomandazioni in base al tipo di risorsa Azure interessato , ad esempio Microsoft.Storage/storageAccounts. Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
resource string No Filtrare le raccomandazioni in base al nome della risorsa interessato o all'ID risorsa ARM completo. Corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole.
search string No Applica un filtro di testo libero al testo del problema di raccomandazione (ricerca di sottostringa senza distinzione tra maiuscole e minuscole). Usa questo ogni volta che una richiesta include un'espressione tematica come related to Microsoft Foundry, about encryption, mentioning right-size o for Key Vault. Estrarre i sostantivi salienti dalla frase ( ad esempio , Foundry, encryptright-size, , Key Vault) e passarli qui.
top string No Numero massimo di elementi da restituire. Per list: il valore predefinito è 50 con un intervallo lato server compreso tra 1 e 100. Per summary: limite di visualizzazione opzionale al numero di bucket restituiti (il valore predefinito è tutti). TotalRecommendations riflette sempre il popolamento filtrato completo indipendentemente da --top.
resource-group string No Nome del gruppo di risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Raccomandazione: Riepilogo

Questo comando aggrega le raccomandazioni Azure Advisor attive con stato New e restituisce conteggi per bucket più un totale accurato. Usare questo comando per domande di aggregazione, classificazione, confronto e conteggio. I filtri vengono applicati prima dell'aggregazione. Raggruppa i risultati per recommendation-type, category, impact o resource-type. Il raggruppamento predefinito è category, che espone temi di alto livello, ad esempio Costo, Sicurezza e Affidabilità. Il top parametro limita i bucket visualizzati, ma TotalRecommendations riflette sempre la popolazione filtrata completa. Il comando mantiene il Unknown bucket come risultato finale. Includerlo come riga finale quando si visualizzano i gruppi in una tabella.

Comando CLI di esempio

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>]
Parametro Type Obbligatorio Descrizione
group-by string No Campo per cui raggruppare il riepilogo. Uno di: recommendation-type, category, impact, resource-type. L'impostazione predefinita è category, che mostra i temi di alto livello (Costo, Sicurezza, Affidabilità e altro) così che prompt come summarize the key themes from my Advisor recommendations funzionino senza specificare il nome di un campo.
category string No Filtrare le raccomandazioni per categoria (ad esempio, Security, CostPerformance, HighAvailability). OperationalExcellence Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
impact string No Filtrare le raccomandazioni in base all'impatto aziendale (High, Mediumo Low). Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
resource-type string No Filtrare le raccomandazioni in base al tipo di risorsa Azure interessato , ad esempio Microsoft.Storage/storageAccounts. Corrispondenza esatta senza distinzione tra maiuscole e minuscole.
resource string No Filtrare le raccomandazioni in base al nome della risorsa interessato o all'ID risorsa ARM completo. Corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole.
search string No Filtro a testo libero applicato al testo del problema di raccomandazione (corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole). Usa questo filtro ogni volta che la richiesta include un'espressione relativa a un argomento, come related to Microsoft Foundry, about encryption, mentioning right-size o for Key Vault. Estrarre i sostantivi salienti dalla frase ( ad esempio , Foundry, encryptright-size, , Key Vault) e passarli qui.
top string No Numero massimo di elementi da restituire. Per list: il valore predefinito è 50, bloccato su 1-100 (limite lato server). Per summary: limite di visualizzazione opzionale al numero di bucket restituiti (il valore predefinito è tutti). TotalRecommendations riflette sempre il popolamento filtrato completo indipendentemente da --top.
resource-group string No Nome del gruppo di risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Contenuti correlati

  • Last updated on