Outlook 规则自动化管理器:用 Microsoft Graph API 编程管理邮件规则

前言

在 Outlook 里做邮件分类,常见做法是打开设置界面,一条一条点「创建规则」。这样做有两个问题:一是手工操作无法版本化、无法批量,二是复杂条件(多个条件组合、多步操作)在界面里容易配错。对于需要批量初始化规则、把规则纳入代码管理的开发者来说,更直接的办法是调用 Microsoft Graph API,直接对规则资源做增删改查。

下面介绍的是一个面向这类需求的 Agent Skill:Outlook 规则自动化管理器。它把 Graph API 的 messageRules 端点包装成可被 Agent 调用的能力,让邮件规则的创建和管理以编程方式完成。

这是什么

Outlook 规则自动化管理器是一个基于通用 SKILL.md 格式的社区 Skill,由 user_3c6cb52e 发布并维护,在 SkillHub 上归类为 office-efficiency,版本 1.0.0。

它解决的问题是:Agent 需要帮用户创建或修改 Outlook 收件箱规则时,不必手写 Graph API 的请求体和鉴权逻辑,而是通过 Skill 定义的能力,以结构化方式描述规则条件与操作序列,由 Skill 完成调用。

核心功能

根据抓取到的简介,该 Skill 的核心能力如下:

  • 使用 Microsoft Graph API 的 /me/mailFolders/inbox/messageRules 端点,以编程方式创建和管理 Outlook 邮件规则。
  • 支持「操作序列」形式的复杂条件链,即一条规则里可以包含多个条件和多个连续操作,用于实现自动邮件分类(如按发件人、主题、关键词等条件把邮件移动到指定文件夹、标记或转发)。
  • 属于「需要 API Key」类 Skill(标签 requires_api_key=true),意味着使用时需要先准备好 Microsoft Graph 的访问凭据。

安装与启用

需要说明的是:本文撰写时,该 Skill 的官方页面(https://api.skillhub.cn/user_3c6cb52e/outlook-rule-automation-manager 与 SkillHub 页面 https://www.skillhub.cn/skills/user_3c6cb52e/outlook-rule-automation-manager)均无法正常访问,抓取到的资料中也没有包含安装命令、目录结构或配置字段。因此本节不给出具体安装命令,以免编造。

从通用 SKILL.md 约定来看,这类 Skill 通常的启用方式是:

1、在支持 Skill 的 Agent 客户端(如 Cursor、Claude Code、Codex CLI 等)中,把 Skill 放入对应的 skills 目录,或通过 SkillHub 页面一键安装。
2、配置 Microsoft Graph 访问凭据。该 Skill 需要 API Key,因此使用前需先向 Microsoft 申请具有 Mail.ReadWrite 权限的 Azure AD 应用注册,并把访问令牌配置到 Skill 指定的位置。
3、在对话中明确告知 Agent 使用该 Skill,例如说明「帮我把来自某个域名的邮件自动移动到文件夹 X」。

以上第 1、3 步是 SKILL.md 通用约定的通行做法,第 2 步的权限名来自 Microsoft Graph 文档;该 Skill 页面本身未提供任何配置说明,实际配置项需以页面恢复后或安装包内的 SKILL.md 为准。

典型用法

由于官方页面无法访问,本节的示例基于该 Skill 所调用的 Microsoft Graph API messageRules 端点公开文档给出,用于说明该 Skill 背后的请求形态,而非该 Skill 自身的参数格式。

创建一条「来自某个发件人的邮件自动移动到指定文件夹」的规则,Graph API 的请求形如:

POST https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messageRules
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "displayName": "自动归档 domain.com 邮件",
  "conditions": [
    {
      "senderContains": ["@domain.com"]
    }
  ],
  "actions": [
    {
      "moveToFolderId": "<目标文件夹ID>"
    }
  ]
}

Skill 的价值在于:Agent 收到「以后 domain.com 的邮件都放到归档文件夹」这类自然语言需求时,可以自动生成上述结构(包括条件与操作序列),并完成鉴权和提交,而不是让用户去界面上手工点选。

适用场景与注意

适合:

  • 需要批量初始化 Outlook 规则、把规则清单当作代码资产维护的开发者或运维场景。
  • Agent 类工具中需要「读邮件并自动分类」的自动化流程,且规则条件较复杂(多条件、多操作)的场景。

注意:

  • 该 Skill 是 community 来源、版本 1.0.0,使用前建议通读其 SKILL.md,确认请求范围和凭据管理方式。
  • 抓取到的简介提到支持「操作序列的复杂条件链」,具体条件字段和操作类型受 Graph API messageRules 模型限制,超出模型范围的需求无法通过该端点实现。
  • 规则创建在邮箱侧即时生效,建议先用测试邮箱或测试文件夹验证条件逻辑,避免误分类正式邮件。
  • 凭据方面,该 Skill 标记为 requires_api_key,Graph API 使用 OAuth 2.0 访问令牌,不要把令牌明文写进代码或提交到版本库。

结尾

Outlook 规则自动化管理器的价值在于把「配规则」这件界面操作变成一次可复现、可版本化的 API 调用,并让 Agent 能直接参与规则的创建与调整。它依赖 Microsoft Graph API 的 messageRules 端点,属于有明确 API 边界、有凭据要求的 Skill,用之前把鉴权和条件逻辑准备好即可。

官方地址:https://api.skillhub.cn/user_3c6cb52e/outlook-rule-automation-manager
SkillHub 页面:https://www.skillhub.cn/skills/user_3c6cb52e/outlook-rule-automation-manager

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

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

小夜