Sdílet prostřednictvím


dovednosti agenta Azure

Azure Agent Skills je katalog dovedností první strany, čitelných AI pro vývoj Azure. Každá dovednost je strukturovaný index autoritativního obsahu Microsoft Learn, který je zabalený tak, aby asistenti kódování AI mohli objevit a používat jej k poskytování přesných, aktuálních pokynů ke službám Azure.

Dovednosti se řídí otevřeným standardem Agent Skills a pracují s jakýmkoli kompatibilním AI asistentem pro programování, včetně GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI a dalších.

Případy použití

  • Poskytnout pomocníkům s kódováním AI odborné Azure pokyny založené na oficiální dokumentaci
  • Zlepšení přesnosti a úplnosti odpovědí agenta pro Azure úlohy vývoje
  • Umožnit vývojářům získat osvědčené postupy, řešení potíží s toky, vzory architektury a pokyny k zabezpečení přímo v editoru
  • Poskytnout strukturované, aktuální znalosti, které doplňují nástroje pro živá data, jako jsou servery MCP

Jak fungují dovednosti agenta

Dovednosti agenta jsou jednoduché moduly schopností založené na systému souborů. Každá dovednost je složka obsahující soubor s frontmatterem YAML (název, popis, kompatibilita) a strukturovaný obsah uspořádaný podle kategorie (řešení potíží, osvědčené postupy, architektura, zabezpečení, konfigurace a další).

Dovednosti využívají progresivní zpřístupnění k efektivnímu načítání obsahu:

  1. Objevování – AI asistent čte funkce z frontmatteru YAML za účelem určení relevance.
  2. Pokyny – Při aktivaci pomocník načte celý obsah, který obsahuje kurátorované odkazy na dokumentaci uspořádané podle tématu.
  3. Načtení – Pomocník načte nejnovější obsah z Microsoft Learn pomocí serveru MCP Learn nebo nástroje pro načítání webu.

Tato architektura odděluje index znalostí (co hledat a kdy) od doručování obsahu (načítání nejnovějších dokumentů v době dotazu), což zajišťuje aktuální dovednosti při vývoji dokumentace.

Katalog dovedností se automaticky generuje a udržuje prostřednictvím účelového kanálu, který kontroluje Azure dokumentaci k produktu, identifikuje vysoce hodnotný procedurální a rozhodovací obsah a transformuje ho na strukturované soubory dovedností. Datový pipeline průběžně vyhodnocuje změny příchozího obsahu a vytváří přírůstkové aktualizace.

Katalog dovedností

Úložiště obsahuje dovednosti 193 pokrývající základní služby Azure napříč těmito kategoriemi:

Kategorie Kvalifikace Příklady
Infrastruktura a správa 27 Azure Resource Manager, zálohování, monitorování, zásady, správa nákladů, arc
Specialized 27 Quantum, Maps, VMware Solution, SAP, Health Data Services, Virtual Desktop
Sítě dvacet čtyři Virtuální síť, Front Door, Firewall, Brána VPN, ExpressRoute, Vyrovnávač zatížení
AI & ML 20 Služby umělé inteligence, Strojové učení, Inteligence dokumentů, Rozpoznávání řeči, Služby botů
Data & Analytics 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Zabezpečení a identita 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, Pipelines, Container Registry, Nasazovací prostředí, Dev Box
Compute 13 Funkce, Container Apps, Virtuální Stroje, Kubernetes Service, App Service
Integrace 12 Logic Apps, API Management, Event Grid, Service Bus, Event Hubs
Storage 9 Blob Storage, Soubory, Elastic SAN, NetApp Files, Ukládání do kontejnerů
IoT a Edge 7 IoT Hub, IoT Central, IoT Edge, operace IoT, digitální dvojčata

Kurátorované sady založené na rolích jsou k dispozici pro běžné scénáře (Essentials, Infrastructure, Data Engineering, AI/ML, Security, DevOps).

Kompletní katalog dovedností je k dispozici na webu docs/CATALOG.md.

Požadavky

  • Vyžaduje se síťový přístup. Odkazy na dovednosti obsahují adresy URL dokumentace Microsoft Learn, které AI asistent načítá při dotazu.
  • Kompatibilní AI asistent pro kódování, který podporuje otevřený standard Agent Skills (formát).
  • Doporučeno: Server MCP microsoft Learn pro optimální načtení dokumentace. Pokud server Learn MCP není dostupný, dovednosti se vrátí k funkcím načítání webu integrovaným do většiny asistentů AI.

