用途:在编写或调试使用微软 SDK 的代码前,快速查证 API 是否存在、查找可运行示例并核对完整签名,从而减少猜测和错误。主要能力:microsoft_docs_search 按方法、类或包名检索文档;microsoft_code_sample_search 按任务与语言(如 csharp、python、javascript)查找官方可运行示例;microsoft_docs_fetch 抓取搜索命中的页面,用于查看重载、完整参数和签名。使用方式:写代码前用示例搜索找可参考模式;出错后对比已知正确示例;不确定初始化方式时查看完整示例上下文。API 查询可带命名空间提高精度,例如查询 "BlobClient UploadAsync Azure.Storage.Blobs" 或 "DefaultAzureCredential class Azure.Identity",也可用于确认包名,如 "Azure Blob Storage NuGet package"、"azure-storage-blob pip package"。排错场景:方法不存在查询“类名 方法 命名空间”,类型缺失查询“类型名 NuGet 包命名空间”,签名不符查询重载并抓取整页,弃用警告查询迁移文档,认证失败查询 DefaultAzureCredential 排错,403 查询服务 RBAC 权限。适用场景:方法名看似过于方便、混用 SDK 版本(如 v11 CloudBlobClient 与 v12 BlobServiceClient)、包命名不符合约定(.NET 的 Azure.* 与 Python 的 azure-*)、首次使用某 API 时。限制:资料仅说明上述三类工具与用法,未提供收费、价格、平台和其他功能信息;简单查询第一步可能足够,复杂 API 需完成全部三步验证。
microsoft-code-reference
写作与研究
更新于 10-16 01:16