Azure Agent Skills

Azure Agent Skills este un catalog first-party, creat de Microsoft, cu abilități lizibile de AI pentru dezvoltarea Azure. Fiecare abilitate este un index structurat al conținutului autoritar Microsoft Learn, ambalat astfel încât asistenții AI să îl poată descoperi și folosi pentru a oferi îndrumări precise, up-tola data actualizată, despre serviciile Azure.

Abilitățile urmează standardul deschis Agent Skills și funcționează cu orice asistent de codare AI compatibil, inclusiv GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI și altele.

Cazuri de utilizare

  • Oferă asistenților de programare AI îndrumare Azure la nivel de experți, bazate pe documentație oficială
  • Îmbunătățirea acurateței și completității răspunsurilor agenților pentru sarcinile de dezvoltare Azure
  • Permiteți dezvoltatorilor să obțină cele mai bune practici, fluxuri de depanare, modele de arhitectură și îndrumări de securitate direct în editorul lor
  • Oferă cunoștințe structurate, up-to-date, care să completeze instrumentele de date live precum serverele MCP

Cum funcționează abilitățile agenților

Abilitățile Agent sunt module ușoare, bazate pe sistemul de fișiere. Fiecare abilitate este un folder care conține un fișier cu frontmatter YAML (nume, descriere, compatibilitate) și conținut structurat organizat pe categorii (Depanare, Cele mai bune practici, Arhitectură, Securitate, Configurare și altele).

Competențele folosesc dezvăluirea progresivă pentru a încărca conținutul eficient:

  1. Descoperire — Asistentul AI citește competențele și din textul YAML pentru a determina relevanța
  2. Instrucțiuni — Când este declanșat, asistentul încarcă conținutul complet , care conține linkuri de documentație selectate, organizate pe teme
  3. Fetch — Asistentul preia cele mai noi conținuturi din Microsoft Learn folosind serverul Learn MCP sau un instrument de preluare web

Această arhitectură separă indexul de cunoștințe (ce să cauți și când) de livrarea conținutului (preluarea celor mai recente documente la momentul interogării), asigurând că abilitățile rămân actualizate pe măsură ce documentația evoluează.

Catalogul de abilități este generat și întreținut automat de un pipeline construit special care scanează documentația produselor Azure, identifică conținut procedural și decizional de mare valoare și îl transformă în fișiere de abilități structurate. Pipeline-ul evaluează continuu modificările de conținut din amonte și produce actualizări incrementale.

Catalog de abilități

Depozitul conține 193 de competențe acoperind serviciile de bază ale Azure în aceste categorii:

Categorie Competențe Exemple
Infrastructură și Management 27 Azure Resource Manager, Backup, Monitor, Policy, Cost Management, Arc
Specializate 27 Quantum, Hărți, Soluție VMware, SAP, Servicii de Date de Sănătate, Desktop Virtual
Networking 24 Virtual Network, Front Door, Firewall, VPN Gateway, ExpressRoute, Load Balancer
AI & ML 20 Servicii AI, Machine Learning, Inteligență documentară, Vorbire, Bot Service
Date & Analiză 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Securitate & Identitate 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, Pipelines, Container Registry, Deployment Environments, Dev Box
Compute 13 Funcții, Aplicații Container, Virtual Machines, Kubernetes Service, App Service
Integrare 12 Logic Apps, Managementul API-urilor, Event Grid, Service Bus, Event Hubs
Spațiu de stocare 9 Blob Storage, Fișiere, SAN elastic, NetApp Files, Container Storage
IoT & Edge 7 IoT Hub, IoT Central, IoT Edge, Operațiuni IoT, Gemeni Digitali

Sunt disponibile pachete selectate pe bază de roluri pentru scenarii comune (Essentials, Infrastructură, Inginerie de date, AI/ML, Securitate, DevOps).

Catalogul complet de abilități este disponibil la docs/CATALOG.md.

