微软代码参考

工具

查找代码示例

使用 microsoft_code_sample_search 获取官方的、可工作的示例：

microsoft_code_sample_search(query： "upload file to blob storage", language： "csharp")
microsoft_code_sample_search(query： "authenticate with managed identity", language： "python")
microsoft_code_sample_search(query： "send message service bus", language： "javascript")

何时使用：

• 在编写代码之前——找到一个可以遵循的工作模式
• 在遇到错误之后——将你的代码与已知的良好示例进行比较
• 不确定初始化/设置——示例展示了完整的上下文

应用程序编程接口查找

# 验证方法是否存在（包含命名空间以提高精确度）
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# 查找类/接口
"DefaultAzureCredential class Azure.Identity"

# 查找正确的包
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

当方法有多个重载或你需要完整的参数详情时，获取完整页面。

错误排查

使用 microsoft_code_sample_search 查找可工作的代码示例，并与你的实现进行比较。对于特定错误，使用 microsoft_docs_search 和 microsoft_docs_fetch：

何时需要验证

在以下情况下始终进行验证：

• 方法名看起来”过于便利”（例如 UploadFile 与实际 Upload 不符）
• 混用软件开发工具包版本（v11 的 CloudBlobClient 与 v12 的 BlobServiceClient）
• 包名不符合约定（.NET 应为 Azure.*，Python 应为 azure-*）
• 首次使用某个应用程序编程接口

验证工作流程

在生成使用微软软件开发工具包的代码之前，验证其正确性：

1. 确认方法或包存在 — microsoft_docs_search(query： "[类名] [方法名] [命名空间]")
2. 获取完整详情（用于重载/复杂参数）— microsoft_docs_fetch(url： "...")
3. 查找可工作的示例 — microsoft_code_sample_search(query： "[任务]", language： "[语言]")

对于简单的查找，可能只需步骤 1。对于复杂的应用程序编程接口使用，请完成所有三个步骤。