microsoft-docs

Microsoft 文档

研究 Microsoft 技术生态系统的检索技能。涵盖 learn.microsoft.com 以及存在于其外部的文档（VS Code、GitHub、Aspire、Agent Framework 仓库）。

---

默认：Microsoft Learn MCP

对 learn.microsoft.com 上的所有内容使用这些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等等。对于绝大多数 Microsoft 文档查询，这是主要工具。

当需要完整教程、所有配置选项或搜索摘录被截断时，在搜索之后使用 microsoft_docs_fetch。

---

例外：何时使用其他工具

以下类别位于 learn.microsoft.com 之外。请改用指定的工具。

.NET Aspire — 使用 Aspire MCP Server（首选）或 Context7

Aspire 文档位于 aspire.dev，而不是 Learn。最佳工具取决于你的 Aspire CLI 版本：

CLI 13.2+（推荐）—— Aspire MCP 服务器包含内置的文档搜索工具：

这些包含于 Aspire CLI 13.2（PR #14028）。要更新：aspire update --self --channel daily。参考： https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 —— MCP 服务器提供集成查找（list_integrations, get_integration_docs），但不提供文档搜索。回退使用 Context7：

VS Code — 使用 Context7

VS Code 文档位于 code.visualstudio.com，而不是 Learn。

GitHub — 使用 Context7

GitHub 文档位于 docs.github.com 和 cli.github.com。

Agent Framework — 使用 Learn MCP + Context7

Agent Framework 教程位于 learn.microsoft.com（使用 microsoft_docs_search），但 GitHub 仓库 包含经常领先于已发布文档的 API 级别细节 —— 特别是 DevUI REST API 参考、CLI 选项和 .NET 集成。

DevUI 提示： 先查询 Learn 网站源码以获取操作指南，然后查询仓库源码以获取 API 级别的具体信息（端点模式、代理配置、身份验证令牌）。

---

Context7 设置

对于任何 Context7 查询，首先解析 library ID（每会话一次）：

1. 调用 mcp_context7_resolve-library-id 并传入技术名称
2. 调用 mcp_context7_query-docs 并使用返回的 library ID 以及具体查询

---

编写有效的查询

要具体 —— 包含版本、意图和语言：

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

---

免责声明： 本文件已使用 AI 翻译服务 Co‑op Translator（https://github.com/Azure/co-op-translator）进行翻译。尽管我们力求准确，但请注意自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威版本。对于关键信息，建议采用专业人工翻译。因使用本翻译而产生的任何误解或曲解，我们不承担责任。