microsoft-docs - SKILL.md Agent Skill

name: microsoft-docs description: Prehľadávajte oficiálnu dokumentáciu Microsoftu, aby ste našli koncepty, návody a ukážky kódu naprieč Azure, .NET, Agent Framework, Aspire, VS Code, GitHub a ďalšími. Používa Microsoft Learn MCP ako predvolený zdroj, spolu s Context7 a Aspire MCP pre obsah, ktorý sa nachádza mimo learn.microsoft.com.

Microsoft Docs

Výskumná zručnosť pre technologický ekosystém Microsoftu. Zahŕňa learn.microsoft.com a dokumentáciu, ktorá sa nachádza mimo neho (VS Code, GitHub, Aspire, repozitáre Agent Framework).

Predvolené: Microsoft Learn MCP

Použite tieto nástroje pre všetko na learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows a ďalšie. Toto je hlavný nástroj pre väčšinu otázok týkajúcich sa dokumentácie Microsoftu.

Nástroj	Účel
`microsoft_docs_search`	Vyhľadávať na learn.microsoft.com — koncepty, príručky, tutoriály, konfigurácie
`microsoft_code_sample_search`	Nájdite fungujúce ukážky kódu z Learn dokumentácie. Pre najlepšie výsledky zadajte `language` (`python`, `csharp`, atď.)
`microsoft_docs_fetch`	Získať celý obsah stránky z konkrétnej URL (keď výňatky z vyhľadávania nestačia)

Použite microsoft_docs_fetch po vyhľadávaní, keď potrebujete kompletné tutoriály, všetky konfiguračné možnosti alebo keď sú výňatky z vyhľadávania orezané.

Výnimky: Kedy použiť iné nástroje

Nasledujúce kategórie sa nachádzajú mimo learn.microsoft.com. Namiesto toho použite určený nástroj.

.NET Aspire — Použite Aspire MCP Server (preferované) alebo Context7

Dokumentácia Aspire sa nachádza na aspire.dev, nie na Learn. Najlepší nástroj závisí od verzie Aspire CLI:

CLI 13.2+ (odporúčané) — Aspire MCP server obsahuje vstavané nástroje na vyhľadávanie v dokumentácii:

MCP Tool	Popis
`list_docs`	Zoznamuje všetku dostupnú dokumentáciu z aspire.dev
`search_docs`	Vážené lexikálne vyhľadávanie v obsahu aspire.dev
`get_doc`	Získa konkrétny dokument podľa slugu

Tieto sú súčasťou Aspire CLI 13.2 (PR #14028). Na aktualizáciu: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP server poskytuje vyhľadávanie integrácií (list_integrations, get_integration_docs), ale nie vyhľadávanie dokumentácie. V takom prípade použite Context7:

Library ID	Použitie
`/microsoft/aspire.dev`	Primárne — príručky, integrácie, referencia CLI, nasadenie
`/dotnet/aspire`	Zdroj runtime — vnútorné API, implementačné detaily
`/communitytoolkit/aspire`	Komunitné integrácie — Go, Java, Node.js, Ollama

VS Code — Použite Context7

Dokumentácia VS Code sa nachádza na code.visualstudio.com, nie na Learn.

Library ID	Použitie
`/websites/code_visualstudio`	Používateľská dokumentácia — nastavenia, funkcie, ladenie, vzdialený vývoj
`/websites/code_visualstudio_api`	Extension API — webviews, TreeViews, príkazy, kon‑tribučné body

GitHub — Použite Context7

Dokumentácia GitHubu sa nachádza na docs.github.com a cli.github.com.

Library ID	Použitie
`/websites/github_en`	Actions, API, repozitáre, zabezpečenie, administrácia, Copilot
`/websites/cli_github`	Príkazy a prepínače GitHub CLI (`gh`)

Agent Framework — Použite Learn MCP + Context7

Tutoriály Agent Framework sú na learn.microsoft.com (použite microsoft_docs_search), ale GitHub repozitár obsahuje detaily na úrovni API, ktoré sú často pred publikovanou dokumentáciou — najmä referenciu DevUI REST API, možnosti CLI a .NET integráciu.

Library ID	Použitie
`/websites/learn_microsoft_en-us_agent-framework`	Tutoriály — DevUI príručky, trasovanie, orchestrácia pracovných tokov
`/microsoft/agent-framework`	Detaily API — DevUI REST endpointy, CLI prepínače, autentifikácia, .NET `AddDevUI`/`MapDevUI`

DevUI tip: Najprv sa pozrite na zdroj na Learn webe pre návodové príručky, potom do repozitára pre API-úrovňové špecifiká (schémy endpointov, konfigurácia proxy, autentifikačné tokeny).

Nastavenie Context7

Pre akýkoľvek dotaz v Context7 najprv vyriešte ID knižnice (jednorazovo na reláciu):

Zavolajte mcp_context7_resolve-library-id s názvom technológie
Zavolajte mcp_context7_query-docs s vráteným ID knižnice a konkrétnym dotazom

Písanie efektívnych dotazov

Buďte konkrétni — uveďte verziu, zámer a jazyk:

# ❌ Too broad
"Azure Functions"
"agent framework"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"

Include context:

Verzia ak relevantné (.NET 8, Aspire 13, VS Code 1.96)
Účel úlohy (quickstart, tutorial, overview, limits, API reference)
Jazyk pre polyglot dokumentáciu (Python, TypeScript, C#)

Vylúčenie zodpovednosti: Tento dokument bol preložený pomocou AI prekladateľskej služby Co-op Translator. Aj keď sa snažíme o presnosť, majte prosím na pamäti, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho pôvodnom jazyku by sa mal považovať za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny preklad vykonaný človekom. Za akékoľvek nedorozumenia alebo nesprávne výklady vyplývajúce z použitia tohto prekladu nenesieme zodpovednosť.