Strumenti del server MCP di Azure per Azure SRE Agent

Azure MCP Server consente di gestire le risorse dell'agente SRE di Azure, tra cui: activate, add, apply, create, deactivate, delete, generate, get, investigate, kusto, list, mcp, message, pagerduty, pause, plan, reindex, resume, search, servicenow, test, validate e yolo, utilizzando prompt in linguaggio naturale.

Azure agente SRE è un assistente all'affidabilità basato sull'intelligenza artificiale che consente ai team di diagnosticare e risolvere i problemi di produzione, ridurre la fatica operativa e ridurre il tempo medio per la risoluzione (MTTR). Per altre informazioni, vedi la documentazione di Azure SRE Agent.

Nota

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.

Agenti: creare o aggiornare un subagente

Questo strumento crea o aggiorna un subagente in una risorsa agente SRE di destinazione. Specificare la sottoscrizione, l'agente e il nome per identificare il subagente. Lo strumento applica le modifiche in modo idempotente, quindi le richieste ripetute con gli stessi valori non creano duplicati. Specificare i parametri necessari per creare o aggiornare il sottoagente.

Alcuni prompt di esempio includono:

  • Crea un subagente con il nome 'subagent-01' sull'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Descrizione Optional Descrizione dell'elemento dell'agente SRE.
Istruzioni Optional Istruzioni per il subagente.
Strumenti Optional Nomi degli strumenti da allegare. Sono supportati più valori.
Handoffs Optional Nomi di trasferimento dei subagenti. Sono supportati più valori.

Suggerimenti per l'annotazione degli strumenti:

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

Agenti: eliminare un subagent

Questo strumento elimina un subagente da una risorsa SRE Agent specificata.

Alcuni prompt di esempio includono:

  • Eliminare il sottoagente denominato 'telemetry-agent' dall'agente SRE 'prod-sre' nella sottoscrizione '12345-abcde' con conferma impostata su 'true'.
  • Elimina il subagente 'backup-monitor' dall'agente SRE 'staging-sre' nella sottoscrizione 'my-subscription-id' con conferma impostata su 'true'.
  • Elimina il sottoagente denominato 'subagent-01' dall'agente SRE 'sre-agent-prod' con conferma 'true'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Agenti: ottenere i dettagli di configurazione

Visualizzare i dettagli di configurazione per un agente SRE denominato. Questo strumento restituisce l'endpoint, lo stato di provisioning, la posizione e le impostazioni per l'agente SRE specificato. È possibile filtrare i risultati in base al gruppo di risorse.

Alcuni prompt di esempio includono:

  • Mostra i dettagli dell'agente SRE 'sre-agent-north' nel gruppo di risorse 'rg-sre-prod'.
  • "Controllare la configurazione dell'agente SRE 'sre-agent-eastus' nel gruppo di risorse 'prod-rg'".
  • Mostra l'endpoint e lo stato di provisioning dell'agente SRE 'ops-agent-west' per l'intera sottoscrizione specificata.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Agenti: elencare le risorse

Questo strumento elenca le risorse dell'agente SRE di Azure. È possibile filtrare i risultati in base al gruppo di risorse. Ogni risultato include name, id, locationresourceGroup, provisioningState, e endpoint. Se lo strumento non trova risorse dell'agente SRE, restituisce un elenco vuoto.

Alcuni prompt di esempio includono:

  • Elenca le risorse di Azure SRE Agent nella mia sottoscrizione.

Suggerimenti per l'annotazione degli strumenti:

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

Strumenti agenti: creare o aggiornare uno strumento personalizzato

Questo strumento crea o aggiorna uno strumento personalizzato in una risorsa agente SRE di destinazione. Specificare l'agente, il nome e il tipo di strumento. Se esiste uno strumento con il nome specificato, questo strumento ne aggiorna la configurazione; in caso contrario, crea un nuovo strumento. Specificare i valori di configurazione in base alla tabella dei parametri.

Alcuni prompt di esempio includono:

  • Crea uno strumento personalizzato 'log-collector' sull'agente 'sre-agent-prod' nella sottoscrizione 'contoso-sub' con il tipo di strumento 'collector'.
  • "Creare uno strumento personalizzato con nome 'custom-kusto-tool', tipo di strumento 'KustoTool', in SRE Agent 'sre-agent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Tipo di strumento Obbligatorio Tipo di strumento personalizzato, ad esempio KustoTool o LinkTool.
Connettore Optional Nome del connettore per gli strumenti Kusto.
Nome del database Optional Database Kusto per gli strumenti Kusto.
Descrizione Optional Descrizione dell'elemento dell'agente SRE.
Parametri Optional Matrice JSON delle definizioni dei parametri dello strumento.
Query Optional Query Kusto per gli strumenti Kusto.
modello URL Optional Modello di URL per gli strumenti di collegamento.

