thedixitjain Microsoft Docs
Умение за проучване на екосистемата на технологиите на Microsoft. Обхваща learn.microsoft.com и документацията, която се намира извън нея (репозиториите на VS Code, GitHub, Aspire, Agent Framework).
По подразбиране: Microsoft Learn MCP
Използвайте тези инструменти за всичко в learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows и други. Това е основният инструмент за голямата част от заявките за документация на Microsoft.
| Инструмент | Предназначение |
|---|---|
microsoft_docs_search |
Търси в learn.microsoft.com — концепции, ръководства, уроци, конфигурация |
microsoft_code_sample_search |
Намира работещи кодови фрагменти от документацията в Learn. Подайте language (python, csharp, и т.н.) за най-добри резултати |
microsoft_docs_fetch |
Връща пълното съдържание на страница от конкретен URL (когато откъсите от търсенето не са достатъчни) |
Използвайте microsoft_docs_fetch след търсене, когато имате нужда от пълни уроци, всички опции за конфигурация или когато откъсите от търсенето са съкратени.
Изключения: Кога да използвате други инструменти
Следните категории се намират извън learn.microsoft.com. Използвайте посочения инструмент вместо това.
.NET Aspire — Използвайте Aspire MCP Server (предпочитан) или Context7
Aspire документацията се намира на aspire.dev, не в Learn. Най-подходящият инструмент зависи от версията на Aspire CLI:
CLI 13.2+ (препоръчително) — Aspire MCP сървърът включва вградени инструменти за търсене в документацията:
| MCP Tool | Описание |
|---|---|
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:
| ID на библиотеката | Използва се за |
|---|---|
/microsoft/aspire.dev |
Основен — ръководства, интеграции, CLI референция, разгръщане |
/dotnet/aspire |
Изходен код на runtime — вътрешности на API, детайли за имплементацията |
/communitytoolkit/aspire |
Интеграции от общността — Go, Java, Node.js, Ollama |
VS Code — Използвайте Context7
VS Code документацията се намира на code.visualstudio.com, не в Learn.
| ID на библиотеката | Използва се за |
|---|---|
/websites/code_visualstudio |
Потребителска документация — настройки, функционалности, отстраняване на грешки, отдалечено разработване |
/websites/code_visualstudio_api |
API за разширения — webviews, TreeViews, команди, точки за принос |
GitHub — Използвайте Context7
GitHub документацията се намира на docs.github.com и cli.github.com.
| ID на библиотеката | Използва се за |
|---|---|
/websites/github_en |
Actions, API, репозитории, сигурност, администриране, Copilot |
/websites/cli_github |
Команди и флагове на GitHub CLI (gh) |
Agent Framework — Използвайте Learn MCP + Context7
Уроците за Agent Framework са на learn.microsoft.com (използвайте microsoft_docs_search), но GitHub репото съдържа детайли на ниво API, които често предхождат публикуваната документация — особено референцията на DevUI REST API, опции на CLI и .NET интеграцията.
| ID на библиотеката | Използва се за |
|---|---|
/websites/learn_microsoft_en-us_agent-framework |
Уроци — ръководства за DevUI, трасиране, оркестрация на работни потоци |
/microsoft/agent-framework |
Детайли по API — REST endpoint-и на DevUI, CLI флагове, автентикация, .NET AddDevUI/MapDevUI |
DevUI tip: Потърсете източника на уебсайта Learn за ръководства „как да“, след това репозиторния източник за специфики на ниво API (схеми на endpoint-и, proxy конфигурация, токени за автентикация).
Настройка на Context7
За всяка заявка към Context7, разрешете library ID първо (еднократно за сесията):
- Извикайте
mcp_context7_resolve-library-idс името на технологията - Извикайте
mcp_context7_query-docsс върнатия library ID и конкретна заявка
Писане на ефективни заявки
Бъдете конкретни — включете версия, намерение и език:
# ❌ 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:
- Версия когато е релевантно (
.NET 8,Aspire 13,VS Code 1.96) - Намерение на задачата (
quickstart,tutorial,overview,limits,API reference) - Език за полиглотна документация (
Python,TypeScript,C#)
Отказ от отговорност: Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на оригиналния език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален превод, извършен от човек. Не носим отговорност за каквито и да е недоразумения или погрешни тълкувания, произтичащи от използването на този превод.
Source: microsoft/ai-agents-for-beginners → translations/bg/.agents/skills/microsoft-docs/SKILL.md