SuperAPI AI 工具集

msgraph

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:为 AI 智能体提供最新、可离线检索的 Microsoft Graph API 知识,避免模型凭记忆编造端点。搜索工具完全离线运行,无需网络。

主要能力:内置 OpenAPI 端点索引(27,700+,含路径、方法、摘要、权限范围)、端点文档(6,200+,含委派/应用权限、查询参数、必需请求头、默认与仅 $select 属性)、资源架构(4,200+,含属性类型、支持的 $filter 运算符)以及社区示例。提供 sample-search、api-docs-search、openapi-search 三个检索命令,建议按“自身知识→sample-search→api-docs-search→openapi-search→参考文件”的渐进顺序查找。

使用方式:命令通过技能目录下的启动脚本运行,macOS/Linux 用 bash <path-to-this-skill>/scripts/run.sh <command> [args...],Windows 用 powershell <path-to-this-skill>/scripts/run.ps1 <command> [args...]。例如 bash /home/user/.opencode/skills/msgraph/scripts/run.sh openapi-search --query "send mail"。若已有 Graph MCP 服务器,本技能仅作知识层,由 MCP 负责认证与执行;否则可用 graph-call 直接调用,先运行 msgraph auth status 检查登录,支持委派与应用认证,写操作需 --allow-writes 且必须先经用户确认,DELETE 始终被阻止。

适用场景:查找 Graph 端点、权限、查询参数与资源属性,或执行读取类 Graph 调用。

限制:直接执行需访问 login.microsoftonline.com 与 graph.microsoft.com;默认 API 版本为 beta;目录对象的 $count/$search 需 ConsistencyLevel 头;429 需按 Retry-After 重试。其余细节暂未提供。