Competenze nell'agente SRE di Azure

Le competenze estendono l'agente con le procedure e le funzionalità di esecuzione. È possibile aggiungere una guida alla risoluzione dei problemi, collegare strumenti come l'interfaccia della riga di comando di Azure, query Kusto, script Python o connettori MCP e l'agente li carica quando pertinente alla domanda dell'utente. L'agente non richiede un comando esplicito /skill .

È anche possibile caricare documenti di knowledge base, ad esempio runbook, guide all'architettura e materiale di riferimento per creare una knowledge base che l'agente cerca automaticamente. Per altre informazioni, vedere Memoria e conoscenze.

Competenze, agenti personalizzati e file di conoscenza

Questi tre concetti interagiscono ma servono scopi diversi:

Sia l'agente principale sia gli agenti personalizzati possono usare le competenze. Quando si crea un agente personalizzato in Builder>Agent Canvas, selezionare le competenze a cui può accedere. Scegliere le competenze direttamente dal pannello Scegli competenze nella finestra di dialogo di creazione dell'agente personalizzato.

In YAML usare allowed_skills per specificare le competenze a cui un agente personalizzato può accedere. L'impostazione allowed_skills abilita automaticamente le competenze per quell'agente.

name: database_expert
system_prompt: |
  You are a database specialist.
allowed_skills:
  - postgres-troubleshooting
  - connection-pool-guide
tools:
  - execute_kusto_query

Come funzionano le competenze

Una competenza combina le conoscenze con gli strumenti facoltativi.

L'agente decide quale abilità caricare in base alla descrizione dell'abilità e alla tua domanda. L'agente legge le descrizioni delle competenze nella richiesta di sistema e carica automaticamente la competenza più pertinente leggendo il file SKILL.md . L'agente non richiede un comando esplicito.

Perché usare le competenze

Senza competenze, l'agente si basa sulle proprie conoscenze predefinite. Questo approccio funziona per le operazioni generali di Azure, ma non prevede procedure specifiche del team.

Usando le competenze, è possibile aggiungere:

• Flussi di lavoro per la risoluzione dei problemi: guide dettagliate per i sistemi
• Funzionalità di esecuzione: strumenti che eseguono comandi, non solo descriverli
• Contesto organizzativo: documentazione sull'architettura, convenzioni di naming, percorsi di escalation

Le competenze trasformano l'agente da un assistente generale a un membro del team che sa come si opera.

Creare competenze

Creare competenze in Builder > Competenze. Una competenza include un file SKILL.md con indicazioni procedurali e allegati facoltativi degli strumenti per l'esecuzione.

L'esempio seguente illustra una struttura di competenza tipica:

name: aks-troubleshooting-guide
description: Use when investigating AKS or Kubernetes issues
files:
  - SKILL.md
tools:
  - RunAzCliReadCommands

L'agente applica automaticamente le indicazioni sulle competenze quando rileva problemi rilevanti ed esegue strumenti collegati per raccogliere informazioni.

Collegare gli strumenti

Le competenze usano lo stesso selettore di strumenti degli agenti personalizzati. È possibile associare qualsiasi combinazione dei tipi di strumenti seguenti:

Quando si associa RunAzCliReadCommands a una capacità di risoluzione dei problemi in AKS, il tuo agente non sa solo come risolvere i problemi. Può effettivamente eseguire i comandi.

Limiti e vincoli

La tabella seguente descrive i vincoli che si applicano alle competenze:

Se sono necessari gli strumenti di un'abilità dopo che viene scaricata, l'agente rilegge il SKILL.md file per riattivare l'abilità.

Contenuti correlati