--- name: microsoft-docs description: Przeszukaj oficjalną dokumentację Microsoft, aby znaleźć koncepcje, samouczki i przykłady kodu dotyczące Azure, .NET, Agent Framework, Aspire, VS Code, GitHub i innych. Domyślnie używa Microsoft Learn MCP, a dla treści znajdujących się poza learn.microsoft.com korzysta z Context7 i Aspire MCP. --- # 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](https://github.com/dotnet/aspire/pull/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](https://github.com/Azure/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.