Back to Details

microsoft-docs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Microsoft Docs

Microsoft Docs文档

Tools

工具

ToolUse 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"
"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文档