Esercitazione: Creare un'abilità nell'agente di SRE di Azure

In questa esercitazione si crea una competenza personalizzata che aggiunge conoscenze specifiche del dominio e playbook di attività all'agente. Le competenze sono funzionalità modulari che l'agente carica automaticamente quando pertinente, ad esempio la risoluzione dei problemi di un servizio specifico o l'esecuzione di una procedura di diagnostica.

In questa esercitazione apprenderai a:

  • Creare un'abilità nel generatore di subagenti
  • Scrivere istruzioni sulle competenze in SKILL.md
  • Aggiungere file e strumenti di supporto
  • Testare l'abilità in una chat o in un ambiente di prova.
  • Modificare una competenza esistente

Tempo stimato: 10 minuti

Suggerimento

Le competenze e i documenti di conoscenza interagiscono. Una competenza insegna all'agente come eseguire un'operazione (procedure, playbook, istruzioni dettagliate). Un documento di knowledge base illustra all'agente ciò che deve conoscere (dati di riferimento, documentazione dell'architettura, runbook). È anche possibile allegare documenti di riferimento direttamente a una competenza come file di supporto. Per il flusso di caricamento delle informazioni, vedere Caricare i documenti delle informazioni.

Prerequisiti

Prima di iniziare, verificare di aver soddisfatto i prerequisiti seguenti:

  • Agente creato nel portale dell'agente SRE di Azure.
  • Conoscenza chiara della procedura o della conoscenza del dominio da codificare.

Aprire il generatore di subagent in cui si creano e si gestiscono le competenze.

  1. Aprire il portale dell'agente SRE.
  2. Seleziona il tuo agente.
  3. Selezionare Builder nel riquadro di spostamento a sinistra.
  4. Selezionare Generatore subagente.

Avviare la creazione di competenze

Avviare il processo di creazione delle competenze dalla barra degli strumenti.

  1. Selezionare l'elenco a discesa Crea sulla barra degli strumenti.
  2. Selezionare Competenza.

Viene visualizzata la finestra di dialogo per la creazione di una funzionalità con un layout a due colonne. Campi del modulo su un lato e un editor di codice sull'altro che mostra SKILL.md.

Immettere il nome e la descrizione

Specificare un nome e una descrizione che consentono all'agente di decidere quando usare questa competenza.

Campo Valore di esempio
Nome high-cpu-troubleshooting
Descrizione Procedura di risoluzione dei problemi per gli avvisi di utilizzo elevato della CPU nelle applicazioni container. Controlla le dipendenze upstream, il pool di connessioni e le distribuzioni recenti."

Il nome deve essere univoco tra tutte le tue abilità. La descrizione viene visualizzata nell'elenco delle competenze e aiuta l'agente a decidere quando usare questa competenza.

Suggerimento

Selezionare Modifica accanto al testo della descrizione per passare alla modalità di modifica. Al termine, selezionare Salva .

Scrivere istruzioni per le competenze

L'editor al centro mostra SKILL.md, che contiene le istruzioni dell'abilità. Il file inizia con un modello predefinito.

---
name:
description:
---

<!-- Add your skill instructions here -->

L'intestazione YAML (name, description, tools) è sincronizzata con i campi del modulo a sinistra. Scrivi le tue istruzioni in Markdown sotto la prima questione:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Aggiungere file di supporto

La sezione File su un lato mostra un browser di file. Oltre all'impostazione predefinita SKILL.md, è possibile aggiungere dati di riferimento, modelli e query di esempio.

  • Selezionare l'icona del nuovo file per aggiungere file.
  • Selezionare l'icona della nuova cartella per organizzare i file in directory.
  • Trascinare e rilasciare una cartella nell'area di rilascio oppure selezionare il collegamento Carica cartella per caricare un'intera struttura di cartelle.

