thedixitjain 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ę):
- Wywołaj
mcp_context7_resolve-library-idz nazwą technologii - Wywołaj
mcp_context7_query-docsz 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.
Source: microsoft/ai-agents-for-beginners → translations/pl/.agents/skills/microsoft-docs/SKILL.md