K používání samotných dovedností se nevyžaduje žádné ověřování. Dovednosti jsou statické soubory, které běží místně ve vašem vývojovém prostředí.

Začínáme

Installation

  1. Naklonujte úložiště:

    git clone https://github.com/MicrosoftDocs/agent-skills.git
    
  2. Zkopírujte složky dovedností z adresáře dovedností asistenta AI:

    Pomocník s AI Cesta na úrovni projektu Globální cesta
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Kód Claude {project}/.claude/skills/ ~/.claude/skills/
    Codex rozhraní příkazového řádku {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/
    Rozhraní příkazového řádku Gemini {project}/.gemini/skills/

    Důležité

    Zkopírujte složky uvnitř složky (např . , ), ne samotnou složku.

  3. Uživatelé editoru VS Code: Povolení chatu: Používání dovedností agenta () v nastavení

  4. Začněte pokládat otázky svému asistentovi AI Azure. Dovednosti se aktivují automaticky na základě vašeho dotazu.

Využití

Po instalaci se zeptejte pomocníka s AI přirozeně:

  • "Pomozte mi nastavit Azure Functions pomocí Durable Functions"
  • "Jaké jsou osvědčené postupy pro Azure Container Apps?",
  • "V účtu úložiště dochází k chybám omezování – jak to mám diagnostikovat?"

Pomocník automaticky zjistí relevantní dovednosti, načte strukturované pokyny a načte nejnovější dokumentaci z Microsoft Learn, aby poskytoval přesné a uzemněné odpovědi.

Compatibility

Tyto dovednosti fungují s libovolným pomocníkem pro kódování AI, který podporuje specifikaci dovedností agenta:

Pomocník pro kódování AI Typ Cesta dovedností
GitHub Copilot Rozšíření VS Code .github/skills/
Kód Claude Anthropic CLI .claude/skills/
Codex CLI Rozhraní příkazového řádku OpenAI .codex/skills/
Cursor Integrované vývojové prostředí (IDE) nativní pro AI .cursor/skills/
Rozhraní příkazového řádku Gemini Google DeepMind .gemini/skills/
Antigravity IDE Integrované vývojové prostředí DeepMind .agent/skills/
OpenCode Opensourcové rozhraní příkazového řádku .agent/skills/

Vztah k serveru Learn MCP

Dovednosti agenta a server Learn MCP doplňují:

  • Learn MCP Server poskytuje nástroje – vyhledávání, získávání a získávání ukázek kódu v obsahu Microsoft Learn.
  • Dovednosti agentů poskytují znalosti – strukturované pokyny, co dohledat, kdy a jak to aplikovat

Dovednosti používají Learn MCP Server (nebo ekvivalentní schopnost načítání) jako mechanismus doručování obsahu. Společně poskytují asistentům umělé inteligence úsudek, aby zjistili, co je relevantní, a schopnost načíst nejnovější autoritativní obsah.

Dostupnost a ceny

Azure Dovednosti agenta jsou veřejně dostupné jako opensourcové úložiště pod duální licencí:

  • Obsah dokumentace: Creative Commons Attribution 4.0 International
  • Kód: Licence MIT

Za používání dovedností se neúčtují žádné poplatky.

Omezení

  • Dovednosti vyžadují síťový přístup k načtení dokumentace z Microsoft Learn. Bez přístupu k síti poskytují dovednosti kurátorované indexy odkazů, ale nemůžou načíst celý obsah.
  • Katalog dovedností v současné době pokrývá 193 Azure služeb. Pokrytí se rozšiřuje o každé spuštění kanálu, protože se publikuje nová dokumentace.
  • Dovednosti se generují z veřejně dostupné dokumentace k Microsoft Learn. Obsah z školicích modulů, studijních programů a kurzů vedených instruktorem není v tuto chvíli zahrnutý.
  • Kanál generování běží přírůstkově. Mezi aktualizacemi dokumentace v Microsoft Learn a odpovídajícími aktualizacemi dovedností může docházet k krátké prodlevě.

Jak poskytnout zpětnou vazbu

Další kroky

  • Začínáme s výukovým serverem MCP ve VS Code
  • Otevřená standardní specifikace dovedností agentů
  • Azure úložiště dovedností agenta
  • Kurátorované sady dovedností podle role