Suggerimenti per l'annotazione degli strumenti:

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

Strumenti degli agenti: ottenere una definizione personalizzata di uno strumento

Ottiene una definizione personalizzata dello strumento da una risorsa specifica dell'agente SRE. Questo strumento richiede i parametri agente e nome e restituisce la definizione dello strumento personalizzata per l'agente e il nome specificati.

Alcuni prompt di esempio includono:

  • Ottieni la definizione del nome dello strumento personalizzato "deploy-helper" dall'agente SRE "sre-agent-prod".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Strumenti degli agenti: elenco strumenti

Questo strumento elenca gli strumenti personalizzati su una risorsa Agente SRE specifica. Restituisce il nome, la versione e lo stato per ogni strumento personalizzato, in modo da poter verificare le distribuzioni e risolvere i problemi.

Alcuni prompt di esempio includono:

  • "Elencare gli strumenti personalizzati nell'agente SRE 'sre-agent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Architettura: Pianificare un'architettura

Pianifica e genera un'architettura di un agente di Site Reliability Engineering (SRE). Questo strumento analizza i requisiti e produce una progettazione strutturata per agenti, strumenti, connettori e trigger. Si forniscono requisiti e vincoli di alto livello e questo strumento restituisce responsabilità dei componenti, modelli di interazione, considerazioni sulla distribuzione, raccomandazioni relative alla sicurezza e al controllo di accesso e suggerimenti sull'osservabilità. Usare l'output per guidare l'implementazione, la selezione degli strumenti e la pianificazione dell'integrazione.

Gli output includono:

  • Elenco di componenti con responsabilità e limiti.
  • Definizioni di connettore e trigger per le integrazioni.
  • Considerazioni sulla distribuzione e sulla scalabilità, incluse le raccomandazioni relative all'orchestrazione e all'area.
  • Indicazioni sul controllo degli accessi in base al ruolo e sulla sicurezza.
  • Modelli di osservabilità e risposta agli eventi imprevisti, inclusi i suggerimenti di monitoraggio e avviso.

Alcuni prompt di esempio includono:

  • Progetta un'architettura per un agente SRE che soddisfi i requisiti di "osservabilità multi-tenant con triage automatico degli incidenti e integrazione con Kusto".
Parametro Obbligatorio o facoltativo Descrizione
Requisiti Obbligatorio Requisiti di architettura.
Connettore Kusto Optional Nome del connettore Kusto.
Tipo di attivazione Optional Tipo di attivazione, ad esempio manuale o pianificato.

Suggerimenti per l'annotazione degli strumenti:

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

Prompt comuni: creare o aggiornare un prompt

Questo strumento crea o aggiorna un prompt comune con nome nell'agente SRE. Salva modelli di prompt riutilizzabili, in modo che i team possano centralizzare le linee guida e ridurre la duplicazione. Lo strumento restituisce l'oggetto prompt creato o aggiornato.

Alcuni prompt di esempio includono:

  • "Creare un prompt comune con il nome "restart-service" e il contenuto "Descrivere come riavviare il servizio app durante un evento imprevisto" nell'agente SRE "sre-agent-prod".
Parametro Obbligatorio o facoltativo Descrizione
Content Obbligatorio Contenuto del prompt.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Prompt comuni: eliminare un prompt

Questo strumento rimuove definitivamente il prompt identificato per nome da un agente SRE. Confermi l'eliminazione prima che lo strumento cancelli la definizione del prompt. Questa azione non è reversibile.

Alcuni prompt di esempio includono:

  • Elimina definitivamente il nome del prompt comune "cpu-throttle-guidance" dall'agente SRE 'sre-agent-westus' con conferma "true".
Parametro Obbligatorio o facoltativo Descrizione
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Prompt comuni: Ottieni il testo del prompt

Questo strumento mostra il testo completo di uno specifico prompt comune denominato di un agente di Site Reliability Engineering (SRE). Specificare il nome e questo strumento restituisce il testo del prompt in modo da poter esaminare o controllare le richieste di debug o revisione.

Alcuni prompt di esempio includono:

  • "Mostrami il prompt comune con il nome 'deploy-checklist' nell'agente SRE 'sre-agent-westus'".
Parametro Obbligatorio o facoltativo Descrizione
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Prompt comuni: elencare le richieste

Questo strumento elenca tutti i prompt comuni disponibili in un agente SRE. Restituisce una raccolta di nomi e descrizioni dei prompt registrati. I risultati consentono di individuare le richieste disponibili ed esaminare le relative descrizioni.

