microsoft-docs

Запрашивайте официальную документацию Microsoft, чтобы находить концепции, учебники и примеры кода по Azure, .NET, Agent Framework, Aspire, VS Code, GitHub и другим. Используется Microsoft Learn MCP по умолчанию, а для контента, размещённого вне learn.microsoft.com, — Context7 и Aspire MCP.

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 включает встроенные инструменты поиска по документации:

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. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP сервер предоставляет поиск интеграций (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 сначала разрешите идентификатор библиотеки (один раз за сессию):

Вызовите mcp_context7_resolve-library-id с названием технологии
Вызовите mcp_context7_query-docs с возвращенным идентификатором библиотеки и конкретным запросом

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