SuperAPI AI 工具集

microsoft-graph-gateway

办公与效率

查看项目

更新于 10-15 16:46

技能介绍

用途:在 VS Code 中编排 Microsoft Graph 工作,负责把读取请求路由到合适来源,并在写入或高级读取前执行安全规则。适用于用户想读写 Microsoft 365 数据(邮件、收件箱、Outlook、会议、日历、联系人、OneDrive、SharePoint、Teams、Planner、To Do、用户、组等),或需要确切的 Graph 终结点、权限、查询选项、请求负载。

主要能力与路由:常见读取场景(收件箱检查、会议查找、文件发现、轻量摘要)优先走 WorkIQ;WorkIQ 无法回答、细节不足或用户要求精确 Graph 语义时回退到 Microsoft Graph。涉及精确终结点名或原始 REST 调用、精确属性与 $select/$filter/$expand 及 API 版本控制,或 Teams、Planner、To Do、目录、权限导向数据,以及架构、权限、限流、批处理、delta、webhook 行为时,直接使用 Microsoft Graph。所有写入(发送、创建、更新、移动、上传、回复、分配、响应等)都走 Microsoft Graph,且写入前必须显式确认,删除默认禁用或需更强确认。

使用方式:该技能是薄壳,执行底层可为 Graph CLI、自建 MCP 服务器或其他 Graph 网关。流程为:先把请求分类为常见读取、缺口读取或写入;读取按上述规则路由;缺口读取或写入先确定目标 Graph 表面并检查能力、路由与底层引用,再确定资源区域、终结点或工具、API 版本、最小权限配置与最小响应形状;写入前给出覆盖目标、动作和负载意图的确认摘要,再通过选定底层执行并报告结果及权限、限流或后续问题。脚本入口包括 Invoke-GraphGateway.ps1、invoke-graph-gateway.sh、New-GraphWriteConfirmation.ps1、Test-GraphGatewayScaffold.ps1、test-graph-gateway-scaffold.sh、Get-GraphGatewayRunnerStatus.ps1、get-graph-gateway-runner-status.sh、Install-MsGraphRunner.ps1、New-GraphEventResponseRequest.ps1、New-GraphGatewayAppConfig.ps1。

限制:有权威查询可用时不得凭记忆编造终结点或权限;委派权限与应用权限流程须分开;优先最小权限范围与最小投影。缺少运行时环境、具体认证和限流细节的说明暂未提供。