microsoft-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Microsoft Docs

Microsoft Docs文档

Tools

工具

Tool	Use For
`microsoft_docs_search`	Find documentation—concepts, guides, tutorials, configuration
`microsoft_docs_fetch`	Get full page content (when search excerpts aren't enough)

工具	用途
`microsoft_docs_search`	查找文档——包括概念、指南、教程、配置内容
`microsoft_docs_fetch`	获取完整页面内容（当搜索摘要不足以满足需求时）

When to Use

使用场景

Understanding concepts — "How does Cosmos DB partitioning work?"
Learning a service — "Azure Functions overview", "Container Apps architecture"
Finding tutorials — "quickstart", "getting started", "step-by-step"
Configuration options — "App Service configuration settings"
Limits & quotas — "Azure OpenAI rate limits", "Service Bus quotas"
Best practices — "Azure security best practices"

理解概念 —— "Cosmos DB的分区机制是怎样的？"
学习服务 —— "Azure Functions概述"、"Container Apps架构"
查找教程 —— "快速入门"、"入门指南"、"分步教程"
配置选项 —— "App Service配置设置"
限制与配额 —— "Azure OpenAI速率限制"、"Service Bus配额"
最佳实践 —— "Azure安全最佳实践"

Query Effectiveness

查询有效性

Good queries are specific:

undefined

有效的查询应具备针对性：

undefined

❌ Too broad

❌ 过于宽泛

"Azure Functions"

✅ Specific

✅ 针对性强

"Azure Functions Python v2 programming model" "Cosmos DB partition key design best practices" "Container Apps scaling rules KEDA"


Include context:
- **Version** when relevant (`.NET 8`, `EF Core 8`)
- **Task intent** (`quickstart`, `tutorial`, `overview`, `limits`)
- **Platform** for multi-platform docs (`Linux`, `Windows`)

"Azure Functions Python v2编程模型" "Cosmos DB分区键设计最佳实践" "Container Apps缩放规则KEDA"


包含上下文信息：
- **版本**（相关时）（`.NET 8`, `EF Core 8`）
- **任务意图**（`quickstart`、`tutorial`、`overview`、`limits`）
- **平台**（针对多平台文档，如`Linux`、`Windows`）

When to Fetch Full Page

何时获取完整页面

Fetch after search when:

Tutorials — need complete step-by-step instructions
Configuration guides — need all options listed
Deep dives — user wants comprehensive coverage
Search excerpt is cut off — full context needed

在搜索后获取完整页面的场景：

教程 —— 需要完整的分步说明
配置指南 —— 需要查看所有列出的选项
深度研究 —— 用户需要全面的内容覆盖
搜索摘要被截断 —— 需要完整上下文

Why Use This

为何使用此工具

Accuracy — live docs, not training data that may be outdated
Completeness — tutorials have all steps, not fragments
Authority — official Microsoft documentation

准确性 —— 实时文档，而非可能过时的训练数据
完整性 —— 教程包含所有步骤，而非片段内容
权威性 —— 官方Microsoft文档