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.
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 .
Come funzionano le competenze
Una competenza combina le conoscenze con gli strumenti facoltativi.
| Componente | Scopo |
|---|---|
| SKILL.md | Indicazioni procedurali che l'agente segue |
| Strumenti | Azure CLI, query Kusto, script Python che l'abilità può eseguire |
| File di supporto | Manuale operativo, documentazione architettonica, materiale di riferimento |
Suggerimento
I subagenti richiedono chiamate esplicite: è necessario digitarle /agent database-expert per usarle.
Le competenze vengono caricate automaticamente dall'agente quando pertinente. Poni la domanda in modo naturale e l'agente decide se caricare un'abilità in base alla tua richiesta. Non /skill è necessario alcun comando.
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.
Confrontare competenze, subagenti e file di conoscenza
La tabella seguente confronta le competenze con altri concetti di estendibilità:
| Feature | Competenze | Subagenti | File di conoscenza |
|---|---|---|---|
| Access | Automatico |
/agent comando |
Tramite lo strumento di query KB |
| Strumenti | Può allegare | Dispone di strumenti | Nessun strumento |
| Purpose | Procedure più esecuzione | Specialisti focalizzati | Contenuto di riferimento |
| migliore per | Procedure a livello di team | Esperti di dominio su richiesta | Runbook, documentazione |
Creare competenze
Creare competenze in Builder > Generatore subagente. Una competenza include un SKILL.md file 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 strumento di selezione degli strumenti come i subagenti. È possibile associare qualsiasi combinazione dei tipi di strumenti seguenti:
| Tipo di strumento | Examples |
|---|---|
| Interfaccia della riga di comando di Azure |
RunAzCliReadCommands, RunAzCliWriteCommands, GetAzCliHelp |
| Kusto/Log Analytics | Query di Kusto personalizzate per ADX o Log Analytics |
| Python | Script Python personalizzati per l'elaborazione dati o le chiamate API |
| MCP | Strumenti dai server MCP connessi |
| Link | Modelli di URL per sistemi esterni |
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:
| Constraint | Valore |
|---|---|
| Competenze attive | Massimo cinque connessioni simultanee |
| Ciclo di vita delle competenze | Elemento meno recente scaricato automaticamente quando viene superato il limite |
| Reimpostazione del contesto | Competenze attive chiare sulla reimpostazione della conversazione |
| Accesso agli strumenti | Disponibile solo quando la competenza è attiva |
Se sono necessari strumenti di una competenza dopo che il bot scarica la competenza, rileggere il SKILL.md file per riattivarlo.
Relazione tra le competenze e altri concetti
Il tuo agente principale utilizza le competenze. È anche possibile abilitare le competenze per i subagenti impostando la enableSkills proprietà su true. Le competenze funzionano tramite strumenti. Collegando gli strumenti in base al nome, è possibile fornire le funzionalità effettive.