Alcuni prompt di esempio includono:

  • "Elencare le richieste comuni per l'agente SRE 'sre-agent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Ricerca Optional Filtro di ricerca facoltativo.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: creare o aggiornare il connettore Kusto

Questo strumento crea o aggiorna un connettore per Esplora dati di Azure (Kusto) in una risorsa agente SRE Azure. Il connettore consente all'agente di inserire ed eseguire query sui dati da un cluster Esplora dati di Azure.

Alcuni prompt di esempio includono:

  • "Creare un connettore Kusto nell'agente SRE "sre-agent-01" con l'URL del cluster "https://my-resource.eastus.kusto.windows.net" e il nome "kusto-connector-prod".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Cluster URL Obbligatorio URL del cluster Esplora dati di Azure.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Nome del database Optional Database Kusto per gli strumenti Kusto.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: creare o aggiornare il connettore

Questo strumento crea o aggiorna un connettore in una risorsa agente SRE Azure. Specificare l'agente, il nome del connettore e il tipo di connettore. È anche possibile fornire credenziali di connessione e impostazioni di configurazione aggiuntive. Se l'operazione ha esito positivo, questo strumento restituisce la risorsa del connettore.

Seguire le convenzioni di denominazione di Azure per la denominazione delle risorse e assicurarsi che le autorizzazioni del controllo degli accessi in base al ruolo (RBAC) consentano gli aggiornamenti dei connettori. Usare nomi realistici, ad sre-agent-prod esempio per l'agente e rg-sre-prod per il gruppo di risorse.

Alcuni prompt di esempio includono:

  • "Creare un connettore MCP nell'agente SRE 'sreagent-prod' con nome "mcp-connector" e digitare "http".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Tipo Obbligatorio Tipo di connettore MCP: stdio o http.
Args Optional Argomenti per i connettori STDIO MCP.
Tipo di autenticazione Optional Tipo di autenticazione del connettore MCP HTTP.
Token di connessione env Optional Variabile di ambiente contenente il token Bearer.
Comando Optional Comando per i connettori STDIO MCP.
Punto finale Optional L'endpoint del connettore HTTP MCP.
Envs JSON Optional Oggetto JSON delle variabili di ambiente per i connettori stdio MCP.
Intestazioni JSON Optional Oggetto JSON delle intestazioni HTTP.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: Eliminare il connettore

Questo strumento elimina un connettore da una risorsa agente SRE Azure.

Alcuni prompt di esempio includono:

  • "Eliminare il connettore 'metrics-collector' dall'agente SRE 'sre-agent-prod' con confermare "true".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: ottenere i dettagli del connettore

Questo strumento recupera i dettagli per un connettore configurato in una risorsa agente SRE Azure. È possibile visualizzare le proprietà, la configurazione e lo stato del connettore per risolvere i problemi o documentare il connettore. Specificare i parametri agente e nome per identificare la risorsa agente SRE Azure e il connettore.

Alcuni prompt di esempio includono:

  • "Mostra i dettagli del connettore 'github-connector' nell'agente SRE 'sre-agent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: Elenco connettori

Questo strumento elenca i connettori configurati in una risorsa agente SRE Azure. Restituisce i nomi dei connettori, i tipi di connettore e lo stato di registrazione in modo da poter esaminare le integrazioni e risolvere i problemi.

Alcuni prompt di esempio includono:

  • "Elencare i connettori configurati nell'agente SRE 'sreagent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Connettori: Connettore di test

Questo strumento testa un connettore ed elenca gli strumenti esposti dal connettore. È possibile verificare la connettività del connettore ed esaminare gli strumenti disponibili, inclusi il nome e le funzionalità di ogni strumento. Per testare un connettore, specificare i parametri dell'agente e del nome.

Alcuni prompt di esempio includono:

  • Verifica il connettore denominato 'my-connector' nell'agente SRE 'sre-agent-prod' ed elencane gli strumenti.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Documentazione: Ottenere la documentazione di riferimento

Questo strumento restituisce la documentazione di riferimento per i concetti relativi all'agente SRE (Site Reliability Engineering). È possibile ottenere definizioni, dettagli di configurazione ed esempi di utilizzo per gli argomenti dell'agente SRE, ad esempio avvisi, risposta agli eventi imprevisti, controlli di integrità e dati di telemetria. Specificare l'argomento per recuperare la voce di riferimento di un argomento.

Alcuni prompt di esempio includono:

  • Mostrami la documentazione di SRE Agent per l'argomento "incident-response".
Parametro Obbligatorio o facoltativo Descrizione
Topic Obbligatorio Argomento della documentazione.

Suggerimenti per l'annotazione degli strumenti:

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

