microsoft-docs

star 66.9k

查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容,則使用 Context7 與 Aspire MCP。

microsoft By microsoft schedule Updated 2/19/2026

name: microsoft-docs description: 查詢官方 Microsoft 文件以尋找跨 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教學與程式範例。預設使用 Microsoft Learn MCP,對於存在於 learn.microsoft.com 以外的內容,則使用 Context7 與 Aspire MCP。

Microsoft 文件

Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).


預設:Microsoft Learn MCP

Use these tools for everything on learn.microsoft.com — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries.

工具 用途
microsoft_docs_search 搜尋 learn.microsoft.com — 概念、指南、教學、設定
microsoft_code_sample_search 從 Learn 文件中尋找可執行的程式碼片段。傳入 languagepythoncsharp 等)以獲得最佳結果
microsoft_docs_fetch 從指定 URL 取得完整頁面內容(當搜尋節錄不足時)

Use microsoft_docs_fetch after search when you need complete tutorials, all config options, or when search excerpts are truncated.


例外情況:何時使用其他工具

The following categories live outside learn.microsoft.com. Use the specified tool instead.

.NET Aspire — 使用 Aspire MCP Server(建議)或 Context7

Aspire 文件位於 aspire.dev,而非 Learn。最佳工具取決於你的 Aspire CLI 版本:

CLI 13.2+(建議)— Aspire MCP 伺服器包含內建的文件搜尋工具:

MCP 工具 描述
list_docs 列出來自 aspire.dev 的所有可用文件
search_docs 在 aspire.dev 內容中進行加權詞彙搜尋
get_doc 以 slug 取得特定文件

These ship in Aspire CLI 13.2 (PR #14028). To update: aspire update --self --channel daily. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — The MCP server provides integration lookup (list_integrations, get_integration_docs) but not docs search. Fall back to Context7:

Library ID 使用於
/microsoft/aspire.dev 主要 — 指南、整合、CLI 參考、部署
/dotnet/aspire 執行時來源 — API 內部、實作細節
/communitytoolkit/aspire 社群整合 — Go、Java、Node.js、Ollama

VS Code — 使用 Context7

VS Code 文件位於 code.visualstudio.com,而非 Learn。

Library ID 使用於
/websites/code_visualstudio 使用者文件 — 設定、功能、偵錯、遠端開發
/websites/code_visualstudio_api 擴充功能 API — web 檢視、樹狀檢視、指令、貢獻點

GitHub — 使用 Context7

GitHub 文件位於 docs.github.comcli.github.com

Library ID 使用於
/websites/github_en Actions、API、儲存庫、資安、管理、Copilot
/websites/cli_github GitHub CLI (gh) 的指令與旗標

Agent Framework — 使用 Learn MCP + Context7

Agent Framework 的教學位於 learn.microsoft.com(使用 microsoft_docs_search),但 GitHub 倉庫 擁有常常比已發佈文件更新的 API 細節 — 尤其是 DevUI REST API 參考、CLI 選項,以及 .NET 整合。

Library ID 使用於
/websites/learn_microsoft_en-us_agent-framework 教學 — DevUI 指南、追蹤、工作流程編排
/microsoft/agent-framework API 細節 — DevUI REST 端點、CLI 旗標、驗證、.NET AddDevUI/MapDevUI

DevUI 提示: 先查詢 Learn 網站的來源以取得操作指南,然後再查閱倉庫來源以獲取 API 級別的具體內容(端點模式、代理設定、驗證令牌)。


Context7 設定

For any Context7 query, resolve the library ID first (one-time per session):

  1. 使用技術名稱呼叫 mcp_context7_resolve-library-id
  2. 使用回傳的 library ID 及特定查詢呼叫 mcp_context7_query-docs

撰寫有效查詢

Be specific — include version, intent, and language:

# ❌ 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:

  • 版本(視情況)(.NET 8Aspire 13VS Code 1.96
  • 任務目的quickstarttutorialoverviewlimitsAPI reference
  • 語言(針對多語系文件)(PythonTypeScriptC#

免責聲明: 本文件已使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們力求準確,但請注意,自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊,建議採用專業人工翻譯。我們不對因使用本翻譯而造成的任何誤解或誤譯承擔責任。

Install via CLI
npx skills add https://github.com/microsoft/ai-agents-for-beginners --skill microsoft-docs
Repository Details
star Stars 66,854
call_split Forks 22,070
navigation Branch main
article Path SKILL.md
More from Creator