Outlook 邮件分拣助手:基于 Graph API 的自动化邮件分类

前言

收件箱里每天新增的邮件,有一部分是通知、简报和自动回复,真正需要处理的只有少数。开发者要么手工分类,要么写一套定时脚本读 Exchange,再自己维护 OAuth 登录、增量同步和规则同步。前者不可持续,后者的代码量往往比业务本身还大。

下面介绍的 Skill 把这件事收敛成一个可直接调用的能力:通过 Microsoft Graph API 读取 Outlook 消息,用零样本分类打上类别标签,再按规则把消息分拣到对应位置,并维护专注收件箱(Focused Inbox)的优先级。

这是什么

Outlook 邮件分拣助手(坐标 @user_3c6cb52e/outlook-mail-triage-assistant)是一个社区来源的 Agent Skill,发布者为 user_3c6cb52e,分类为 office-efficiency,当前版本 1.0.0,需要 API Key。

它解决的问题是:让 Agent 或自动化流程以统一方式完成 Outlook 邮件的读取、分类、规则应用和专注收件箱管理,而不是让每个调用方自己写一遍 Graph 集成。

核心功能

根据官方简介,能力集中在四点:

  1. 通过 Microsoft Graph API 访问 Outlook 邮件。
  2. 通过 @azure/msal-node 完成 Microsoft 身份平台的认证授权,而不是手工拼接 token。
  3. 对消息做零样本分类(zero-shot classification),即不需要预先训练模型,由模型直接判断消息所属类别。
  4. 应用 Outlook 规则,并管理专注收件箱的优先级。

其中第 3 点是设计上的取舍:零样本分类省掉了训练和标注环节,适合类别体系不固定、或接入初期需要快速试跑的场景。

安装与启用

官方资料未给出可直接复制的安装命令或 SKILL.md 的完整正文,因此这里只列出启用前必须确认的信息,避免照抄猜测的命令。

需要准备的配置:

  1. 一个具备 Mail.Read、Mail.ReadWrite、Offline.Access 等相应权限的 Microsoft 应用注册(具体范围以你实际使用的 Graph 端点为准)。
  2. 该应用注册对应的 client id、tenant、client secret 或集成证书,以及 Graph 权限授予后的管理员同意。
  3. Skill 自身要求的 API Key,资料中以 requires_api_key=true 标注。

官方页面:

https://www.skillhub.cn/skills/user_3c6cb52e/outlook-mail-triage-assistant

技能地址:

https://api.skillhub.cn/user_3c6cb52e/outlook-mail-triage-assistant

关于 Cursor、Codex CLI、Claude Code 之间的安装差异,当前资料没有分别说明,这里不补写。启用方式请以官方页面和随 Skill 提供的 SKILL.md 为准。

典型用法

官方简介给出的能力路径如下,具体调用形式以随包发布的说明为准:

  1. 认证:Skill 使用 @azure/msal-node 获取访问 Graph 的凭据。这一步决定了后续所有邮件操作能否执行,先确认应用注册与权限,再跑流程。
  2. 读取:从 Outlook 拉取消息列表。
  3. 分类:对每条消息做零样本分类,得到类别判断结果。
  4. 分拣:把分类结果落到 Outlook 规则上,由规则完成移动、标记等后续动作。
  5. 优先级:调整消息在专注收件箱中的优先级,决定它出现在收件箱还是待办区。

顺序上建议先跑通读取与分类,确认分类结果符合预期后再加规则和优先级变更。直接对生产邮箱启用分拣规则,改错了要回滚成本更高。

适用场景与注意

适合的场景:

  1. 需要把邮箱纳入自动化流程,但不想从零写 Graph 认证和同步逻辑。
  2. 分类维度相对稳定,但偶尔会新增类别,零样本方式比固定分类器更省维护。
  3. 已经在使用 Focused Inbox,希望按规则自动调整优先级。

需要注意的点:

  1. Skill 是社区来源,评分与下载量不代表官方背书。资料记录的评分为 100000、下载 985、安装 0,安装量为 0 意味着公开使用案例很少,跑之前建议先在测试邮箱上验证。
  2. 需要 API Key 和 Azure AD 应用注册,不是无配置即用。
  3. 邮件分类涉及内容读取,调用前确认权限范围,避免给到超出必要的委托权限。
  4. 版本 1.0.0 属于早期版本,接口和字段后续可能调整。

结尾

这个 Skill 的价值在于把「Graph 认证 + 零样本分类 + Outlook 规则 + 专注收件箱优先级」这条链路打包成一次调用,省掉的是集成层面的重复工作。先在小范围邮箱上试跑,确认分类和规则行为后再扩大到日常使用。

官方地址:https://api.skillhub.cn/user_3c6cb52e/outlook-mail-triage-assistant

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