Memorie della documentazione: Aggiungere un documento alla Knowledge Base

Questo strumento aggiunge un documento alla Knowledge Base dell'agente SRE in base al nome. Si carica il contenuto markdown (*.md) e lo strumento lo indicizza per il recupero delle informazioni basate sulla generazione aumentata (RAG). Usare nomi chiari e descrittivi per trovare facilmente i documenti.

Alcuni prompt di esempio includono:

  • Aggiungi un documento denominato "incident-runbook" con il contenuto "Runbook: passaggi per gestire il triage di un'interruzione del servizio e contattare il reperibile" alla knowledge base dell'agente SRE.
Parametro Obbligatorio o facoltativo Descrizione
Content Obbligatorio Contenuto del documento da aggiungere alla Knowledge Base.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Memorie della documentazione: Eliminare il documento della Knowledge Base

Specificare il documento in base al nome. Questo strumento elimina un documento della Knowledge Base dopo la conferma. L'eliminazione è permanente e non può essere annullata. Verificare che il documento esista prima di eseguire questo strumento.

Alcuni prompt di esempio includono:

  • Eliminare il documento della Knowledge Base con nome 'sre-kb-doc-01' dall'agente SRE 'sre-agent-westus' con 'confirm' impostato su 'true'.
Parametro Obbligatorio o facoltativo Descrizione
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Memorie della documentazione: elencare i documenti della Knowledge Base indicizzati

Questo strumento elenca tutti i documenti della Knowledge Base indicizzati archiviati in memoria da un agente SRE. Restituisce ogni nome del documento e i relativi metadati, senza filtri di ricerca o query. L'esplorazione della Knowledge Base completa consente di individuare i documenti disponibili prima di eseguire ricerche mirate.

Alcuni prompt di esempio includono:

  • "Ottenere un elenco completo di tutti i documenti della Knowledge Base indicizzati archiviati nella memoria di SRE Agent 'sre-agent-prod' senza filtrare".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Memorie della documentazione: Reindex Knowledge Base

Questo strumento attiva una reindicizzazione di una knowledge base. Usarlo per rielaborare i documenti archiviati, aggiornare gli incorporamenti e ricompilare gli indici di ricerca in modo che i risultati della ricerca riflettano le modifiche recenti ai contenuti e ai metadati. Il tempo di reindicizzazione dipende dalle dimensioni del set di dati e dal carico del server. L'operazione può richiedere minuti o più tempo. Dopo l'avvio dello strumento, monitora l'avanzamento della reindicizzazione tramite gli endpoint di gestione del server.

Alcuni prompt di esempio includono:

  • "Reindicizzare i documenti della Knowledge Base per l'agente SRE "sre-agent-westus".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Memorie della documentazione: Knowledge Base di ricerca

Questo strumento esegue una ricerca nella Knowledge Base dell'agente SRE usando la ricerca semantica e restituisce i documenti più rilevanti per la query. Consente di trovare i passaggi di risoluzione dei problemi, i runbook, i postmortems e i playbook di monitoraggio correlati a eventi imprevisti o avvisi.

Alcuni prompt di esempio includono:

  • "Cercare la "latenza di I/O su disco" nella knowledge base dell'agente SRE."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Query Obbligatorio Query di ricerca usata per trovare i documenti della Knowledge Base pertinenti.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: elimina hook

Questo strumento elimina un hook da una risorsa agente SRE Azure.

Alcuni prompt di esempio includono:

  • Elimina l'hook denominato 'backup-trigger' dall'agente SRE 'sre-agent-prod' con conferma 'true'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: Ottieni i dettagli

Questo strumento restituisce i dettagli per un hook configurato in una risorsa agente SRE Azure. È possibile esaminare la configurazione dell'hook, controllarne lo stato corrente e confermare le impostazioni del trigger o gli endpoint di destinazione.

Alcuni prompt di esempio includono:

  • "Mostra i dettagli dell'hook "deploy-hook" nell'agente SRE "sre-agent-prod".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: elenco degli hook

Elenca gli hook configurati in una risorsa Azure SRE Agent. Usare questo strumento per visualizzare i nomi degli hook, i tipi di hook e il relativo stato corrente per un agente specificato. Usare l'output per controllare gli hook di distribuzione, monitoraggio e pulizia che si applicano a Agent.

Alcuni prompt di esempio includono:

  • "Elencare gli hook configurati per l'agente SRE "sre-agent-prod".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: attiva il thread degli hook

Questo strumento attiva un hook su richiesta per un thread su una risorsa agente SRE Azure. Attiva immediatamente le azioni configurate dell'hook.

