Condividi tramite

competenze dell'agente Azure

Azure Agent Skills è un catalogo di competenze leggibili dall'intelligenza artificiale, sviluppato da Microsoft per lo sviluppo su Azure. Ogni competenza è un indice strutturato di contenuti autorevoli di Microsoft Learn, inclusi in un pacchetto, in modo che gli assistenti di codifica per intelligenza artificiale possano individuarlo e usarlo per fornire indicazioni accurate e up-to-date sui servizi di Azure.

Le competenze seguono l'open standard Agent Skills e funzionano con qualsiasi assistente alla codifica basato sull'intelligenza artificiale compatibile, tra cui GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI e altri.

Casi d'uso

  • Fornire agli assistenti per la scrittura del codice di intelligenza artificiale indicazioni di livello esperto Azure basate sulla documentazione ufficiale
  • Migliorare l'accuratezza e la completezza delle risposte degli agenti per Azure attività di sviluppo
  • Consentire agli sviluppatori di ottenere procedure consigliate, flussi di risoluzione dei problemi, modelli di architettura e indicazioni sulla sicurezza direttamente nell'editor
  • Fornire conoscenze strutturate e up-to-date che integrano strumenti di dati in tempo reale come server MCP

Funzionamento delle competenze dell'agente

Le competenze dell'agente sono moduli di funzionalità leggeri e basati su file system. Ogni competenza è una cartella contenente un file con frontmatter YAML (nome, descrizione, compatibilità) e contenuto strutturato organizzato per categoria (risoluzione dei problemi, procedure consigliate, architettura, sicurezza, configurazione e altro ancora).

Le competenze usano la divulgazione progressiva per caricare contenuti in modo efficiente:

  1. Individuazione: l'assistente IA legge e della competenza dal frontmatter YAML per determinare la pertinenza
  2. Istruzioni : quando viene attivato, l'assistente carica il contenuto completo , che contiene collegamenti alla documentazione curati organizzati per argomento
  3. Recupero : l'assistente recupera il contenuto più recente da Microsoft Learn usando il server MCP Learn o uno strumento di recupero Web

Questa architettura separa l'indice delle informazioni (cosa cercare e quando) dal recapito del contenuto (recuperando la documentazione più recente in fase di query), assicurando che le competenze rimangano aggiornate man mano che la documentazione si evolve.

Il catalogo delle competenze viene generato e gestito automaticamente da una pipeline predefinita che analizza Azure documentazione del prodotto, identifica contenuti procedurali e decisionali di alto valore e lo trasforma in file di competenze strutturati. La pipeline valuta continuamente le modifiche al contenuto upstream e produce aggiornamenti incrementali.

Catalogo delle competenze

Il repository contiene 193 competenze che coprono i servizi principali di Azure in queste categorie:

Categoria Competenze Examples
Infrastruttura e gestione 27 Azure Resource Manager, Backup, Monitoraggio, Criteri, Gestione costi, Arc
Specializzato/a 27 Quantum, Maps, VMware Solution, SAP, Health Data Services, Virtual Desktop
Rete 24 Rete virtuale, Frontdoor, Firewall, Gateway VPN, ExpressRoute, Load Balancer
Intelligenza artificiale e MACHINE Learning 20 Servizi di intelligenza artificiale, Machine Learning, intelligence sui documenti, riconoscimento vocale, servizio Bot
Dati e analisi 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Sicurezza e identità 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, pipeline, registro contenitori, ambienti di distribuzione, Dev Box
Calcolo 13 Funzioni, App contenitore, Macchine virtuali, Servizio Kubernetes, Servizio app
Integration 12 App per la logica, Gestione API, Griglia di eventi, bus di servizio, Hub eventi
Spazio di archiviazione 9 gestione rete virtuale di Azure, File, Elastic SAN, NetApp Files, Archiviazione su container
IoT & Edge 7 hub IoT, IoT Central, IoT Edge, operazioni IoT, Gemelli digitali

I bundle curati in base al ruolo sono disponibili per scenari comuni (Essentials, Infrastructure, Data Engineering, AI/ML, Security, DevOps).

Il catalogo completo delle competenze è disponibile in docs/CATALOG.md.

Requisiti

  • L'accesso alla rete è obbligatorio. URL della documentazione di Microsoft Learn sulle competenze che l'assistente IA recupera al momento della query.
  • Assistente di codifica IA compatibile che supporta lo standard aperto delle competenze dell'agente (formato ).
  • Consigliato: Server MCP di Microsoft Learn per il recupero ottimale della documentazione. Se il server Learn MCP non è disponibile, le competenze si appoggiano alle funzionalità di estrazione Web incorporate nella maggior parte degli assistenti di intelligenza artificiale.

