Microsoft Docs

Umiejętność wyszukiwania informacji dla ekosystemu technologii Microsoft. Obejmuje learn.microsoft.com oraz dokumentację znajdującą się poza nim (repozytoria VS Code, GitHub, Aspire, Agent Framework).

---

Default: Microsoft Learn MCP

Użyj tych narzędzi dla wszystkiego na learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows i inne. To jest podstawowe narzędzie dla zdecydowanej większości zapytań dotyczących dokumentacji Microsoft.

Tool	Purpose
microsoft_docs_search	Wyszukaj w learn.microsoft.com — koncepcje, przewodniki, samouczki, konfiguracja
microsoft_code_sample_search	Znajdź działające przykłady kodu w dokumentacji Learn. Przekaż language (python, csharp, etc.) dla najlepszych rezultatów
microsoft_docs_fetch	Pobierz pełną zawartość strony z określonego URL (gdy fragmenty z wyszukiwania nie wystarczają)

Użyj microsoft_docs_fetch po wyszukiwaniu, gdy potrzebujesz kompletnych samouczków, wszystkich opcji konfiguracji lub gdy fragmenty wyników wyszukiwania są obcięte.

---

Exceptions: When to Use Other Tools

Następujące kategorie znajdują się poza learn.microsoft.com. Użyj zamiast tego wskazanego narzędzia.

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

Dokumentacja Aspire znajduje się na aspire.dev, a nie w Learn. Najlepsze narzędzie zależy od wersji Aspire CLI:

CLI 13.2+ (zalecane) — Aspire MCP server zawiera wbudowane narzędzia do wyszukiwania w dokumentacji:

MCP Tool	Description
list_docs	Wyświetla wszystkie dostępne dokumenty z aspire.dev
search_docs	Ważone wyszukiwanie leksykalne w zawartości aspire.dev
get_doc	Pobiera konkretny dokument po slug

Są dostarczane w Aspire CLI 13.2 (PR #14028). Aby zaktualizować: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP server zapewnia przeszukiwanie integracji (list_integrations, get_integration_docs), ale nie wyszukiwanie dokumentacji. Wróć do Context7:

Library ID	Use for
/microsoft/aspire.dev	Główne — przewodniki, integracje, dokumentacja CLI, wdrożenie
/dotnet/aspire	Źródło runtime — szczegóły wewnętrzne API, implementacji
/communitytoolkit/aspire	Integracje społecznościowe — Go, Java, Node.js, Ollama

VS Code — Use Context7

Dokumentacja VS Code znajduje się na code.visualstudio.com, a nie w Learn.

Library ID	Use for
/websites/code_visualstudio	Dokumentacja użytkownika — ustawienia, funkcje, debugowanie, zdalny rozwój
/websites/code_visualstudio_api	API rozszerzeń — webviews, TreeViews, polecenia, punkty rozszerzeń

GitHub — Use Context7

Dokumentacja GitHub znajduje się na docs.github.com i cli.github.com.

Library ID	Use for
/websites/github_en	Actions, API, repozytoria, bezpieczeństwo, administracja, Copilot
/websites/cli_github	GitHub CLI (gh) — polecenia i flagi

Agent Framework — Use Learn MCP + Context7

Samouczki Agent Framework znajdują się na learn.microsoft.com (użyj microsoft_docs_search), ale repozytorium GitHub zawiera szczegóły na poziomie API, które często są bardziej aktualne niż opublikowane dokumenty — zwłaszcza odniesienie do DevUI REST API, opcje CLI i integracja z .NET.

Library ID	Use for
/websites/learn_microsoft_en-us_agent-framework	Samouczki — przewodniki DevUI, śledzenie, orkiestracja przepływów pracy
/microsoft/agent-framework	Szczegóły API — endpointy DevUI REST, flagi CLI, uwierzytelnianie, .NET AddDevUI/MapDevUI

DevUI tip: Najpierw sprawdź źródło Learn dla przewodników "jak to zrobić", a następnie źródło repozytorium dla szczegółów na poziomie API (schematy endpointów, konfiguracja proxy, tokeny uwierzytelniania).

---

Context7 Setup

Dla każdego zapytania do Context7 najpierw rozwiąż identyfikator biblioteki (jednorazowo na sesję):

1. Wywołaj mcp_context7_resolve-library-id z nazwą technologii
2. Wywołaj mcp_context7_query-docs z otrzymanym identyfikatorem biblioteki i konkretnym zapytaniem

---

Writing Effective Queries

Bądź konkretny — uwzględnij wersję, zamiar i język:

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

• Wersja gdy istotne (.NET 8, Aspire 13, VS Code 1.96)
• Cel zadania (quickstart, tutorial, overview, limits, API reference)
• Język dla dokumentacji wielojęzycznej (Python, TypeScript, C#)

---

Zastrzeżenie: Ten dokument został przetłumaczony przy użyciu usługi tłumaczenia opartej na sztucznej inteligencji Co-op Translator. Chociaż dokładamy starań, aby zapewnić dokładność, prosimy pamiętać, że tłumaczenia automatyczne mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym należy uznawać za dokument autorytatywny. W przypadku informacji istotnych zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.