Alcuni prompt di esempio includono:

  • Attiva l'hook 'health-check' sul thread 'thread-42' dell'agente SRE 'sreagent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome dell'hook Obbligatorio Il nome dell'hook.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: disattivare il thread hook

Questo strumento disattiva un hook on-demand per un thread in una risorsa Agente SRE di Azure. Specificare l'agente, il nome dell'hook e l'ID del thread per identificare l'hook e il thread di destinazione. Lo strumento impedisce l'esecuzione dell'hook nel thread specificato senza rimuovere la configurazione dell'hook. Per applicare la modifica, sono necessarie le autorizzazioni appropriate per la risorsa agente SRE di Azure.

Alcuni prompt di esempio includono:

  • Disattiva l'hook 'on-demand-restart' sul thread con ID 'thread-7' dell'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome dell'hook Obbligatorio Il nome dell'hook.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Hook: elencare lo stato del thread hook

Questo strumento elenca lo stato di attivazione dell'hook per un thread su una risorsa Azure SRE Agent. Restituisce se gli hook sono abilitati, disabilitati o in sospeso per il thread specificato. Usare i risultati per verificare la configurazione degli hook e risolvere i problemi relativi al comportamento del thread.

Alcuni prompt di esempio includono:

  • Elenca gli stati di attivazione degli hook per il thread ID 'thread-42' sull'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Eventi imprevisti: elencare gli eventi imprevisti attivi

Questo strumento elenca gli incidenti attivi in un agente di Site Reliability Engineering (SRE). Restituisce thread di eventi imprevisti aperti con titolo, stato, servizi interessati e dettagli di indagine. Usare l'output per esaminare le indagini in corso e verificare quali servizi sono interessati.

Alcuni prompt di esempio includono:

  • Elenca gli incidenti attivi per l'agente SRE "sre-agent-west".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Eventi imprevisti: creare un evento imprevisto

Usare questo strumento per creare un thread di analisi degli eventi imprevisti per un agente. È possibile registrare i dettagli dell'evento imprevisto, associare i servizi interessati e impostare la gravità per dare priorità alla risposta. È possibile specificare la descrizione, i servizi, la gravità e il titolo dell'evento imprevisto quando si esegue questo strumento.

Alcuni prompt di esempio includono:

  • "Creare un evento imprevisto con titolo "Picco di latenza del database", descrizione "Latenza elevata osservata nelle letture SQL", servizi "payments-api, auth-service", gravità "alta", agente "sre-agent-westus".
Parametro Obbligatorio o facoltativo Descrizione
Descrizione Obbligatorio Descrizione dell'elemento dell'agente SRE.
Servizi Obbligatorio Nomi di servizio interessati.
Severity Obbligatorio Gravità dell'evento imprevisto: critica, alta, media o bassa.
Titolo Obbligatorio Titolo incidente
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Eventi imprevisti: Creare un piano

Questo strumento crea e abilita un piano di risposta agli eventi imprevisti che usa un filtro per definire gli eventi imprevisti e un gestore per definire i passaggi di risposta. Specifica i metadati del piano, i servizi da monitorare, la gravità, le fasi di risposta e una condizione di attivazione. Questo strumento convalida l'input e attiva il piano in modo che inizi a gestire gli eventi imprevisti corrispondenti.

Alcuni prompt di esempio includono:

  • Crea e abilita il piano di risposta agli incidenti Nome 'db-failover-plan' Servizi 'payments-api' Gravità 'critica' Passaggi 'avvisa il reperibile;esegui il failover del database' Condizione di attivazione 'connessione al database persa'.
Parametro Obbligatorio o facoltativo Descrizione
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Servizi Obbligatorio Nomi di servizio interessati.
Severity Obbligatorio Gravità dell'evento imprevisto: critica, alta, media o bassa.
Passi Obbligatorio Passaggi di risposta agli eventi imprevisti.
Condizione del trigger Obbligatorio Testo che attiva il piano di risposta agli eventi imprevisti.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Modalità agente Optional Modalità agente: autonoma o revisione.
Escalation Optional Procedura di escalation.
Runbook URL Optional URL del runbook.

Suggerimenti per l'annotazione degli strumenti:

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

Eventi imprevisti: elencare i piani

Questo strumento elenca i piani di risposta agli eventi imprevisti configurati in un agente SRE. È possibile visualizzare il nome, l'ID e lo stato di ogni piano. Queste informazioni consentono di identificare i piani attivi e di esaminarne la configurazione.

Alcuni prompt di esempio includono:

  • "Elencare i piani di risposta agli eventi imprevisti configurati nell'agente SRE 'sre-agent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Incidenti: Connetti l'agente a PagerDuty

