Gmail新邮件AI分类打标与钓鱼识别

原文要点

该轻量n8n模板每分钟轮询Gmail未读邮件，先列出账号全部标签并匹配五个预设分类标签的ID；把每封邮件的主题、发件人、预览文本交给Google Gemini驱动的AI代理，强制归入Possible Fraud、Urgent、Ads、Review、Not Important五类之一；随后给原邮件打上对应Gmail标签，并把发件人、主题、分类结果、时间戳追加到Google Sheets。欺诈判断松紧可在代理系统提示词中调整。

这次做成什么

在n8n里用Gmail、Gemini、Google Sheets三个OAuth/API凭据搭起"每分钟扫描未读→五分类打标→表格留档"流程，并用一封虚构钓鱼邮件验证Fraud类能正确命中。

准备什么

• 一个Gmail账号及OAuth2凭据，已手动创建五个指定名称的标签
• 可正常调用目标模型的Google AI Studio Gemini API Key，并已核对当前配额
• 一个Google账号及OAuth2凭据，建好用于留档的Google Sheets表格
• n8n实例可使用Schedule Trigger、Gmail、AI Agent及Google Sheets节点

具体怎么做

1. 创建五个标签

   在Gmail设置→标签里新建名称完全一致的五个标签：⚠️ Possible Fraud、🔴 Urgent、📢 Ads、🔎 Review、⚪ Not Important。名称必须逐字符相同（含emoji），否则后续ID匹配失败。

2. 定时扫描未读邮件

   添加Schedule Trigger节点，间隔设为1分钟；接Gmail节点操作选Get Many，筛选条件is:unread（可加in:inbox），返回每封邮件的id、subject、from和snippet预览文本。

3. 匹配标签ID

   再加一个Gmail节点操作选Get All Labels列出全部标签，用Code节点按名字找出五个分类标签对应的Gmail内部labelId，存成映射表供打标步骤使用。

4. AI代理五分类

   添加AI Agent节点，挂Google Gemini Chat Model（凭据填Gemini API Key），系统提示词用本站材料中的完整版本，用户消息传入subject、from、snippet三项，要求只输出一个类别名。

5. 打标并写表留档

   Gmail节点对原邮件执行Add Labels，labelId取第三步映射结果；再用Set节点整理subject、from、category、classified_at四列，Google Sheets节点Append到目标表格。如需只对欺诈类发告警，可在打标后加IF节点判断category是否为⚠️ Possible Fraud再接邮件通知节点。

可直接复制的材料

你是邮件分类助手。根据用户提供的邮件主题、发件人和预览文本，把邮件归入以下五类之一，且只能输出类别名本身，不要输出任何解释、标点或多余文字。
可选类别：
⚠️ Possible Fraud：索取密码、验证码、银行卡信息；伪装官方要求点击链接转账或登录；中奖、冒充客服退款等典型钓鱼特征；发件人域名与声称机构明显不符。
🔴 Urgent：明确的时间紧迫事项，如截止今天的审批、故障告警、重要会议变更。
📢 Ads：促销、 newsletter、营销群发。
🔎 Review：需要人工阅读但不紧急的工作邮件，如文档审阅、普通咨询。
⚪ Not Important：无行动价值的通知、抄送、自动消息。
拿不准时归入 🔎 Review。

A1: subject
B1: from
C1: category
D1: classified_at
说明：Google Sheets节点选择Append Row，列映射依次填入邮件主题、发件人、AI分类结果、当前时间戳（用表达式{{$now.toISO()}}生成）。

输入与输出示例

本站虚构演示，发件人域名为虚构钓鱼样式；分类输出为示意，未真实调用Gemini

输入

向测试邮箱发一封未读邮件：发件人security-alert@paypa1-verify.tk，主题"【紧急】您的账户已被限制，请立即验证"，预览文本"尊敬的用户，您的账户存在异常，请在24小时内点击链接验证身份信息，否则将被永久冻结。"

对应输出

AI代理输出"⚠️ Possible Fraud"；该邮件被打上⚠️ Possible Fraud标签；Google Sheets追加一行：subject=【紧急】您的账户已被限制，请立即验证；from=security-alert@paypa1-verify.tk；category=⚠️ Possible Fraud；classified_at=2026-10-01T10:05:00.000Z。若配置了欺诈告警分支，同时向管理员发出一封提醒邮件。

做完检查这些

• 五个Gmail标签名称与要求逐字符一致，标签ID映射全部命中无空缺
• 一封明显的钓鱼测试邮件被归为⚠️ Possible Fraud且原邮件已带该标签
• 每条分类结果在Google Sheets中新增一行且四列内容对应正确
• AI代理输出偏离五个类别名时流程能兜底处理而不是写入无效分类

容易卡住的地方

• 标签名不含emoji或多了空格会导致ID匹配失败，打标步骤静默落空
• 每分钟轮询对邮件量大的账号可能消耗较多执行配额，可放宽到5分钟
• AI只看主题和预览文本，正文内链接型钓鱼可能被漏判，必要时改为读取全文
• Gemini免费额度有限速，邮件突发量大时可能出现429错误需要重试
• 告警分支只对Fraud触发，别让普通Urgent邮件也轰炸管理员