用途:在应用中集成 Microsoft Graph 以访问 Microsoft 365 数据与服务时使用本技能。实施前应先确定目标语言:项目含 .cs/.csproj/.sln 或用户要求 C# 时用 .NET 流程(references/dotnet.md);含 package.json/.ts/.js 或要求 Node.js/浏览器指导时用 TypeScript/JavaScript 流程(references/typescript.md);含 .py/pyproject.toml/requirements.txt 或要求 Python 时用 Python 流程(references/python.md);多语言时按编辑文件语言或询问用户。
主要能力:认证模式选择建议——后台服务/守护进程用客户端凭据,代理用户用 OBO,Azure 内运行用托管标识(优先于密钥),CLI/本地用设备代码或交互式浏览器,单页应用用授权代码 + PKCE;不应在需要用户上下文时使用客户端凭据。SDK 用法:复用单个 GraphServiceClient,使用 Azure Identity 凭据,流畅 API 调用,await 异步,使用 $select/$filter/$expand,处理分页(@odata.nextLink、PageIterator、$top)。高级模式包括 $batch(最多 20 个调用,按 id 匹配乱序响应)、增量查询、变更通知(订阅、续订、验证令牌)、限流(429 与 Retry-After 头)。权限方面区分应用与委派权限,最小权限原则,需管理员同意。
使用方式:先确定语言并阅读对应参考文件,判断认证场景,查阅实时文档(Graph 概览、Graph Explorer、权限参考)与 Microsoft Docs MCP 工具,再实现分页与重试,同步场景优先增量查询。完成标准包括认证流程匹配场景、客户端复用、分页处理、429 处理、最小权限、不硬编码密钥。限制:务必基于当前官方文档与 SDK 版本,不依赖记忆;价格、平台与其它未提供信息暂未提供。