Selezionare qualsiasi file nel browser per modificarlo nell'editor di codice. L'editor supporta l'evidenziazione della sintassi per gli script Markdown, JSON, YAML, KQL, Python e shell.

Selezionare gli strumenti

Opzionalmente, allegare gli strumenti usati dall'abilità durante l'esecuzione.

  1. Selezionare Scegli strumenti nella sezione Strumenti .
  2. Esplora o cerca strumenti. Filtra per tipo (strumento personalizzato, strumento MCP) o cerca per nome.
  3. Controllare gli strumenti necessari per questa competenza , ad esempio kusto_query o azure_resource_health.
  4. Chiudere il pannello.

Gli strumenti selezionati vengono visualizzati come pillole rimovibili. Questi strumenti sono disponibili dinamicamente quando la competenza viene attivata.

Annotazioni

Gli strumenti aggiunti a una competenza sono disponibili in modo dinamico quando la competenza viene attivata. Per un comportamento più coerente, configurare gli strumenti direttamente nel subagent.

Per creare strumenti personalizzati, vedere Creare uno strumento Kusto o Creare uno strumento Python. Per altre informazioni sugli strumenti, vedere Strumenti.

Creare la competenza

Selezionare Crea per salvare l'abilità.

La competenza viene visualizzata nella scheda Competenze del generatore di subagent. L'agente può ora usare automaticamente la competenza quando si verifica una situazione rilevante.

Testare la competenza

L'agente principale può usare le competenze per impostazione predefinita, in modo da poterle testare direttamente nella chat senza prima creare un subagente.

Testare in una nuova chat

Usare un nuovo thread di chat per verificare che l'agente attivi l'abilità.

  1. Selezionare Nuovo thread di chat nella barra laterale.
  2. Digitare un prompt per attivi la competenza. Ad esempio: "Stiamo osservando un alto utilizzo della CPU nella nostra applicazione container, è possibile esaminare?"
  3. Verificare che l'agente attivi l'abilità e segua le procedure da voi definite.

Test nell'area giochi

Usare il playground per testare le competenze tramite un sottoagente.

  1. Creare un subagente e assegnarvi questa competenza.
  2. Sulla barra degli strumenti del builder di subagenti, selezionare l'interruttore di visualizzazione Testa playground.
  3. Selezionare il subagente, digitare un prompt di test e verificare che usi correttamente l'abilità.

Per altre informazioni, vedere Agent playground.

Modificare una competenza

È possibile modificare una competenza esistente per aggiornare le istruzioni, gli strumenti o i file di supporto.

  1. Nella scheda Competenze selezionare il nome della competenza o selezionarlo e scegliere Modifica.

  2. Viene visualizzata la finestra di dialogo di modifica con tutti i valori correnti prepopolati. Modificare i campi necessari:

    Cosa modificare Dove aggiornare
    Quando l'agente lo usa Descrizione e istruzioni SKILL.md
    Quali procedure seguire contenuto di SKILL.md nell'editor
    Quali strumenti sono disponibili Strumenti> Scegliere gli strumenti
    Dati di riferimento File> aggiungere, modificare o rimuovere file

  3. Seleziona Salva.

Suggerimenti per redigere competenze efficaci

Usare le linee guida seguenti per creare competenze che l'agente può usare in modo efficace.

  • Specificare quando usarlo. L'agente legge la descrizione e le istruzioni per decidere la pertinenza.
  • Includere procedure dettagliate. I passaggi numerati forniscono all'agente un chiaro playbook.
  • Specificare l'output previsto. Indicare all'agente in quale formato devono essere presentati i risultati.
  • Aggiungere dati di riferimento. Caricare modelli di query, linee di base di configurazione o valori validi noti come file di supporto.
  • Assegnare gli strumenti pertinenti. Se la competenza richiede strumenti specifici come le query Kusto o le azioni di Azure, aggiungerle.

Passo successivo

Informazioni sulle competenze

Contenuti correlati

  • Last updated on