thedixitjain Microsoft Docs
Ujuzi wa utafiti kwa ekosistimu ya teknolojia ya Microsoft. Inashughulikia learn.microsoft.com na nyaraka zinazoshikilia nje yake (VS Code, GitHub, Aspire, hazina za Agent Framework).
Default: Microsoft Learn MCP
Tumia zana hizi kwa kila kitu kwenye learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, na zaidi. Hii ni zana kuu kwa sehemu kubwa ya maswali ya nyaraka za Microsoft.
| Tool | Purpose |
|---|---|
microsoft_docs_search |
Tafuta learn.microsoft.com — dhana, mwongozo, mafunzo, usanidi |
microsoft_code_sample_search |
Tafuta vipande vya msimbo vinavyofanya kazi kutoka kwenye nyaraka za Learn. Tumia language (python, csharp, n.k.) kwa matokeo bora |
microsoft_docs_fetch |
Pata yaliyomo ya ukurasa kamili kutoka kwenye URL maalum (wanapo toleo la utafutaji halitoshi) |
Tumia microsoft_docs_fetch baada ya utafutaji wakati unahitaji mafunzo kamili, chaguzi zote za usanidi, au wakati vifupisho vya utafutaji vimekatwa.
Exceptions: When to Use Other Tools
Makundi yafuatayo yapo nje ya learn.microsoft.com. Tumia zana maalum badala yake.
.NET Aspire — Use Aspire MCP Server (preferred) or Context7
Nyaraka za Aspire zinapatikana kwenye aspire.dev, si Learn. Zana bora inategemea toleo lako la Aspire CLI:
CLI 13.2+ (inayopendekezwa) — Aspire MCP server ina zana za utafutaji wa nyaraka zilizojengwa ndani:
| MCP Tool | Description |
|---|---|
list_docs |
Orodhesha nyaraka zote zinazopatikana kutoka aspire.dev |
search_docs |
Utafutaji wa kifasiri wenye uzito kwenye yaliyomo ya aspire.dev |
get_doc |
Inarekebisha hati maalum kwa slug |
Hizi zinaambatana katika Aspire CLI 13.2 (PR #14028). Ili kusasisha: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/
CLI 13.1 — MCP server hutoa utafutaji wa integrasiyo (list_integrations, get_integration_docs) lakini si utafutaji wa nyaraka. Rudia Context7:
| Library ID | Use for |
|---|---|
/microsoft/aspire.dev |
Msingi — mwongozo, integrasiyo, rejea ya CLI, upeleka |
/dotnet/aspire |
Chanzo cha runtime — ndani za API, maelezo ya utekelezaji |
/communitytoolkit/aspire |
Integrasiyo za jamii — Go, Java, Node.js, Ollama |
VS Code — Use Context7
Nyaraka za VS Code zinapatikana kwenye code.visualstudio.com, si Learn.
| Library ID | Use for |
|---|---|
/websites/code_visualstudio |
Nyaraka za mtumiaji — mipangilio, vipengele, debugging, maendeleo ya mbali |
/websites/code_visualstudio_api |
API ya upanuzi — webviews, TreeViews, amri, pointi za mchango |
GitHub — Use Context7
Nyaraka za GitHub zinapatikana kwenye docs.github.com na cli.github.com.
| Library ID | Use for |
|---|---|
/websites/github_en |
Actions, API, repos, usalama, usimamizi, Copilot |
/websites/cli_github |
Amri na bendera za GitHub CLI (gh) |
Agent Framework — Use Learn MCP + Context7
Mafunzo ya Agent Framework yako kwenye learn.microsoft.com (tumia microsoft_docs_search), lakini repo ya GitHub ina maelezo ya kiwango cha API ambayo mara nyingi iko mbele ya nyaraka zilizochapishwa — hasa rejea ya DevUI REST API, chaguzi za CLI, na ujumuishaji wa .NET.
| Library ID | Use for |
|---|---|
/websites/learn_microsoft_en-us_agent-framework |
Mafunzo — mwongozo wa DevUI, ufuatiliaji, uendeshaji wa workflow |
/microsoft/agent-framework |
Maelezo ya API — endpoints za DevUI REST, bendera za CLI, auth, .NET AddDevUI/MapDevUI |
DevUI tip: Ulizi chanzo cha tovuti ya Learn kwa mwongozo wa jinsi ya kufanya, kisha chanzo cha repo kwa maelezo ya kiwango cha API (miundo ya endpoint, usanidi wa proxy, tokeni za uthibitisho).
Context7 Setup
Kwa swali lolote la Context7, tatua library ID kwanza (mara moja kwa kila kikao):
- Call
mcp_context7_resolve-library-idwith the technology name - Call
mcp_context7_query-docswith the returned library ID and a specific query
Writing Effective Queries
Kuwa maalum — jumuisha toleo, nia, na lugha:
# ❌ 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:
- Toleo when relevant (
.NET 8,Aspire 13,VS Code 1.96) - Nia ya kazi (
quickstart,tutorial,overview,limits,API reference) - Lugha for polyglot docs (
Python,TypeScript,C#)
Tamko: Nyaraka hii imetafsiriwa kwa kutumia huduma ya utafsiri wa AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Nyaraka ya asili kwa lugha yake inapaswa kuchukuliwa kama chanzo chenye mamlaka. Kwa taarifa muhimu, tunapendekeza tafsiri ya kitaalamu iliyofanywa na mtafsiri wa binadamu. Hatubebei uwajibikaji kwa kutokuelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.
Source: microsoft/ai-agents-for-beginners → translations/sw/.agents/skills/microsoft-docs/SKILL.md