microsoft-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Microsoft Docs

微软文档

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

针对微软技术生态的研究技能。覆盖learn.microsoft.com及其以外的文档（VS Code、GitHub、Aspire、Agent Framework代码库）。

Default: Microsoft Learn MCP

默认选项：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.

Tool	Purpose
`microsoft_docs_search`	Search learn.microsoft.com — concepts, guides, tutorials, configuration
`microsoft_code_sample_search`	Find working code snippets from Learn docs. Pass `language` ( `python` , `csharp` , etc.) for best results
`microsoft_docs_fetch`	Get full page content from a specific URL (when search excerpts aren't enough)

Use

microsoft_docs_fetch

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

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

工具	用途
`microsoft_docs_search`	搜索learn.microsoft.com——包含概念、指南、教程、配置内容
`microsoft_code_sample_search`	从Learn文档中查找可运行的代码片段。传入 `language` 参数（如 `python` 、 `csharp` 等）可获得最佳结果
`microsoft_docs_fetch`	从特定URL获取完整页面内容（当搜索摘要信息不足时使用）

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

microsoft_docs_fetch

。

Exceptions: When to Use Other Tools

例外情况：何时使用其他工具

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

以下类别的文档不在learn.microsoft.com上，需使用指定工具。

.NET Aspire — Use Aspire MCP Server (preferred) or Context7

.NET Aspire — 使用Aspire MCP Server（优先）或Context7

Aspire docs live on aspire.dev, not Learn. The best tool depends on your Aspire CLI version:

CLI 13.2+ (recommended) — The Aspire MCP server includes built-in docs search tools:

MCP Tool	Description
`list_docs`	Lists all available documentation from aspire.dev
`search_docs`	Weighted lexical search across aspire.dev content
`get_doc`	Retrieves a specific document by 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	Use for
`/microsoft/aspire.dev`	Primary — guides, integrations, CLI reference, deployment
`/dotnet/aspire`	Runtime source — API internals, implementation details
`/communitytoolkit/aspire`	Community integrations — Go, Java, Node.js, Ollama

Aspire文档托管在aspire.dev，而非Learn平台。选择最佳工具取决于你的Aspire CLI版本：

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

MCP工具	说明
`list_docs`	列出aspire.dev上所有可用文档
`search_docs`	对aspire.dev内容进行加权词法搜索
`get_doc`	通过slug检索特定文档

这些工具随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：

库ID	用途
`/microsoft/aspire.dev`	主要内容——指南、集成、CLI参考、部署
`/dotnet/aspire`	运行时源码——API内部实现、细节
`/communitytoolkit/aspire`	社区集成——Go、Java、Node.js、Ollama

VS Code — Use Context7

VS Code — 使用Context7

VS Code docs live on code.visualstudio.com, not Learn.

Library ID	Use for
`/websites/code_visualstudio`	User docs — settings, features, debugging, remote dev
`/websites/code_visualstudio_api`	Extension API — webviews, TreeViews, commands, contribution points

VS Code文档托管在code.visualstudio.com，而非Learn平台。

库ID	用途
`/websites/code_visualstudio`	用户文档——设置、功能、调试、远程开发
`/websites/code_visualstudio_api`	扩展API——webviews、TreeViews、命令、贡献点

GitHub — Use Context7

GitHub — 使用Context7

GitHub docs live on docs.github.com and cli.github.com.

Library ID	Use for
`/websites/github_en`	Actions, API, repos, security, admin, Copilot
`/websites/cli_github`	GitHub CLI ( `gh` ) commands and flags

GitHub文档托管在docs.github.com和cli.github.com。

库ID	用途
`/websites/github_en`	Actions、API、代码库、安全、管理、Copilot
`/websites/cli_github`	GitHub CLI（ `gh` ）命令及参数

Agent Framework — Use Learn MCP + Context7

Agent Framework — 使用Learn MCP + Context7

Agent Framework tutorials are on learn.microsoft.com (use

microsoft_docs_search

), but the GitHub repo has API-level detail that is often ahead of published docs — particularly DevUI REST API reference, CLI options, and .NET integration.

Library ID	Use for
`/websites/learn_microsoft_en-us_agent-framework`	Tutorials — DevUI guides, tracing, workflow orchestration
`/microsoft/agent-framework`	API detail — DevUI REST endpoints, CLI flags, auth, .NET `AddDevUI` / `MapDevUI`

DevUI tip: Query the Learn website source for how-to guides, then the repo source for API-level specifics (endpoint schemas, proxy config, auth tokens).

Agent Framework教程位于learn.microsoft.com（使用

microsoft_docs_search

），但GitHub代码库包含的API级细节往往领先于已发布文档——尤其是DevUI REST API参考、CLI选项和.NET集成内容。

库ID	用途
`/websites/learn_microsoft_en-us_agent-framework`	教程——DevUI指南、追踪、工作流编排
`/microsoft/agent-framework`	API细节——DevUI REST端点、CLI参数、认证、.NET `AddDevUI` / `MapDevUI`

DevUI提示： 如需操作指南，请查询Learn网站资源；如需API级细节（端点 schema、代理配置、认证令牌），请查询代码库资源。

Context7 Setup

Context7 设置

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

Call
```
mcp_context7_resolve-library-id
```
with the technology name
Call
```
mcp_context7_query-docs
```
with the returned library ID and a specific query

对于任何Context7查询，需先解析库ID（每个会话仅需执行一次）：

调用
```
mcp_context7_resolve-library-id
```
并传入技术名称
使用返回的库ID和具体查询内容调用
```
mcp_context7_query-docs
```

Writing Effective Queries

编写有效查询

Be specific — include version, intent, and language:

undefined

请具体化查询内容——包含版本、意图和语言：

undefined

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


包含上下文信息：
- **版本**（相关时）：`.NET 8`、`Aspire 13`、`VS Code 1.96`
- **任务意图**：`quickstart`、`tutorial`、`overview`、`limits`、`API reference`
- **语言**（针对多语言文档）：`Python`、`TypeScript`、`C#`