Microsoft Microsoft Docs
Tutkimustaito Microsoftin teknologiaympäristöä varten. Kattaa learn.microsoft.comin ja dokumentaation, joka sijaitsee sen ulkopuolella (VS Code, GitHub, Aspire, Agent Framework -repositoriot).
Default: Microsoft Learn MCP
Käytä näitä työkaluja kaikkeen, mikä löytyy osoitteesta learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows ja muut. Tämä on ensisijainen työkalu suurimmassa osassa Microsoft-dokumentaatioon liittyvistä kyselyistä.
| Tool | Purpose |
|---|---|
microsoft_docs_search |
Etsi learn.microsoft.com — käsitteet, oppaat, tutoriaalit, konfigurointi |
microsoft_code_sample_search |
Etsi toimivia koodikatkelmia Learn-dokumenteista. Anna language (python, csharp, jne.) parhaiten tuloksin |
microsoft_docs_fetch |
Hae täysi sivun sisältö tietystä URL-osoitteesta (kun hakukatkelmat eivät riitä) |
Käytä microsoft_docs_fetch-työkalua haun jälkeen, kun tarvitset täydelliset tutoriaalit, kaikki konfiguraatioasetukset tai kun hakukatkelmat on katkaistu.
Exceptions: When to Use Other Tools
Seuraavat kategoriat sijaitsevat sen ULKOPUOLELLA learn.microsoft.com-sivustoa. Käytä sen sijaan määriteltyä työkalua.
.NET Aspire — Use Aspire MCP Server (preferred) or Context7
Aspire-dokumentaatio löytyy osoitteesta aspire.dev, ei Learnista. Paras työkalu riippuu Aspire CLI -versiostasi:
CLI 13.2+ (suositeltu) — Aspire MCP -palvelin sisältää sisäänrakennetut dokumentaation hakutyökalut:
| MCP Tool | Description |
|---|---|
list_docs |
Luettelee kaiken saatavilla olevan dokumentaation osoitteesta aspire.dev |
search_docs |
Painotettu leksikaalinen haku aspire.dev -sisällöstä |
get_doc |
Hakee tietyn dokumentin slugin perusteella |
Nämä sisältyvät Aspire CLI 13.2:een (PR #14028). Päivitä: aspire update --self --channel daily. Viite: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — MCP-palvelin tarjoaa integraatiohaun (list_integrations, get_integration_docs) mutta ei dokumentaation hakua. Palaa Context7:aan:
| Library ID | Use for |
|---|---|
/microsoft/aspire.dev |
Ensisijainen — oppaat, integraatiot, CLI-viite, käyttöönotto |
/dotnet/aspire |
Ajonaikainen lähdekoodi — API:n sisäiset osat, toteutusyksityiskohdat |
/communitytoolkit/aspire |
Yhteisön integraatiot — Go, Java, Node.js, Ollama |
VS Code — Use Context7
VS Code -dokumentaatio löytyy osoitteesta code.visualstudio.com, ei Learnista.
| Library ID | Use for |
|---|---|
/websites/code_visualstudio |
Käyttäjädokumentaatio — asetukset, ominaisuudet, virheenkorjaus, etäkehitys |
/websites/code_visualstudio_api |
Laajennuksen API — webviewt, TreeViewt, komennot, kontribuutiopisteet |
GitHub — Use Context7
GitHub-dokumentaatio löytyy osoitteista docs.github.com ja cli.github.com.
| Library ID | Use for |
|---|---|
/websites/github_en |
Actions, API, repositoriot, suojaus, hallinta, Copilot |
/websites/cli_github |
GitHub CLI (gh) -komennot ja liput |
Agent Framework — Use Learn MCP + Context7
Agent Frameworkin tutoriaalit ovat learn.microsoft.comissa (käytä microsoft_docs_search), mutta GitHub-repositorio sisältää API-tason yksityiskohtia, jotka usein edeltävät julkaistuja docs-sivuja — erityisesti DevUI REST API -viite, CLI-valinnat ja .NET-integraatio.
| Library ID | Use for |
|---|---|
/websites/learn_microsoft_en-us_agent-framework |
Opetusohjelmat — DevUI-oppaat, jäljitys, työnkulun orkestrointi |
/microsoft/agent-framework |
API-yksityiskohdat — DevUI REST-päätepisteet, CLI-liput, autentikointi, .NET AddDevUI/MapDevUI |
DevUI tip: Hae Learn-verkkosivuston lähteestä how-to-oppaat ja tarkista sitten repositorion lähde API-tason yksityiskohtia varten (päätepisteiden skeemat, proxy-konfiguraatio, autentikointitunnukset).
Context7 Setup
Context7-kyselyä varten ratkaise ensin kirjaston ID (kertakäyttö per istunto):
- Kutsu
mcp_context7_resolve-library-idteknologian nimellä - Kutsu
mcp_context7_query-docspalautetulla kirjaston ID:llä ja tarkemmalla kyselyllä
Writing Effective Queries
Ole tarkka — sisällytä versio, tarkoitus ja kieli:
# ❌ 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:
- Version when relevant (
.NET 8,Aspire 13,VS Code 1.96) - Task intent (
quickstart,tutorial,overview,limits,API reference) - Language for polyglot docs (
Python,TypeScript,C#)
Vastuuvapauslauseke: Tämä asiakirja on käännetty käyttämällä tekoälykäännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, ota huomioon, että automaattikäännöksissä voi olla virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäisellä kielellä tulee pitää virallisena lähteenä. Tärkeiden tietojen osalta suositellaan ammattimaista käännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai virheellisistä tulkinnoista.
Source: microsoft/ai-agents-for-beginners → translations/fi/.agents/skills/microsoft-docs/SKILL.md