Connettere un agente SRE (Site Reliability Engineering) a PagerDuty. Questo strumento crea un connettore PagerDuty che consente la gestione degli avvisi e degli eventi imprevisti. Il connettore usa una chiave API archiviata in una variabile di ambiente.

Alcuni prompt di esempio includono:

  • "Connettere l'agente SRE 'sre-agent-prod' a PagerDuty con chiave API env 'PAGERDUTY_API_KEY' e nome 'pagerduty-connector'."
Parametro Obbligatorio o facoltativo Descrizione
Chiave API env Obbligatorio Variabile di ambiente contenente la chiave API.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Sottodominio Optional Sottodominio PagerDuty.

Suggerimenti per l'annotazione degli strumenti:

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

Eventi imprevisti: configurare il connettore ServiceNow

Questo strumento crea un connettore MCP ServiceNow che consente l'integrazione della gestione degli eventi imprevisti. Usa le credenziali archiviate nelle variabili di ambiente e abilita la creazione, gli aggiornamenti e la risoluzione degli eventi imprevisti tra ServiceNow e l'agente SRE.

Alcuni prompt di esempio includono:

  • Connetti l'agente SRE a ServiceNow con il tipo di autenticazione 'basic', URL dell'istanza 'https://my-resource.service-now.com', nome 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Tipo di autenticazione Obbligatorio Tipo di autenticazione del connettore MCP HTTP.
URL dell'istanza Obbligatorio URL dell'istanza di ServiceNow.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Password env Optional Variabile di ambiente contenente la password.
Token env Optional Variabile di ambiente contenente il token di connessione.
Nome utente env Optional Variabile di ambiente contenente nome utente.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: Creare un'attività pianificata

Questo strumento crea un'attività pianificata per un agente SRE. Invia un messaggio specificato nella pianificazione definita con un'espressione cron, in modo che l'agente possa eseguire il lavoro automatizzato. Fornisci i dettagli dell'attività quando crei l'attività pianificata.

Alcuni prompt di esempio includono:

  • Pianifica un'attività ricorrente sull'agente SRE 'sre-agent-west' che viene eseguita ogni lunedì con l'espressione cron '0 9 * * 1', nome 'weekly-restart' e messaggio 'Riavvia il servizio'.
Parametro Obbligatorio o facoltativo Descrizione
Espressione CRON Obbligatorio L'espressione cron per la pianificazione.
Message Obbligatorio Il prompt dell'agente viene eseguito secondo la pianificazione definita.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Descrizione Optional Descrizione dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: Eliminare un'attività pianificata

Questo strumento elimina un'attività pianificata dell'agente SRE.

Alcuni prompt di esempio includono:

  • Eliminare l'attività pianificata 'task-12345' dall'agente SRE 'sre-agent-west' con il parametro di conferma impostato su 'true'.
Parametro Obbligatorio o facoltativo Descrizione
ID attività Obbligatorio L'ID dell'attività pianificata.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: Ottieni attività pianificata

Questo strumento recupera un'attività pianificata dell'agente SRE in base all'ID attività. È possibile visualizzare i dettagli, ad esempio la configurazione dell'attività e lo stato corrente.

Alcuni prompt di esempio includono:

  • "Mostra l'attività pianificata con ID attività 'task-1234' nell'agente SRE 'sre-agent-west'".
Parametro Obbligatorio o facoltativo Descrizione
ID attività Obbligatorio L'ID dell'attività pianificata.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: elencare le attività pianificate

Questo strumento elenca le attività pianificate gestite dall'agente SRE. È possibile esaminare i processi pianificati, confermare le pianificazioni e visualizzare i metadati delle attività, ad esempio lo stato, l'ora di esecuzione successiva e l'ultima esecuzione. Questo strumento restituisce un elenco di sola lettura di attività pianificate con campi per il nome dell'attività, lo stato, la pianificazione, l'ora di esecuzione successiva e l'ultima esecuzione.

Alcuni prompt di esempio includono:

  • Elenca le attività pianificate sull'agente SRE 'sre-agent-01'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: Sospendere l'attività pianificata

Sospende un'attività pianificata per un agente SRE (Site Reliability Engineering). Questo strumento restituisce lo stato aggiornato dell'attività e i metadati correlati. Sospendere le attività pianificate per arrestare temporaneamente l'attività automatizzata durante la manutenzione o la risoluzione dei problemi.

Alcuni prompt di esempio includono:

  • "Sospendere l'attività pianificata con ID attività 'task-1234' nell'agente SRE 'sre-agent-west'."
Parametro Obbligatorio o facoltativo Descrizione
ID attività Obbligatorio L'ID dell'attività pianificata.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Attività pianificate: Riprendere l'attività pianificata

