SuperAPI AI 工具集

microsoft-code-reference

编程与开发

查看项目

更新于 10-16 01:14

技能介绍

用途:在编写、调试或审查使用 Microsoft SDK 的代码时,从微软官方文档中查找可运行的代码示例、核实 API 签名并定位报错原因。

主要能力与使用方式:

  • microsoft_code_sample_search:按任务与语言检索官方示例,例如 microsoft_code_sample_search(query: "upload blob managed identity", language: "python")。适合写代码前找可参照的模式、出错后对比已知正确样例、不确定初始化或配置时查看完整上下文。
  • microsoft_docs_search:按方法、类或包进行查询,例如 "BlobClient UploadAsync Azure.Storage.Blobs"、"DefaultAzureCredential class Azure.Identity",也可用于确认包名,如 "Azure Blob Storage NuGet package"、"azure-storage-blob pip package"。
  • microsoft_docs_fetch:按 microsoft_docs_search 返回的 URL 抓取完整页面,用于查看重载和完整参数细节。

排查错误:用 microsoft_code_sample_search 找可用示例并与自己的实现对比;针对具体错误用 microsoft_docs_search 与 microsoft_docs_fetch,如方法不存在查询 "[ClassName] methods [Namespace]"、类型不存在查询 "[TypeName] NuGet package namespace"、签名不对查询 "[ClassName] [MethodName] overloads" 后抓取整页、弃用警告查询 "[OldType] migration v12"、认证失败查询 "DefaultAzureCredential troubleshooting"、403 查询 "[ServiceName] RBAC permissions"。

验证流程:使用微软 SDK 生成代码前,先确认方法或包存在,再按需抓取完整细节,最后找可运行示例。简单查询第一步即可,复杂 API 建议三步都做。

限制与替代方式:若 Learn MCP 服务不可用,可用 mslearn CLI,例如直接运行 npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs",或执行 npm install -g @microsoft/learn-cli 后运行 mslearn search "...";对应命令为 mslearn code-search "..." --language ... 与 mslearn fetch "..."。search 或 code-search 加 --json 可输出原始 JSON。具体收费、配额与完整支持平台暂未提供。