用途:该技能是 Microsoft Graph API 的编排中心,帮助在 Microsoft 365、Windows 及 Enterprise Mobility + Security 等云资源上开展 Graph API 集成、查询数据与构建应用。Graph 是统一的 REST API,基础地址为 https://graph.microsoft.com/{version}/{resource},版本分 v1.0(生产)与 beta(预览),数据格式为 JSON,认证采用 Azure AD 的 OAuth 2.0。
主要能力:按任务加载对应资源文件,覆盖应用与认证(应用注册、OAuth、凭据)、身份与访问(用户、组、组织、目录)、邮件操作(邮件、文件夹、附件、规则、签名)、日历与日程(事件、重复、会议、忙闲)、文件与存储(OneDrive、SharePoint、上传、共享)、Teams 与通信(团队、频道、聊天、状态、在线会议)、计划与笔记(Planner、To Do、OneNote)以及安全与治理(安全警报、合规、设备管理、报告)。
使用方式:先分析任务,确定资源、动作、身份与权限类型(委派或应用),再依据决策表加载相应资源文件,其中包含端点参考、CRUD 示例、查询参数、所需权限与错误处理。通用查询参数包括 $select、$filter、$orderby、$top、$skip、$expand、$count、$search;标准操作含 GET、POST、PATCH、DELETE。分页需跟随 @odata.nextLink,批量请求用 POST /$batch(1-20 个操作),增量查询用 GET /users/delta 配合 @odata.deltaLink。
适用场景与限制:适合需要统一访问 Microsoft 365 数据的集成与开发任务。需注意权限最小化、令牌安全存储、速率限制(429 时按 Retry-After 重试并指数退避)、beta 端点可能变更。SDK 提供 .NET、JavaScript/TypeScript、Python 版本,可用 Graph Explorer 交互测试。具体收费、价格与平台支持等资料暂未提供。