Non è necessaria alcuna autenticazione per usare le competenze stesse. Le competenze sono file statici eseguiti localmente nell'ambiente di sviluppo.

Come iniziare

Installazione

  1. Clonare il repository:

    git clone https://github.com/MicrosoftDocs/agent-skills.git

  2. Copiare le cartelle delle competenze da alla directory delle competenze dell'assistente IA.

    Assistente intelligenza artificiale Percorso a livello di progetto Percorso globale
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Claude Code {project}/.claude/skills/ ~/.claude/skills/
    Interfaccia della riga di comando di Codex {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Interfaccia della riga di comando di Gemini {project}/.gemini/skills/ —

    Importante

    Copiare le cartelle all'interno ( ad esempio, , ), non la cartella stessa.

  3. Utenti di VS Code: Abilita chat: usare le competenze dell'agente () in Impostazioni.

  4. Iniziare a porre domande all'assistente di intelligenza artificiale Azure. Le competenze vengono attivate automaticamente in base alla query.

Utilizzo

Dopo l'installazione, porre domande all'assistente di intelligenza artificiale in modo naturale:

  • "Aiutami a configurare Funzioni di Azure con Durable Functions"
  • "Quali sono le procedure consigliate per App contenitore di Azure?"
  • "Ricevo errori di limitazione delle risorse nell'account di archiviazione: come eseguire la diagnosi di questo problema?"

L'assistente scoprirà automaticamente le competenze pertinenti, caricherà le linee guida strutturate e recupererà la documentazione più recente di Microsoft Learn per fornire risposte accurate e basate su base.

Compatibility

Queste competenze funzionano con qualsiasi assistente per la codifica di intelligenza artificiale che supporta la specifica delle competenze dell'agente:

Assistente per la codifica di intelligenza artificiale Tipo Percorso competenze
GitHub Copilot Estensione di VS Code .github/skills/
Claude Code Interfaccia della riga di comando di Anthropic .claude/skills/
Interfaccia della riga di comando di Codex OpenAI CLI (Interfaccia della riga di comando) .codex/skills/
Cursor IDE nativo dell'intelligenza artificiale .cursor/skills/
Interfaccia della riga di comando di Gemini Google DeepMind .gemini/skills/
Antigravity IDE DeepMind IDE .agent/skills/
OpenCode Interfaccia a riga di comando (CLI) open source .agent/skills/

Relazione con il server McP Learn

Le competenze dell'agente e learn MCP Server sono complementari:

  • Learn MCP Server fornisce strumenti per la ricerca, il recupero di dati e l'ottenimento di esempi di codice dal contenuto di Microsoft Learn.
  • Le competenze dell'agente forniscono informazioni : linee guida strutturate su cosa cercare, quando e come applicarlo

Le skill utilizzano il Learn MCP Server (o una funzionalità di recupero equivalente) come meccanismo di distribuzione dei contenuti. Insieme, forniscono agli assistenti di intelligenza artificiale sia il giudizio per identificare ciò che è rilevante e la possibilità di recuperare il contenuto autorevole più recente.

Disponibilità e prezzi

Azure Agent Skills è disponibile pubblicamente come repository open source con licenza doppia:

  • Contenuto della documentazione: Licenza Creative Commons Attribuzione 4.0 Internazionale
  • Codice: Licenza MIT

Non è previsto alcun addebito per l'uso delle competenze.

Limitazioni

  • Le competenze richiedono l'accesso alla rete per recuperare la documentazione da Microsoft Learn. Senza accesso alla rete, le competenze forniscono indici di collegamento curati, ma non possono recuperare il contenuto completo.
  • Il catalogo delle competenze copre attualmente 193 servizi Azure. La copertura si espande a ogni esecuzione della pipeline con la pubblicazione di nuova documentazione.
  • Le competenze vengono generate dalla documentazione di Microsoft Learn disponibile pubblicamente. Il contenuto dei moduli di formazione, dei percorsi di apprendimento e dei corsi con docente non è attualmente incluso.
  • La pipeline di generazione viene eseguita in modo incrementale. Potrebbe verificarsi un breve ritardo tra gli aggiornamenti della documentazione in Microsoft Learn e gli aggiornamenti delle competenze corrispondenti.

Come fornire commenti e suggerimenti

Passaggi successivi

  • Introduzione a Learn MCP Server in VS Code
  • Specifiche standard aperte per le competenze dell'agente
  • Repository Azure Agent Skills
  • Bundle di competenze curate per ruolo
  • Last updated on