Microsoft Docs

Навичка дослідження для екосистеми технологій Microsoft. Охоплює learn.microsoft.com та документацію, що розміщується поза нею (репозиторії VS Code, GitHub, Aspire, Agent Framework).

---

Default: Microsoft Learn MCP

Використовуйте ці інструменти для всього на learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows та інше. Це основний інструмент для більшості запитів по документації Microsoft.

Tool	Purpose
microsoft_docs_search	Пошук по learn.microsoft.com — концепції, керівництва, підручники, конфігурація
microsoft_code_sample_search	Знайти робочі фрагменти коду з документації Learn. Передайте language (python, csharp, тощо) для кращих результатів
microsoft_docs_fetch	Отримати повний вміст сторінки з конкретного URL (коли уривків пошуку недостатньо)

Використовуйте microsoft_docs_fetch після пошуку, коли вам потрібні повні підручники, всі параметри конфігурації або коли уривки пошуку обрізані.

---

Exceptions: When to Use Other Tools

Наступні категорії розміщуються поза learn.microsoft.com. Замість цього використовуйте вказаний інструмент.

.NET Aspire — Use Aspire MCP Server (preferred) or Context7

Документація Aspire розміщена на aspire.dev, а не в Learn. Найкращий інструмент залежить від вашої версії Aspire CLI:

CLI 13.2+ (рекомендовано) — Aspire MCP server включає вбудовані інструменти пошуку документації:

MCP Tool	Description
list_docs	Перелічує всю доступну документацію з aspire.dev
search_docs	Зважений лексичний пошук по контенту aspire.dev
get_doc	Отримує конкретний документ за slug

Вони доступні в Aspire CLI 13.2 (PR #14028). Щоб оновити: aspire update --self --channel daily. Див.: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP server забезпечує пошук інтеграцій (list_integrations, get_integration_docs), але не пошук документації. У такому випадку поверніться до Context7:

Library ID	Use for
/microsoft/aspire.dev	Основне — керівництва, інтеграції, довідник CLI, розгортання
/dotnet/aspire	Джерело рантайму — внутрішні API, деталі реалізації
/communitytoolkit/aspire	Інтеграції спільноти — Go, Java, Node.js, Ollama

VS Code — Use Context7

Документація VS Code розміщена на code.visualstudio.com, а не в Learn.

Library ID	Use for
/websites/code_visualstudio	Документи для користувачів — налаштування, функції, налагодження, віддалена розробка
/websites/code_visualstudio_api	API розширень — webviews, TreeViews, команди, точки внеску

GitHub — Use Context7

Документація GitHub розміщена на docs.github.com та cli.github.com.

Library ID	Use for
/websites/github_en	Actions, API, репозиторії, безпека, адміністрування, Copilot
/websites/cli_github	Команди та прапорці GitHub CLI (gh)

Agent Framework — Use Learn MCP + Context7

Підручники Agent Framework знаходяться на learn.microsoft.com (використовуйте microsoft_docs_search), але репозиторій на GitHub містить API-рівневі деталі, які часто випереджають опубліковану документацію — особливо довідник DevUI REST API, опції CLI та інтеграція з .NET.

Library ID	Use for
/websites/learn_microsoft_en-us_agent-framework	Підручники — керівництва DevUI, трасування, оркестрація робочих процесів
/microsoft/agent-framework	Деталі API — кінцеві точки DevUI REST, прапорці CLI, автентифікація, .NET AddDevUI/MapDevUI

DevUI tip: Запитуйте джерело сайту Learn за керівництвами «як зробити», а потім джерело репозиторію для API-рівневих специфікацій (схеми кінцевих точок, налаштування проксі, токени автентифікації).

---

Context7 Setup

Для будь-якого запиту до Context7 спочатку визначте library ID (одноразово за сесію):

1. Викличте mcp_context7_resolve-library-id з назвою технології
2. Викличте mcp_context7_query-docs з отриманим library ID та конкретним запитом

---

Writing Effective Queries

Будьте конкретні — вказуйте версію, мету та мову:

# ❌ 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:

• Version when relevant (.NET 8, Aspire 13, VS Code 1.96)
• Task intent (quickstart, tutorial, overview, limits, API reference)
• Language for polyglot docs (Python, TypeScript, C#)

---

Застереження: Цей документ було перекладено за допомогою сервісу машинного перекладу на основі ШІ Co-op Translator (https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, зверніть увагу, що автоматизовані переклади можуть містити помилки чи неточності. Оригінальний документ мовою оригіналу слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звернутися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу.