Gmail收件箱自动打标签分类

原文要点

免费 n8n 模板：每五分钟触发一次，搜索 Gmail 中最多 50 封无用户标签的邮件（排除聊天、已发送和草稿），把每封邮件的头部、摘要/正文和 Gmail 类别信号发给 TypeSafe Jev（System One）模型，返回单个标签选择、置信度和“需要回复”评分。流程按置信度阈值决定最终标签：不确定但需处理的升级为 Action Required，低置信度进 Needs Review 兜底；先比对现有 Gmail 标签并一次性创建缺失标签，再重新加载标签 ID 逐一打标，并在同一轮执行内循环搜索-打标直到积压清空或达到最大轮数上限。需配置 Gmail OAuth2 和含 TypeSafe API 密钥的 HTTP Bearer 凭据，阈值变量为 CONFIDENCE_FLOOR 与 NEEDS_REPLY_FLOOR。

这次做成什么

在n8n部署这条Gmail自动打标流程，用三类合成测试邮件验证高置信直接打标、不确定升级Action Required、低置信进Needs Review三条路径，并确认标签自动创建。

准备什么

• n8n实例及Gmail OAuth2凭据（需读邮件和管理标签权限）
• TypeSafe API密钥，配置为HTTP Bearer Auth凭据
• 一个可接受自动打标的测试Gmail账号，避免先动真实收件箱

具体怎么做

1. 接入凭据并检查查询

   在n8n为所有Gmail节点选择Gmail OAuth2凭据，为TypeSafe Jev请求节点选择HTTP Bearer凭据。查看搜索节点的过滤条件：无用户标签、排除chats/sent/drafts、每次最多50封，确认符合你的测试账号。

2. 设定标签体系与阈值

   编辑发给TypeSafe Jev的标签分类标准（taxonomy），改成你要的类别，如Newsletter、Receipts、Client、Internal。保留Needs Review作为兜底，并设定CONFIDENCE_FLOOR与NEEDS_REPLY_FLOOR两个阈值；原文未给出推荐数值，先用较保守的高阈值试跑再逐步下调。

3. 用合成邮件手动触发

   在测试账号准备三封无标签邮件：一封特征明显的收据、一封含明确截止时间的客户请求、一封内容含糊的通知。手动执行一次工作流，观察每封的分类结果、置信度和最终标签走向。

4. 确认标签创建与循环清空

   检查Gmail中是否自动创建了缺失标签且无重复，标签已正确附加到邮件上。再准备一批几十封邮件，确认同一轮执行内流程会循环搜索-打标直到清空或达到最大轮数。

可直接复制的材料

{
  "labels": [
    {"name": "Newsletter", "criteria": "订阅推送、营销邮件、退订链接明显的群发内容"},
    {"name": "Receipts", "criteria": "订单确认、发票、付款凭证、物流通知"},
    {"name": "Client", "criteria": "来自外部客户域名的需求、报价或项目沟通"},
    {"name": "Action Required", "criteria": "置信度不足但needs_reply评分高于阈值、含截止时间或明确请求"},
    {"name": "Needs Review", "criteria": "置信度低于CONFIDENCE_FLOOR的兜底分类"}
  ],
  "thresholds": {"CONFIDENCE_FLOOR": "自定义，建议先高后低试跑", "NEEDS_REPLY_FLOOR": "自定义"}
}

输入与输出示例

本站虚构演示，置信度数值为示意，非TypeSafe Jev实际返回。

输入

三封测试邮件：①‘您的订单#88213已发货，运单SF123456’；②‘请在周五前确认合同附件条款’；③‘关于系统维护的相关事宜通知’（正文含糊）

对应输出

①模型返回Receipts、置信度0.95→直接打标Receipts；②返回Client、置信度0.62但needs_reply评分高于阈值→升级打标Action Required；③返回Newsletter、置信度0.31→低于CONFIDENCE_FLOOR，兜底进Needs Review。

做完检查这些

• 三封合成邮件分别落入Receipts、Action Required、Needs Review三条路径
• 缺失的标签在Gmail中被自动创建且重复执行不产生重名标签
• 几十封积压邮件在一轮执行内被循环处理直至清空或触达轮数上限
• 被打标邮件不再出现在‘无用户标签’搜索结果中

容易卡住的地方

• 原文未给出阈值推荐值，CONFIDENCE_FLOOR需自行试跑校准，过低会把错分邮件直接放行
• Gmail凭据必须包含管理标签权限，否则创建和附加标签会失败
• 排除条件不含已打标邮件，若taxonomy改名需同步处理历史标签
• 五分钟一次、每次50封的节奏对超大积压需要多轮，原文未承诺清空耗时