Questo strumento riprende un'attività pianificata per un agente SRE. Dopo aver eseguito lo strumento, l'agente riprende a eseguire l'attività pianificata in base alla pianificazione prevista.

Alcuni prompt di esempio includono:

  • Riprendi l'attività pianificata con l'ID attività 'task-123' sull'agente SRE 'sre-agent-west'.
Parametro Obbligatorio o facoltativo Descrizione
ID attività Obbligatorio L'ID dell'attività pianificata.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Competenze: Creare una competenza

Questo strumento crea o aggiorna una competenza personalizzata in una risorsa agente SRE di destinazione.

Alcuni prompt di esempio includono:

  • "Aggiungere una nuova competenza con nome 'auto-scale-skill' all'agente SRE 'sreagent-prod' con contenuto '{"type":"script","script":"scale.sh"}'".
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Content Obbligatorio Contenuto delle competenze.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Descrizione Optional Descrizione dell'elemento dell'agente SRE.

Suggerimenti per l'annotazione degli strumenti:

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

Competenze: Elimina competenza

Questo strumento elimina una competenza personalizzata da una risorsa agente SRE.

Alcuni prompt di esempio includono:

  • Elimina la skill denominata 'error-logger' dall'agente SRE 'sre-agent-west' con conferma 'true'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Conferma Obbligatorio Confermare un'operazione distruttiva.

Suggerimenti per l'annotazione degli strumenti:

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

Competenze: elencare le competenze

Elenca le competenze personalizzate su una risorsa Agente SRE specifica. Lo strumento restituisce i dettagli per ogni competenza personalizzata registrata nell'agente SRE specificato, inclusi nome, versione e stato. Usare l'output per esaminare o controllare le configurazioni personalizzate delle competenze.

Alcuni prompt di esempio includono:

  • Elenca tutti gli skill disponibili nell'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: Crea un thread

Questo strumento crea un nuovo thread in un agente SRE (Site Reliability Engineering) e avvia una conversazione inviando il messaggio di apertura. Restituisce la risposta iniziale dell'agente.

Alcuni prompt di esempio includono:

  • Avvia un nuovo thread con l'agente SRE "sre-agent-01" con il messaggio "Indaga sull'aumento della latenza nel gateway API".
Parametro Obbligatorio o facoltativo Descrizione
Message Obbligatorio Messaggio da inviare.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: Elimina thread

Questo strumento elimina un thread dell'agente SRE (Site Reliability Engineering).

Alcuni prompt di esempio includono:

  • Elimina l'ID del thread 'thread-12345' dall'agente SRE 'sreagent-prod' con conferma 'true'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Conferma Obbligatorio Confermare un'operazione distruttiva.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: Ottenere messaggi

Questo strumento ottiene i messaggi per un thread specifico dell'agente SRE e restituisce il contenuto e i metadati dei messaggi, ad esempio timestamp e identità del mittente. Usare i messaggi restituiti per esaminare la cronologia delle conversazioni o risolvere i problemi relativi al comportamento dell'agente.

Alcuni prompt di esempio includono:

  • Mostra i messaggi per l'ID del thread '42' nell'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: modalità YOLO

Questo strumento avvia un'analisi sull'agente SRE specificato e approva tutte le richieste di approvazione in sospeso, consentendo così all'agente di procedere senza passaggi di approvazione manuale. Lo strumento registra le azioni di indagine e le approvazioni concesse per il controllo.

Alcuni prompt di esempio includono:

  • Analizzare con il messaggio "Investigare l'arresto anomalo del servizio nel frontend" sull'agente SRE 'sre-agent-prod' in modalità yolo, approvando automaticamente tutte le approvazioni in sospeso.
Parametro Obbligatorio o facoltativo Descrizione
Message Obbligatorio Messaggio da inviare.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Numero massimo di iterazioni Optional Numero massimo di iterazioni di completamento automatico.
Timeout secondi Optional Timeout dell'indagine in secondi.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: analizzare l'evento imprevisto

Analizzare un problema o un evento imprevisto con un agente SRE (Site Reliability Engineering). Usa questo strumento per inviare un messaggio per l'indagine e l'agente pone domande di approfondimento finché l'indagine non è completata. Specificare i dettagli dell'indagine nel messaggio. Includere contesto pertinente, ad esempio risorse interessate, timestamp, messaggi di errore, modifiche recenti alla configurazione e passaggi da riprodurre. Mantenere i messaggi concisi e concentrati per aiutare l'agente a raggiungere una risoluzione più efficiente.

Alcuni prompt di esempio includono:

  • "Analizzare il problema seguente con l'agente SRE 'sre-agent-prod': messaggio "API primaria che restituisce 500 errori dopo la distribuzione".
