Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il server MCP (Model Context Protocol) Azure consente di gestire le risorse Monitoraggio di Azure e Cartelle di lavoro con richieste di linguaggio naturale. È possibile eseguire query nelle aree di lavoro di Log Analytics, analizzare i dati operativi, monitorare lo stato di integrità delle risorse, recuperare le metriche sulle prestazioni e gestire le cartelle di lavoro di Monitoraggio di Azure.
Monitoraggio di Azure consente di ottimizzare la disponibilità e le prestazioni delle applicazioni e dei servizi. Offre una soluzione completa per la raccolta, l'analisi e l'esecuzione dei dati di telemetria dagli ambienti cloud e locali.
Le cartelle di lavoro offrono un canvas flessibile per l'analisi dei dati e la creazione di report visivi avanzati all'interno del portale di Azure. Consentono di accedere a molteplici origini dati da Azure e combinarle in esperienze interattive unificate. Le cartelle di lavoro consentono di combinare più tipi di visualizzazioni e analisi, risultando ideali per l'esplorazione in formato libero. Per ulteriori informazioni, vedere la documentazione di Monitoraggio di Azure workbooks.
Annotazioni
parametri Tool: gli strumenti server Azure MCP definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati di seguito. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.
Log attività: ottenere i log attività
Elenca i log delle attività di Monitoraggio di Azure per una risorsa Azure specificata per un determinato numero di ore passate. Questo strumento consente di comprendere la cronologia della distribuzione delle risorse, le modifiche alla configurazione e i modelli di accesso. Restituisce eventi del log attività che includono timestamp, nome dell'operazione, stato e informazioni sul chiamante. Usare i risultati per analizzare le distribuzioni non riuscite, le modifiche impreviste o i problemi di accesso.
Alcuni prompt di esempio includono:
- "Elencare i log attività per le ultime "720" ore per la risorsa "webapp-prod".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome risorsa | Obbligatorio | Nome della risorsa Azure per recuperare i log delle attività. |
| Livello di evento | Opzionale | Il livello dei log di attività da recuperare. I livelli validi sono: Critical, Error, InformationalVerbose, , Warning. Se non specificato, restituisce tutti i livelli. |
| Hours | Opzionale | Numero di ore antecedenti ad ora per recuperare i log attività. |
| Tipo di risorsa | Opzionale | Tipo della risorsa Azure, ad esempio 'Microsoft.Storage/storageAccounts'). Specificare questa opzione solo se necessario per evitare ambiguità tra più risorse con lo stesso nome. |
| Top | Opzionale | Il numero massimo di log attività da recuperare. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Test Web: creare o aggiornare test Web
Parte degli strumenti MCP (Model Context Protocol), questo strumento crea o aggiorna un test Web standard in Monitoraggio di Azure per verificare la disponibilità degli endpoint. È possibile specificare le impostazioni di monitoraggio, ad esempio URL, frequenza, posizioni e risposte previste. Se il test non esiste, questo strumento lo crea; in caso contrario, aggiorna il test esistente con le nuove impostazioni.
Alcuni prompt di esempio includono:
- Creare un nuovo test Web Standard con la risorsa webtest 'webtest-prod-availability' nel gruppo di risorse 'rg-prod-monitoring' e associarlo al componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
- Aggiornare un test Web Standard esistente per la risorsa webtest 'webtest-prod-availability' nel gruppo di risorse 'rg-prod-monitoring' per collegarlo al componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. |
| Risorsa test Web | Obbligatorio | Nome della risorsa test Web su cui operare. |
| Componente Appinsights | Opzionale | ID risorsa del componente di Application Insights da associare al Test Web. |
| Descrizione | Opzionale | Breve descrizione del test Web. |
| abilitato | Opzionale | Indica se il test Web è abilitato. |
| Codice di stato previsto | Opzionale | Codice di stato HTTP previsto. |
| Seguire i reindirizzamenti | Opzionale | Indica se seguire i reindirizzamenti HTTP. |
| Frequenza | Opzionale | Frequenza di test in secondi. Valori supportati: 300, 600, 900. |
| Headers | Opzionale | Intestazioni HTTP da includere nella richiesta, come coppie KEY=VALUE separate da virgole. |
| Verbo HTTP | Opzionale | Metodo HTTP da usare, ad esempio get o post. |
| Ignora codice di stato | Opzionale | Indica se ignorare la convalida del codice di stato. |
| Ubicazione | Opzionale | La posizione in cui viene creata la risorsa di test Web. Deve corrispondere alla posizione del componente Application Insights. |
| Analizzare le richieste | Opzionale | Indica se analizzare le richieste dipendenti. |
| Corpo della richiesta | Opzionale | Il corpo da inviare con la richiesta. |
| Richiesta URL | Opzionale | URL assoluto da testare. |
| Ripetizione attivata | Opzionale | Indica se i tentativi sono abilitati. |
| Controllo SSL | Opzionale | Indica se convalidare i certificati SSL. |
| Controllo della durata SSL | Opzionale | Numero di giorni per controllare la durata del certificato SSL. |
| Timeout | Opzionale | Timeout della richiesta in secondi. Valori supportati: 30, 60, 90, 120. |
| Nome Test Web | Opzionale | Nome del test all'interno della risorsa di test Web. |
| Percorsi di test Web | Opzionale | Elenco delimitato da virgole di percorsi da cui eseguire il test. La località fa riferimento al tag di popolamento della posizione geografica per i test di disponibilità. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Test Web: Ottieni test Web
Questo strumento ottiene i dettagli per un test Web specifico o elenca tutti i test Web. Quando si specifica la risorsa Webtest, questo strumento restituisce informazioni dettagliate per il test Web. Quando non si specifica la risorsa Webtest, questo strumento restituisce un elenco di tutti i test Web nella sottoscrizione ed è possibile filtrare l'elenco in base al gruppo di risorse.
Alcuni prompt di esempio includono:
- Ottieni i dettagli del test Web per la risorsa webtest 'webtest-prod' nella mia sottoscrizione nel gruppo di risorse 'rg-monitoring'.
- "Elencare tutte le risorse Test Web nella mia sottoscrizione."
- Elenca tutte le risorse Web Test nella mia sottoscrizione nel gruppo di risorse 'rg-prod'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Risorsa test Web | Opzionale | Nome della risorsa test Web su cui operare. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Log Analytics: Elencare le aree di lavoro
Questo strumento elenca le aree di lavoro di Log Analytics all'interno di una sottoscrizione. Recupera il nome, l'ID, la posizione e altre proprietà chiave di ogni area di lavoro. È possibile usarlo per identificare le aree di lavoro prima di eseguire query sui log o esaminare le impostazioni dell'area di lavoro.
Alcuni prompt di esempio includono:
- Elenca le aree di lavoro Log Analytics nella mia sottoscrizione.
- "Visualizzare le aree di lavoro Log Analytics."
- Ottieni le aree di lavoro Log Analytics nella mia sottoscrizione.
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Log Analytics: Elenco delle tabelle
Questo strumento elenca tutte le tabelle in un'area di lavoro Log Analytics. Ad esempio, elencare le tabelle nell'area di lavoro 'prod-law' nel gruppo di risorse 'rg-monitoring' per visualizzare in anteprima le colonne e i tipi di dati disponibili. Restituisce nomi di tabella e schemi usati per compilare query KQL (Kusto Query Language). È possibile filtrare in base al tipo di tabella, ad esempio CustomLog o AzureMetrics.
Alcuni prompt di esempio includono:
- Elenca tutte le tabelle nell'area di lavoro di Log Analytics 'prod-law' di tipo 'CustomLog' nel gruppo di risorse 'rg-prod'.
- "Mostra tabelle di tipo tabella 'AzureMetrics' per l'area di lavoro 'f1b2c3d4-5678-90ab-cdef-1234567890ab' nel gruppo di risorse 'rg-monitoring'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'area di lavoro | Opzionale | ID o nome dell'area di lavoro Log Analytics. Può trattarsi dell'identificatore univoco (GUID) o del nome visualizzato dell'area di lavoro. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Log Analytics: Ottenere i tipi di tabella
Questo strumento MCP (Model Context Protocol) elenca i tipi di tabella disponibili in un'area di lavoro Log Analytics di Azure. Restituisce i nomi dei tipi di tabella. È possibile usare questi nomi quando si scrivono query su Monitoraggio di Azure log.
Alcuni prompt di esempio includono:
- "Elencare tutti i tipi di tabella disponibili in Log Analytics nome dell'area di lavoro 'prod-law-01' nel gruppo di risorse 'rg-prod'."
- "Quali tipi di tabella sono disponibili in Log Analytics nome dell'area di lavoro 'analytics-workspace' nel gruppo di risorse 'rg-logs'?"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure che contiene l'area di lavoro. |
| Nome dell'area di lavoro | Obbligatorio | Nome o ID dell'area di lavoro Log Analytics. È possibile usare il GUID dell'area di lavoro o il nome visualizzato. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Log Analytics: Eseguire query sui log dell'area di lavoro
Eseguire query sui registri in un'intera area di lavoro di Log Analytics usando il linguaggio di query Kusto (KQL). Questo strumento esegue query a livello di area di lavoro che restituiscono log su tutte le risorse e tabelle all'interno dell'area di lavoro. Questo strumento fa parte degli strumenti MCP (Model Context Protocol). Ad esempio, è possibile chiedere: 'mostra tutti gli errori nell'area di lavoro', 'cosa è successo nell'area di lavoro nelle ultime 24 ore', 'elencare le richieste non riuscite nell'area di lavoro'.
Alcuni prompt di esempio includono:
- "Mostra i log con la query 'errors' dalla tabella 'Syslog' nell'area di lavoro di Log Analytics 'my-workspace' nel gruppo di risorse 'rg-prod'."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Quesito | Obbligatorio | Query KQL (Kusto Query Language) da eseguire sull'area di lavoro Log Analytics. È possibile usare query predefinite in base al nome: recent mostra i log più recenti, ordinati in base a TimeGenerated. errors Visualizza i log a livello di errore, ordinati in base a TimeGenerated. In alternativa, fornire una query KQL personalizzata. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure che contiene l'area di lavoro. |
| Nome della tabella | Obbligatorio | Nome della tabella su cui eseguire una query all'interno dell'area di lavoro. |
| Nome dell'area di lavoro | Obbligatorio | ID o nome dell'area di lavoro Log Analytics. È possibile specificare l'identificatore univoco globale (GUID) o il nome visualizzato dell'area di lavoro. |
| Hours | Opzionale | Numero di ore di query da ora in poi. |
| Limit | Opzionale | Il numero massimo di risultati da restituire. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Log Analytics: Eseguire query sui log delle risorse
Eseguire query sui log di diagnostica e attività per una risorsa Azure specifica in un'area di lavoro Log Analytics usando KQL (Kusto Query Language). Questo strumento filtra i risultati nella risorsa specificata ed esegue la query KQL fornita sulla tabella scelta. Ad esempio, chiedere "Mostra log per la risorsa "app-monitor" per le ultime 24 ore".
Alcuni prompt di esempio includono:
- Mostra i log con la query 'recent' per l'ID risorsa '/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' nella tabella 'AzureDiagnostics'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Quesito | Obbligatorio | Query KQL da eseguire sull'area di lavoro Log Analytics. È possibile usare query predefinite in base al nome: recent mostra i log più recenti ordinati da TimeGenerated. errors Mostra i log a livello di errore ordinati in base a TimeGenerated. In caso contrario, specificare una query KQL personalizzata. |
| ID risorsa | Obbligatorio | L'ID della risorsa Azure per la risorsa da interrogare. Esempio: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>. |
| Nome della tabella | Obbligatorio | Nome della tabella su cui eseguire una query all'interno dell'area di lavoro. |
| Hours | Opzionale | Numero di ore di query da ora in poi. |
| Limit | Opzionale | Il numero massimo di risultati da restituire. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Integrità: ottenere l'integrità dell'entità
Questo strumento recupera lo stato di integrità e gli eventi di integrità recenti per un'entità specifica in un modello di integrità Monitoraggio di Azure. Lo strumento Model Context Protocol (MCP) segnala l'integrità a livello di applicazione in base ai modelli di integrità personalizzati, non alla disponibilità delle risorse di base. Per la disponibilità delle risorse di base, usare Azure Integrità risorse o lo strumento azmcp_resourcehealth_availability-status_get. Per eseguire query sui log in un'area di lavoro Log Analytics, usare azmcp_monitor_workspace_log_query. Per eseguire query sui log per una risorsa Azure specifica, usare azmcp_monitor_resource_log_query.
Alcuni prompt di esempio includono:
- "Mostra lo stato di integrità dell'entità 'order-service' usando il modello di integrità 'app-health-v1' nel gruppo di risorse 'rg-prod'."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'entità | Obbligatorio | Entità per cui ottenere lo stato di salute. |
| Modello di salute | Obbligatorio | Nome del modello di salute per il quale ottenere lo stato di salute. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Questo gruppo di risorse è un contenitore logico per Azure risorse. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Metriche: metriche di interrogazione
Effettuare query sulle metriche di Monitoraggio di Azure per una risorsa. Questo strumento restituisce i dati delle serie temporali per le metriche specificate, consentendo di analizzare le prestazioni e la disponibilità delle risorse. Questo strumento fa parte degli strumenti MCP (Model Context Protocol).
Alcuni prompt di esempio includono:
- "Analizzare le tendenze delle prestazioni e i tempi di risposta per la risorsa di Application Insights 'appinsights-prod' con le metriche 'requests/duration' e il namespace metriche 'microsoft.insights/components'."
- Controlla la metrica di disponibilità 'availabilityResults/availabilityPercentage' per la risorsa di Application Insights 'appinsights-staging' utilizzando lo spazio dei nomi delle metriche 'microsoft.insights/components'.
- Ottenere la metrica 'requests/duration' con aggregazione 'Average' e intervallo 'PT1M' per la risorsa 'appinsights-prod' usando lo spazio dei nomi delle metriche 'microsoft.insights/components'.
- "Analizzare le percentuali di errore e le richieste non riuscite per la risorsa di Application Insights 'appinsights-prod' usando le metriche 'requests/failed,exceptions/count' e lo spazio dei nomi delle metriche 'microsoft.insights/components'".
- Eseguire una query sulla metrica 'requests/count' per il tipo di risorsa 'Microsoft.Insights/components' risorsa 'appinsights-qa' con spazio dei nomi delle metriche 'microsoft.insights/components' e intervallo 'PT5M'.
- "Qual è la frequenza delle richieste al secondo usando la metrica 'requests/count' con l'aggregazione 'Count' per la risorsa di Application Insights 'appinsights-prod' e lo spazio dei nomi delle metriche 'microsoft.insights/components'?"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nomi delle metriche | Obbligatorio | Nomi delle metriche su cui eseguire query, delimitati da virgole. |
| Namespace delle metriche | Obbligatorio | Spazio dei nomi della metrica da interrogare. Ottenere questo valore dallo strumento azmcp-monitor-metrics-definitions. |
| Nome risorsa | Obbligatorio | Nome della risorsa Azure per cui eseguire query sulle metriche. |
| Aggregazione | Opzionale | Tipo di aggregazione da usare, ad esempio Average, Maximum, Minimum, Total o Count. |
| Ora di fine | Opzionale | Ora di fine della query in formato ISO, ad esempio 2023-01-01T00:00:00Z. Il valore predefinito è ora. |
| Filter | Opzionale | Filtro OData da applicare alla query delle metriche. |
| Intervallo | Opzionale | Intervallo di tempo per i punti dati, PT1H ad esempio per 1 ora, PT5M per 5 minuti. |
| Numero massimo di bucket | Opzionale | Numero massimo di bucket di tempo da restituire. Il valore predefinito è 50. |
| Tipo di risorsa | Opzionale | Tipo di risorsa Azure, ad esempio Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se non specificato, lo strumento tenta di dedurre il tipo dal nome della risorsa. |
| ora di inizio | Opzionale | Ora di inizio della query in formato ISO, ad esempio 2023-01-01T00:00:00Z. Il valore predefinito è 24 ore fa. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Metriche: elencare le definizioni delle metriche
Questo strumento elenca le definizioni delle metriche per una risorsa Azure. Restituisce i metadati relativi a ogni metrica, inclusi spazi dei nomi, descrizioni e tipi di aggregazione, in modo da determinare le metriche di cui eseguire query per una risorsa.
Alcuni prompt di esempio includono:
- "Ottenere le definizioni delle metriche per il nome della risorsa 'app-insights-prod'".
- "Elencare le definizioni delle metriche per il nome della risorsa 'mystorageacct' con il tipo di risorsa 'Microsoft.Storage/storageAccounts' e namespace delle metriche 'Storage'."
- "Mostra definizioni delle metriche per il nome della risorsa 'vm-prod-01' con la stringa di ricerca 'cpu' e limite '20'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome risorsa | Obbligatorio | Nome della risorsa Azure per cui eseguire query sulle metriche. |
| Limit | Opzionale | Numero massimo di definizioni delle metriche da restituire. L’impostazione predefinita è 10. |
| Namespace delle metriche | Opzionale | Spazio dei nomi della metrica da interrogare. Ottenere questo valore dallo strumento azmcp-monitor-metrics-definitions. |
| Tipo di risorsa | Opzionale | Tipo di risorsa Azure, ad esempio Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se non lo si specifica, lo strumento tenta di dedurre il tipo di risorsa dal nome della risorsa. |
| Stringa di ricerca | Opzionale | Stringa per filtrare le definizioni delle metriche. Il filtro esegue la corrispondenza senza distinzione tra maiuscole e minuscole per il nome e la descrizione della metrica. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Strumentazione: Ottieni una risorsa di apprendimento
Questo strumento elenca tutte le risorse di apprendimento disponibili per Monitoraggio di Azure strumentazione oppure recupera il contenuto di una risorsa specifica in base al percorso. Per impostazione predefinita, lo strumento restituisce tutti i percorsi delle risorse. Se si specifica un percorso, lo strumento restituisce il contenuto completo della risorsa. Per instrumentare un'applicazione, usare lo strumento orchestrator-start.
Alcuni prompt di esempio includono:
- "Ottenere la risorsa di apprendimento di onboarding nel percorso "onboarding/get-started.md".
- "Mostra il contenuto della risorsa di apprendimento Monitoraggio di Azure onboarding nel percorso "onboarding/quickstart.md".
- "Recuperare il contenuto del file di risorse di apprendimento Monitoraggio di Azure nel percorso 'samples/instrumentation-guide.html'".
- Elencare tutte le risorse di apprendimento per l'onboarding di Monitoraggio di Azure.
- "Visualizza tutti i percorsi dei materiali didattici per la strumentazione di Monitoraggio di Azure."
- "Quali risorse di apprendimento sono disponibili per l'onboarding della strumentazione di Monitoraggio di Azure?"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Percorso | Opzionale | Percorso delle risorse di apprendimento. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ✅
Strumentazione: avviare l'orchestrazione
Iniziare da qui per gli strumenti MCP (Model Context Protocol) che instrumentano Monitoraggio di Azure. Questo strumento analizza l'area di lavoro e restituisce la prima azione da eseguire. Dopo aver eseguito l'azione, chiamare orchestrator-next per continuare. Seguire esattamente l'azione nel campo instruction.
Alcuni prompt di esempio includono:
- "Avvia l'orchestrazione della strumentazione di Monitoraggio di Azure per il percorso dell'area di lavoro '/home/dev/workspace-monitoring'."
- Analizzare il percorso dell'area di lavoro '/src/projects/my-app-workspace' e restituire il primo passaggio di strumentazione di Monitoraggio di Azure.
- Inizia l'onboarding guidato di Monitoraggio di Azure per il progetto nel percorso dell'area di lavoro '/workspace/my-app' e forniscimi il passaggio 1.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Percorso dell'area di lavoro | Obbligatorio | Percorso assoluto della cartella dell'area di lavoro. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅
Strumentazione: continua orchestrazione
Ottieni l'azione di strumentazione successiva dopo aver completato quella corrente.
Questo strumento fa parte della suite MCP (Model Context Protocol).
Dopo aver eseguito l'esatto instruction della risposta precedente, eseguire questo strumento per ottenere l'azione successiva.
Flusso di lavoro previsto:
- Ricevi un'azione da orchestrator-start o orchestrator-next.
- Esegui il campo
instructionesattamente. - Si esegue questo strumento con un
Completion noteconciso per ottenere l'azione successiva.
Restituisce: azione successiva da eseguire o complete stato al termine di tutti i passaggi.
Alcuni prompt di esempio includono:
- Dopo aver completato il passaggio di strumentazione precedente su Monitoraggio di Azure, ricevere l'azione successiva per l'ID sessione 'session-abc123' con la nota di completamento: 'Aggiunto UseAzureMonitor() a Program.cs'.
- "Ottenere l'azione di onboarding successiva per l'ID sessione 'workspace/session-2026' con la nota di completamento 'Ran dotnet add package Microsoft. ApplicationInsights'."
- Dopo aver completato il passaggio di strumentazione precedente, passare al passaggio successivo per l'ID sessione "session-789xyz" con la nota di completamento "Aggiornato il file appsettings.json per abilitare Application Insights".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nota di completamento | Obbligatorio | Una frase che descrive ciò che è stato eseguito, ad esempio , 'Ran dotnet add package command' o 'Added UseAzureMonitor() to Program.cs'. |
| ID Sessione | Obbligatorio | Percorso dell'area di lavoro restituito come sessionId da orchestrator-start. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅
Strumentazione: Invia analisi brownfield
Invia i risultati dell'analisi del codice brownfield dopo che orchestrator-start restituisce lo stato analysis_needed. Questo strumento fa parte del flusso di lavoro MCP (Model Context Protocol). È necessario analizzare i file di origine dell'area di lavoro e compilare il modello di analisi prima di chiamare questo strumento. Una volta completato questo strumento, continuare con orchestrator-next.
Alcuni prompt di esempio includono:
- Inviare i risultati dell'analisi del codice brownfield nel formato JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' alla sessione di strumentazione 'workspace-7a3b' di Monitoraggio di Azure dopo che l'analisi è stata richiesta.
- Continuare l'orchestrazione della migrazione inviando il JSON dei risultati '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' alla sessione 'sess-01234'.
- Inviare l'analisi dei dati di telemetria brownfield completati come risultati JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' per la sessione di onboarding 'session-9f3b'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Risultati JSON | Obbligatorio | Oggetto JSON con risultati dell'analisi brownfield. Proprietà obbligatorie: serviceOptions (risultati delle opzioni del servizio dall'analisi della chiamata AddApplicationInsightsTelemetry(), null se non viene trovato), inizializzatori (risultati degli inizializzatori di telemetria dall'analisi delle implementazioni di ITelemetryInitializer o IConfigureOptionsfalse o hasCustomSampling: false, anziché null. |
| ID Sessione | Obbligatorio | Il percorso dell'area di lavoro restituito come sessionId da orchestrator-start. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅
Strumentazione: Seleziona miglioramento invio
Inviare la selezione di miglioramento dell'utente dopo che orchestrator-start ha restituito lo stato enhancement_available. Presentare le scelte di miglioramento all'utente, quindi chiamare questo strumento con le chiavi di miglioramento scelte. È possibile selezionare più miglioramenti passando un elenco delimitato da virgole, ad esempio redis,processors. Dopo che questo strumento ha avuto successo, continuare con orchestrator-next.
Alcuni prompt di esempio includono:
- Inviare le chiavi di ottimizzazione 'redis,processori' per Monitoraggio di Azure ID di sessione di strumentazione 'workspaces/my-app/session-abc123'.
- "Continua il flusso di miglioramento della strumentazione inviando chiavi di miglioramento 'redis' all'ID sessione 'workspaces/prod-app/session-789'".
- "Inviare chiavi di miglioramento scelte 'entityframework,otlp' per l'onboarding dell'ID sessione 'workspaces/onboard/session-456'."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Tasti di potenziamento | Obbligatorio | Uno o più tasti di miglioramento, delimitati da virgole (ad esempio, redis, redis,processors, entityframework,otlp). |
| ID Sessione | Obbligatorio | Il percorso dell'area di lavoro restituito come sessionId da orchestrator-start. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅
Cartelle di lavoro: Elenca le cartelle di lavoro
Cercare Azure cartelle di lavoro usando Resource Graph per eseguire query rapide sui metadati. Questo strumento consente di individuare, filtrare e contare cartelle di lavoro in ambiti diversi.
Restituisce i metadati della cartella di lavoro, inclusi id, name, location, category e i timestamp. Per impostazione predefinita, non restituisce il contenuto completo della cartella di lavoro (serializedData) — usare lo strumento di visualizzazione per farlo o impostare Output format su full.
Per impostazione predefinita, la ricerca si riferisce alle cartelle di lavoro nel contesto di Azure corrente (tenant/sottoscrizione). È possibile usare Resource group per specificare in modo esplicito l'ambito di ricerca. Lo strumento restituisce il conteggio totale lato server per impostazione predefinita. I risultati massimi restituiti sono 50, con un limite massimo di 1000; regolare questa impostazione con Max results. Scegliere Output format come summary per i token minimi o full per l'output completo serializedData .
Alcuni prompt di esempio includono:
- "Mostra tutte le cartelle di lavoro nel gruppo di risorse "monitoring-rg".
- "Elencare le cartelle di lavoro condivise nel gruppo di risorse "prod-rg".
- "Quali cartelle di lavoro sono state modificate dopo il 2024-01-15 nel gruppo di risorse 'analytics-rg'?"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Opzionale | Nome del gruppo di risorse Azure per definire l'ambito della ricerca. |
| Categoria | Opzionale | Filtrare le cartelle di lavoro per categoria (ad esempio, workbook, sentinel, TSG). Se non specificato, vengono restituite tutte le categorie. |
| Includi conteggio totale | Opzionale | Includere il conteggio totale di tutte le cartelle di lavoro corrispondenti nella risposta (impostazione predefinita: true). |
| Kind | Opzionale | Filtrare le cartelle di lavoro in base al tipo, ad esempio shared, user. Se non specificato, vengono restituiti tutti i tipi. |
| Numero massimo di risultati | Opzionale | Numero massimo di risultati da restituire (valore predefinito: 50, max: 1000). |
| Modificato dopo | Opzionale | Filtrare le cartelle di lavoro modificate dopo questa data (formato ISO 8601, ad esempio ). 2024-01-15 |
| Nome contiene | Opzionale | Filtrare le cartelle di lavoro in cui il nome visualizzato contiene questo testo (senza distinzione tra maiuscole e minuscole). |
| Formato di output | Opzionale | Formato di output: summary (solo ID e nome, token minimi), standard (metadati senza contenuto, impostazione predefinita), full (include serializedData). |
| ID origine | Opzionale | Filtrare le cartelle di lavoro in base all'ID risorsa di origine, ad esempio /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp. Se non specificato, vengono restituite tutte le cartelle di lavoro. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Cartelle di lavoro: mostra i dettagli della cartella di lavoro
Recuperare i dettagli della cartella di lavoro tramite l'API ARM (Azure Resource Manager), incluso il contenuto serializedData. Questo comando consente di ottenere la definizione completa della cartella di lavoro, inclusa la visualizzazione JSON.
Restituisce le proprietà complete della cartella di lavoro, i serializedDatatag e ETag. È possibile specificare più Workbook IDs per le operazioni batch. Il comando segnala errori parziali per singole cartelle di lavoro. Per ottenere prestazioni migliori, usare prima lo strumento elenco per individuare le cartelle di lavoro, quindi usare show per cartelle di lavoro specifiche.
Alcuni prompt di esempio includono:
- "Mostra i dettagli della cartella di lavoro con ID risorsa '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1e1'."
- "Ottenere la definizione completa della cartella di lavoro '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2'."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| ID cartelle di lavoro | Obbligatorio | ID risorsa Azure delle cartelle di lavoro da recuperare. Supporta più valori per le operazioni batch. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Cartelle di lavoro: Creare una cartella di lavoro
Creare una nuova cartella di lavoro nel gruppo di risorse e nella sottoscrizione specificati. È possibile impostare il nome visualizzato e il contenuto JSON serializzato per la cartella di lavoro. Questo comando restituisce le informazioni della cartella di lavoro create al termine dell'operazione.
Alcuni prompt di esempio includono:
- Creare un nuovo workbook denominato "Dashboard delle prestazioni" nel gruppo di risorse 'monitoring-rg' con il contenuto serializzato per un notebook di base.
- "Creare una cartella di lavoro denominata "Panoramica dell'infrastruttura" nel gruppo di risorse "prod-rg" con contenuto che mostra le metriche delle macchine virtuali."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome visualizzato | Obbligatorio | Nome visualizzato della cartella di lavoro. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure contenente la cartella di lavoro. |
| Contenuto serializzato | Obbligatorio | Contenuto JSON serializzato della cartella di lavoro. |
| ID origine | Opzionale | ID risorsa collegata per la cartella di lavoro. Per impostazione predefinita, tale valore è azure monitor. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Cartelle di lavoro: aggiornare la cartella di lavoro
Aggiornare le proprietà di una cartella di lavoro di Azure esistente aggiungendo nuovi passaggi, modificando il contenuto o modificando il nome visualizzato. Questa azione restituisce i dettagli della cartella di lavoro aggiornati. È necessario l'ID risorsa della cartella di lavoro e puoi specificare un nuovo contenuto serializzato o un nuovo nome visualizzato.
Alcuni prompt di esempio includono:
- Aggiornare la cartella di lavoro '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' con nome visualizzato "Report mensile".
- "Modificare il contenuto serializzato della cartella di lavoro '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft. Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' per includere un nuovo grafico delle metriche."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| ID cartella di lavoro | Obbligatorio | ID della risorsa Azure della cartella di lavoro da aggiornare. |
| Nome visualizzato | Opzionale | Nome visualizzato della cartella di lavoro. |
| Contenuto serializzato | Opzionale | Contenuto serializzato JSON della cartella di lavoro. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Cartelle di lavoro: Elimina cartelle di lavoro
Eliminare una o più cartelle di lavoro in base agli ID risorsa Azure. Questo comando esegue un'eliminazione temporanea nelle cartelle di lavoro, conservandole per 90 giorni. È possibile ripristinarli dal Cestino tramite il portale di Azure, se necessario.
Per le operazioni batch, è possibile specificare più Workbook IDs valori. Il comando segnala errori parziali per ogni cartella di lavoro, assicurandosi che singoli errori non influiscano sull'intera operazione batch.
Per altre informazioni, vedere Gestire le cartelle di lavoro Monitoraggio di Azure.
Alcuni prompt di esempio includono:
- Eliminare il workbook con ID risorsa '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
- Rimuovere le cartelle di lavoro con ID risorsa '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' e '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| ID cartelle di lavoro | Obbligatorio | ID delle risorse Azure delle cartelle di lavoro da eliminare. Supporta più valori per le operazioni batch. |
Indicazioni per l'annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