Strumenti di Azure MCP Server per Azure Advisor

Il server MCP Azure consente di gestire le raccomandazioni Azure Advisor usando i prompt del linguaggio naturale. È possibile applicare, elencare e riepilogare le raccomandazioni.

Azure Advisor è un servizio Azure che fornisce raccomandazioni per ottimizzare l'affidabilità, la sicurezza, le prestazioni, l'eccellenza operativa e i costi. 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.

Raccomandazione: applica

Applica le raccomandazioni di Azure Advisor ai file di infrastruttura come codice (IaC), ad esempio ai modelli di Azure Resource Manager e alle configurazioni di Terraform. Si fornisce un tipo di risorsa Azure con --resourcee lo strumento restituisce le regole di Advisor che è possibile applicare al file IaC per migliorare i costi, le prestazioni, l'affidabilità o la sicurezza.

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 da applicare a un 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

Recuperare i record individuali delle raccomandazioni di Azure Advisor, una riga per raccomandazione, per una sottoscrizione. Si ricevono solo raccomandazioni attive con stato New. Le raccomandazioni ignorate e posticipate vengono escluse. Usare i filtri per categoria, impatto, tipo di risorsa, risorsa e ricerca per restringere i risultati. Il parametro superiore delimita il numero di elementi restituiti; il valore predefinito è 50 e ha un massimo di 100. I risultati sono limitati a un massimo di 100 elementi e potrebbero essere sottostimati quando servono aggregazioni o conteggi sull’intera popolazione.

Comando CLI di esempio

azmcp advisor recommendation list \
  [--resource-group <resource-group>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>]
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 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.
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.
search string No Filtro a testo libero applicato al testo del problema di raccomandazione (corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole). Usare questa opzione ogni volta che la richiesta dell'utente include una frase topica, ad esempio "correlata a Microsoft Foundry", "informazioni sulla crittografia", "menzione delle dimensioni corrette" o "per 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 rappresenta sempre l'intera popolazione filtrata, indipendentemente da top.
resource-group string No Nome del gruppo di risorse di Azure. Il gruppo di risorse è un contenitore logico per le risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

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

Raccomandazione: riepilogo

Aggrega Azure Advisor raccomandazioni e restituisce conteggi per bucket e un totale reale. Lo strumento risponde a domande su conteggi, classifiche e distribuzioni relative alle raccomandazioni attive, ad esempio query come "quanti", "top N", "quale X ne ha di più", "ripartizione per campo", "distribuzione di" e "conteggio di".

Comando CLI di esempio

azmcp advisor recommendation summary \
  [--resource-group <resource-group>] \
  [--group-by <group-by>] \
  [--top <top>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>]
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.
group-by string No Campo facoltativo per cui raggruppare il riepilogo. Uno di: recommendation-type, category, impact, resource-type. Se omesso, il valore predefinito è category, che mostra i temi principali (Costo, Sicurezza, Affidabilità e altro), così prompt come "riassumi i temi chiave delle mie raccomandazioni di Advisor" funzionano senza specificare un campo.
impact string No Filtrare le raccomandazioni in base all'impatto aziendale (High, Mediumo Low). 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 lettere 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.
search string No Filtro di testo libero applicato al testo del problema di raccomandazione (ricerca di sottostringa senza distinzione tra maiuscole e minuscole). Usare questa opzione ogni volta che la richiesta dell'utente include una frase topica, ad esempio "correlata a Microsoft Foundry", "informazioni sulla crittografia", "menzione delle dimensioni corrette" o "per 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 facoltativo al numero di bucket restituiti (il valore predefinito è tutti). TotalRecommendations rappresenta sempre l'intera popolazione filtrata, indipendentemente dal valore di top.
resource-group string No Nome del gruppo di risorse di Azure. Il gruppo di risorse è un contenitore logico per le risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

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

Tipo di raccomandazione: elenco

Elencare il catalogo dei tipi di raccomandazione Azure Advisor. I risultati includono la categoria di raccomandazione, l'impatto, il tipo di risorsa di destinazione e la sottocategoria. I risultati vengono ordinati in base all'impatto (High, Medium, Low), in modo che le raccomandazioni più importanti vengano visualizzate per prime.

Comando CLI di esempio

azmcp advisor recommendation-type list \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>]
Parametro Type Obbligatorio Descrizione
category string No Filtro facoltativo per la categoria Advisor. Valori tipici: Cost, HighAvailability, Security, Performance, OperationalExcellence (senza distinzione tra maiuscole e minuscole). Le nuove categorie supportate da Advisor in futuro continueranno a corrispondere.
impact string No Filtro facoltativo per il livello di impatto. Valori consentiti: High, Medium, Low (senza distinzione tra maiuscole e minuscole). Se omesso, i risultati contengono tutti i livelli di impatto, ma sono comunque ordinati alto, medio, basso.
resource-type string No Tipo di risorsa di Azure facoltativo per limitare i risultati a (ad esempio, microsoft.compute/virtualmachines, microsoft.sql/servers). Confrontato senza distinzione tra maiuscole e minuscole con il campo supportedResourceType per ciascun tipo di raccomandazione. Usare questo parametro durante l'onboarding di un nuovo tipo di risorsa per visualizzare solo i consigli generati da Advisor.

Suggerimenti per l'annotazione degli strumenti:

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

Contenuti correlati

  • Last updated on