Parametro Obbligatorio o facoltativo Descrizione
Message Obbligatorio Messaggio da inviare.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Numero massimo di iterazioni Optional Numero massimo di iterazioni di completamento automatico.
Timeout secondi Optional Timeout dell'indagine in secondi.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: elencare i thread di chat dell'agente

Questo strumento elenca i thread di chat dell'agente SRE. Restituisce un elenco di sola lettura di oggetti thread che includono l'ID thread, i partecipanti, i metadati e il messaggio più recente, in modo da poter esaminare le conversazioni attive e precedenti.

Alcuni prompt di esempio includono:

  • "Elencare i thread attivi nell'agente SRE 'sreagent-prod'."
Parametro Obbligatorio o facoltativo Descrizione
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Thread: inviare un messaggio al thread

Questo strumento invia un messaggio a un thread dell'agente SRE (Site Reliability Engineering) esistente. Invia il messaggio specificato al thread e restituisce lo stato aggiornato del thread. Usare messaggi concisi per aggiungere contesto, aggiornamenti dello stato o note sulla risoluzione dei problemi a un thread in corso.

Alcuni prompt di esempio includono:

  • Invia il messaggio 'Riavvio completato, monitoraggio dei log' all'ID del thread 'thread-12345' sull'agente 'sre-agent-westus'.
Parametro Obbligatorio o facoltativo Descrizione
Message Obbligatorio Messaggio da inviare.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.
Thread ID Obbligatorio ID del thread di SRE Agent.

Suggerimenti per l'annotazione degli strumenti:

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

Flussi di lavoro: applicare e distribuire il flusso di lavoro

Applicare e distribuire un flusso di lavoro YAML a un agente SRE. Questo strumento carica e attiva la configurazione YAML di ExtendedAgent o ExtendedAgentTool sulla risorsa SRE Agent specificata.

Alcuni prompt di esempio includono:

  • Applica il workflow YAML con contenuto 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow' all'agente SRE 'sre-agent-prod'.
Parametro Obbligatorio o facoltativo Descrizione
Contenuto YAML Obbligatorio Contenuto YAML.
Agente Obbligatorio Nome della risorsa Azure SRE Agent da usare come destinazione.

Suggerimenti per l'annotazione degli strumenti:

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

Flussi di lavoro: generare la definizione del flusso di lavoro

Generare una definizione del flusso di lavoro YAML per uno strumento o un agente SRE (Site Reliability Engineering) denominato. Questo strumento crea la configurazione YAML validata per le risorse ExtendedAgent, KustoTool e LinkTool. Il flusso di lavoro generato consente di distribuire e gestire gli strumenti dell'agente SRE in modo coerente in tutti gli ambienti.

Alcuni prompt di esempio includono:

  • Genera un flusso di lavoro YAML con descrizione 'Strumento di query Kusto per la ricerca di incidenti', tipo 'tool', nome 'kusto-search-tool'.
Parametro Obbligatorio o facoltativo Descrizione
Descrizione Obbligatorio Descrizione dell'elemento dell'agente SRE.
Kind Obbligatorio Tipo YAML: agente o strumento.
Nome Obbligatorio Nome dell'elemento dell'agente SRE.
Connettore Optional Nome del connettore per gli strumenti Kusto.
Nome del database Optional Database Kusto per gli strumenti Kusto.
Modello o tipo Optional Tipo di strumento, ad esempio KustoTool o LinkTool.
Parametri Optional Parametri come nome:descrizione.
Query Optional Query Kusto per gli strumenti Kusto.
Strumenti Optional Nomi degli strumenti da allegare. Sono supportati più valori.
Handoff Optional Nomi dei passaggi di consegne dei subagenti. Sono supportati più valori.
modello URL Optional Modello di URL per gli strumenti di collegamento.

Suggerimenti per l'annotazione degli strumenti:

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

Flussi di lavoro: convalidare il flusso di lavoro

Questo strumento convalida il flusso di lavoro dell'agente SRE YAML e contrassegna i problemi comuni nella struttura e nella sintassi. Verifica la presenza di codice YAML non valido, passaggi in formato non valido, stringhe non corrette run e chiavi necessarie mancanti. Si specifica YAML contente lo strumento restituisce i problemi identificati con i numeri di riga e le correzioni suggerite. Vedere l'esempio seguente per un errore tipico rilevato dallo strumento.

Alcuni prompt di esempio includono:

  • Convalida il seguente contenuto YAML del flusso di lavoro dell'agente SRE 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow'.
Parametro Obbligatorio o facoltativo Descrizione
Contenuto YAML Obbligatorio Contenuto YAML.

Suggerimenti per l'annotazione degli strumenti:

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

Contenuti correlati

  • Last updated on