microsoft-docs

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.

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:

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:

VS Code — Use Context7

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

GitHub — Use Context7

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

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.

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.