Azure ügynökkel kapcsolatos ismeretek

Azure Ügynökkészség egy belső, Microsoft által készített, AI-olvasható készségek katalógusa Azure fejlesztéshez. Minden készség a Microsoft Learn mérvadó tartalmai strukturált indexe, úgy került kialakításra, hogy az AI kódoló asszisztensek felfedezhessék és használhassák, hogy pontos, naprakész útmutatást nyújtsanak az Azure szolgáltatásokkal kapcsolatban.

A készségek a Agent Skills open standard követik, és bármilyen kompatibilis AI kódolási asszisztenssel működnek együtt, beleértve a GitHub Copilot, a Claude Code, a Cursor, a Gemini CLI, a Codex CLI és mások.

Használati esetek

  • Az AI kódolási asszisztenseinek szakértői szintű Azure útmutatást nyújtanak, amelyet a hivatalos dokumentáció alapján készítettek.
  • Az ügynökválaszok pontosságának és teljességének javítása Azure fejlesztési feladatokhoz
  • Az ajánlott eljárások, a folyamatok hibaelhárítása, az architektúraminták és a biztonsági útmutatók közvetlenül a szerkesztőben való lekérésének engedélyezése a fejlesztők számára
  • Strukturált, up-to-date tudás biztosítása, amely kiegészíti az élő adateszközöket, például az MCP-kiszolgálókat

Az ügynöki készségek működése

Az ügynöki készségek egyszerű, fájlrendszeralapú képességmodulok. Minden képesség egy mappa, amely egy fájlt tartalmaz YAML előtéttel (név, leírás, kompatibilitás) és kategóriák szerint rendezett strukturált tartalmat tartalmaz (hibakeresés, ajánlott eljárások, architektúra, biztonság, konfiguráció stb.).

Funkciók fokozatos megjelenítést alkalmaznak a tartalom hatékony betöltéséhez.

  1. Felfedezés – Az AI asszisztens beolvassa a készségek adatait és a YAML frontmatterből a relevancia meghatározásához.
  2. Utasítások – Aktiváláskor az asszisztens betölti a teljes tartalmat, amely témakör szerint rendezett, válogatott dokumentációs hivatkozásokat tartalmaz
  3. Beolvasás – Az asszisztens lekéri a legújabb tartalmat a Microsoft Learnből a Learn MCP-kiszolgálóval vagy egy webes lekérési eszközzel

Ez az architektúra elválasztja a tudásindexet (mit kell keresni és mikor) a tartalomkézbesítéstől (lekérdezéskor lekéri a legújabb dokumentumokat), biztosítva, hogy a készségek naprakészek maradjanak a dokumentáció fejlődésével.

A készségkatalógus automatikusan létrejön és karbantartható egy olyan célalapú folyamattal, amely megvizsgálja Azure termékdokumentációt, azonosítja a nagy értékű eljárási és döntéshozatali tartalmakat, és strukturált képességfájlokká alakítja. A folyamat folyamatosan kiértékeli a tartalommódosításokat, és növekményes frissítéseket hoz létre.

Képességkatalógus

Az adattár 193 készségeket tartalmaz, amelyek Azure alapvető szolgáltatásaira terjednek ki az alábbi kategóriákban:

Kategória Készségek Példák
Infrastruktúra és felügyelet 27 Azure Resource Manager, biztonsági mentés, monitorozás, szabályzat, költségkezelés, Arc
Specializált 27 Quantum, Maps, VMware Solution, SAP, Health Data Services, Virtual Desktop
hálózat 24 Virtuális hálózat, Front Door, Tűzfal, VPN átjáró, ExpressRoute, Terheléselosztó
AI & ML 20 AI-szolgáltatások, Machine Learning, dokumentumintelligencia, beszéd, Bot Service
Data & Analytics 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Biztonság > Identitás 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, folyamatok, tárolóregisztrációs adatbázis, üzembehelyezési környezetek, Dev Box
Compute 13 Functions, Container Apps, Virtual Machines, Kubernetes Service, App Service
Integráció 12 Logic Apps, API Management, Event Grid, Service Bus, Event Hubs
Storage 9 Blob Storage, fájlok, rugalmas SAN, NetApp Files, konténertárolás
IoT > Edge 7 IoT Hub, IoT Central, IoT Edge, IoT Operations, Digital Twins

A szerepköralapú válogatott csomagok általános forgatókönyvekhez érhetők el (Alapszintű, Infrastruktúra, Data Engineering, AI/ML, Security, DevOps).

A teljes készségkatalógus elérhető a docs/CATALOG.md webhelyen.

Requirements

  • Hálózati hozzáférés szükséges. A készségek a Microsoft Learn dokumentációjának URL-címére hivatkoznak, amelyeket az AI-asszisztens lekérdezéskor lekéri.
  • Kompatibilis AI-kódolási asszisztens , amely támogatja az Ügynöki készségek nyílt szabványt ( formátum).
  • Ajánlott: A Microsoft Learn MCP-kiszolgáló az optimális dokumentáció lekéréséhez. Ha a Learn MCP-kiszolgáló nem érhető el, a készségek visszaállnak a legtöbb AI-asszisztensbe beépített webes lekérési képességekre.

