用途:通过 Microsoft Graph API 与 Microsoft 365 服务交互,覆盖 Teams、Outlook、OneDrive 和日历。
主要能力:读取当前用户资料;列出与发送 Outlook 邮件;列出与创建日历事件;列出已加入的 Teams 及频道、向频道发送消息;列出 OneDrive 根目录文件并上传文件。
使用方式:需设置环境变量 MS_GRAPH_TOKEN,值为 OAuth2 bearer token(委派或应用类型)。所有请求以 curl 调用 https://graph.microsoft.com/v1.0 下的端点,并在 Authorization 头中携带该令牌。例如读取资料:curl -s -H "Authorization: Bearer $MS_GRAPH_TOKEN" "https://graph.microsoft.com/v1.0/me"。查询邮件、事件、文件等可使用 $select、$filter、$top、$orderby 等 OData 查询参数提升效率。发送邮件、创建事件、发 Teams 消息等写操作使用 POST,上传文件使用 PUT 并指定 /content 路径。
适用场景:需要在自动化流程或智能体中读写 Microsoft 365 数据时使用,例如汇总邮件、安排会议、同步文件、推送 Teams 通知。
限制:令牌会过期,长时间运行需使用刷新令牌或仅应用认证;委派令牌代表用户,应用令牌代表应用本身;执行发送邮件、创建事件或发布消息前应始终确认。资料未提供具体权限范围、速率限制及错误处理细节。