Cerințe

  • Este necesar accesul la rețea . Competențele fac referință la URL-urile documentației Microsoft Learn pe care asistentul AI le preia la interogare.
  • Un asistent de codare AI compatibil care suportă standardul deschis Agent Skills ( format).
  • Recomandat: Microsoft Learn MCP Server pentru recuperarea optimă a documentației. Dacă serverul Learn MCP nu este disponibil, abilitățile se bazează pe capabilități de preluare web integrate în majoritatea asistenților AI.

Nu este necesară autentificarea pentru a folosi abilitățile în sine. Abilitățile sunt fișiere statice care rulează local în mediul tău de dezvoltare.

Introducere

Instalare

  1. Clonează depozitul:

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

  2. Copiază folderele de abilități din directorul de abilități al asistentului tău AI:

    Asistent AI Traseul la nivel de proiect Calea globală
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Codul Claude {project}/.claude/skills/ ~/.claude/skills/
    Codex CLI {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Gemini CLI {project}/.gemini/skills/ —

    Importantă

    Copiază folderele din interior (de exemplu, , ), nu folderul în sine.

  3. Utilizatori VS Code: Activează chatul: Folosește abilitățile de agent () în setări.

  4. Începe să pui întrebări asistentului tău AI pe Azure. Abilitățile se activează automat în funcție de interogarea ta.

Utilizare

Odată instalat, pune-ți în mod natural întrebări asistentului AI:

  • "Ajută-mă să configurez Azure Functions cu Durable Functions"
  • "Care sunt cele mai bune practici pentru Azure Container Apps?"
  • "Primesc erori de limitare pe contul meu de stocare — cum pot diagnostica asta?"

Asistentul va descoperi automat abilități relevante, va încărca ghidurile structurate și va prelua cea mai recentă documentație de la Microsoft Learn pentru a oferi răspunsuri precise și fundamentate.

Compatibilitate

Aceste abilități funcționează cu orice asistent de codare AI care suportă specificația Agent Skills:

Asistent de Codare AI Tip Traseul Abilităților
GitHub Copilot Extensie VS Code .github/skills/
Codul Claude CLI antropic .claude/skills/
Codex CLI OpenAI CLI .codex/skills/
Cursor IDE nativ AI .cursor/skills/
Gemini CLI Google DeepMind .gemini/skills/
IDE de antigravitație DeepMind IDE .agent/skills/
OpenCode Open-source CLI .agent/skills/

Relația cu serverul Learn MCP

Agent Skills și Learn MCP Server sunt complementare:

  • Learn MCP Server oferă instrumente — căutare, preluare și recuperare a mostrelor de cod pe baza conținutului Microsoft Learn
  • Abilitățile Agentului oferă cunoștințe — îndrumare structurată despre ce să cauți, când și cum să le aplici

Abilitățile folosesc serverul Learn MCP (sau capacitatea echivalentă de preluare) ca mecanism de livrare a conținutului. Împreună, oferă asistenților AI atât judecata de a identifica ce este relevant, cât și capacitatea de a prelua cele mai noi conținuturi autoritare.

Disponibilitate și prețuri

Azure Agent Skills este disponibil public ca depozit open-source sub licență dublă:

  • Conținutul documentației: Creative Commons Atribuire 4.0 International
  • Cod: Licență MIT

Nu există nicio taxă pentru a folosi aceste abilități.

Limitări

  • Abilitățile necesită acces la rețea pentru a prelua documentația din Microsoft Learn. Fără acces la rețea, abilitățile oferă indexuri de linkuri selectate, dar nu pot accesa conținutul complet.
  • Catalogul de abilități acoperă în prezent 193 de servicii Azure. Acoperirea se extinde cu fiecare conductă pe măsură ce se publică documentație nouă.
  • Abilitățile sunt generate din documentația Microsoft Learn disponibilă public. Conținutul din modulele de formare, căile de învățare și cursurile conduse de instructor nu este inclus în acest moment.
  • Conducta de generare funcționează incremental. Poate exista o scurtă întârziere între actualizările de documentație pe Microsoft Learn și actualizările corespunzătoare de abilități.

Cum să oferiți feedback

Pașii următori

  • Începe cu serverul Learn MCP în VS Code
  • Specificația standard deschisă Agent Skills
  • Azure Repository Agent Skills
  • Pachete de abilități selectate pe roluri
  • Last updated on