A készségek használatához nincs szükség hitelesítésre. A képességek statikus fájlok, amelyek helyileg futnak a fejlesztési környezetben.

Kezdő lépések

Installation

  1. Klónozza az adattárat:

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

  2. Másolja a képességmappát az AI-asszisztens készségkönyvtárába:

    AI-asszisztens Projektszintű elérési út Globális elérési út
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Claude Code {project}/.claude/skills/ ~/.claude/skills/
    Codex Parancssori felület {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Gemini parancssori felület {project}/.gemini/skills/ —

    Fontos

    Másolja a mappák tartalmát (például, ) a mappákon belül, de ne magát a mappát.

  3. VS Code-felhasználók: Csevegés engedélyezése: Ügynöki készségek használata () a Beállításokban.

  4. Kezdje el kérdéseket feltenni az Azure mesterséges intelligencia asszisztensének. A készségek automatikusan aktiválódnak a lekérdezés alapján.

Usage

A telepítés után természetesen tegye fel a kérdéseit az AI-asszisztensének:

  • "Segítsen nekem az Azure Functions és Durable Functions beállításában"
  • "Mik az Azure Container Apps legjobb gyakorlatai?"
  • "Szabályozási hibákat kapok a tárfiókomon – hogyan diagnosztizálhatom ezt?"

Az asszisztens automatikusan felderíti a releváns készségeket, betölti a strukturált útmutatót, és lekéri a legújabb dokumentációt a Microsoft Learnből, hogy pontos, megalapozott válaszokat adjon.

Compatibility

Ezek a készségek minden olyan AI-kódolási asszisztenssel működnek együtt, amely támogatja az ügynöki készségek specifikációját:

AI kódolási asszisztens Típus Készségek elérési útja
GitHub Copilot VS Code-bővítmény .github/skills/
Claude Code Antropikus parancssori felület .claude/skills/
Codex Parancssori felület OpenAI CLI .codex/skills/
Cursor AI-eredeti IDE .cursor/skills/
Gemini parancssori felület Google DeepMind .gemini/skills/
Antigravity IDE DeepMind IDE .agent/skills/
OpenCode Nyílt forráskódú parancssori felület .agent/skills/

Kapcsolat a Learn MCP-kiszolgálóval

Az ügynöki készségek és a Learn MCP-kiszolgáló kiegészítik egymást:

  • A Learn MCP Server eszközöket biztosít – keresés, beolvasás és kódminta lekérése a Microsoft Learn-tartalmakon
  • Az ügynöki készségek ismereteket nyújtanak – strukturált útmutatást adnak arról, hogy mit, mikor keresünk, és hogyan alkalmazzuk.

A készségek a Learn MCP-kiszolgálót (vagy azzal egyenértékű beolvasási képességet) használják tartalomkézbesítési mechanizmusként. Az AI-asszisztensek együttesen ítélkeznek arról, hogy mi a fontos, és hogy képesek legyenek lekérni a legújabb mérvadó tartalmakat.

Rendelkezésre állás és díjszabás

Azure Agent Skills nyilvánosan elérhető nyílt forráskódú adattárként kettős licenccel:

  • Dokumentáció tartalma: Creative Commons Attribution 4.0 International
  • Kód: MIT-licenc

A készségek használata díjmentes.

Korlátozások

  • A szakértelemhez hálózati hozzáférésre van szükség ahhoz, hogy lekérje a dokumentációt a Microsoft Learnből. Hálózati hozzáférés nélkül a készségek válogatott hivatkozásindexeket biztosítanak, de nem tudják lekérni a teljes tartalmat.
  • A készségkatalógus jelenleg 193 Azure szolgáltatást fed le. A lefedettség bővül minden egyes folyamatsor lefuttatásával, ahogy új dokumentációk kerülnek közzétételre.
  • A készségek a Microsoft Learn nyilvánosan elérhető dokumentációjából jönnek létre. A képzési modulokból, képzési tervekből és oktató által vezetett tanfolyamokból származó tartalmak jelenleg nem szerepelnek benne.
  • A generálási folyamat lépésenként fut. Előfordulhat, hogy a Microsoft Learn dokumentációfrissítései és a hozzá tartozó képességfrissítések között rövid késés áll fenn.

Visszajelzés küldése

  • GitHub problémák: https://github.com/MicrosoftDocs/agent-skills/issues (hibák, hiányosságok vagy funkciókérések esetén előnyben részesített)
  • Hozzájárulások: Az adattár üdvözli a lekéréses kérelmeket. Tekintse meg a hozzájárulási irányelveket a README-ben.

Következő lépések

  • Ismerkedés a Learn MCP-kiszolgálóval a VS Code-ban
  • Ügynöki készségek nyílt szabvány specifikációja
  • Azure ügynöki készségek adattára
  • Válogatott képességcsomagok szerepkör szerint
  • Last updated on