microsoft-docs

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.

Використовуйте 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 включає вбудовані інструменти пошуку документації:

Вони доступні в 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:

VS Code — Use Context7

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

GitHub — Use Context7

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

Agent Framework — Use Learn MCP + Context7

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

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). Хоча ми прагнемо до точності, зверніть увагу, що автоматизовані переклади можуть містити помилки чи неточності. Оригінальний документ мовою оригіналу слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звернутися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу.