Agent Skills
返回列表
🏢

Gmail API 线程标签分类

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/gmail-api-thread-label-triage

技能介绍

要解决什么问题

传统收件箱清理脚本通常逐条扫描 users.messages，把每封邮件当作独立事件处理。这种做法在支持、招聘或创始人收件箱里很容易翻车：同一线程里用户补充了订单号、候选人回复了面试时间，单看最新一封邮件会丢失前文约定，导致重复回复或误判优先级。

技能如何工作

这个技能把处理粒度从单条消息提升到整个会话线程，核心是组合 Gmail API 的三个入口：

  • users.threads：拉取线程级数据，保留会话内的上下文连贯性，而不是孤立的邮件片段
  • users.messages：在线程内部按需读取具体消息，提取关键实体如订单号、截止日期、候选人状态
  • users.labels：基于线程维度打标签或调整标签，完成分类与优先级排序，而不是只移动单封邮件

典型流程是：先通过 users.threads.list 获取待处理线程，再在线程上下文中做判断，最后用 users.labels.modify 落标签。适合需要按会话整体做路由的场景，例如客服工单分派、候选人邮件归档、创始人收件箱的高频对话识别。

适用边界与注意点

  • 需要 Google 账号、启用 Gmail API 的 Google Cloud 项目，以及配置好的 OAuth 2.0 凭据
  • 运行环境依赖 Python 或 Node.js 之一
  • 标签体系需要提前规划，技能文档建议先设计一套用于组织消息和线程的标签方案
  • 读取线程内容会消耗 API 配额，批量处理大收件箱时应控制分页与调用频率
  • 官方配置细节见 Gmail API 文档，涉及权限范围与令牌管理需按文档执行

使用场景

  • 客服负责人处理积压工单时，需要按线程上下文将相似对话归类到对应标签下
  • 招聘专员归档候选人邮件时，需要按线程整体判断当前面试阶段并打上阶段标签
  • 创始人清理收件箱时，需要识别同一线程的多次往返并将高优先级对话打标置顶
  • 运维人员排查告警邮件时，需要读取整个线程的消息记录来定位重复上报的根因

适合人员

  • 需要按线程上下文分派客服工单的技术支持负责人
  • 需要批量归档和分类候选人邮件的招聘流程管理者
  • 需要定期清理收件箱并按对话优先级排序的创始人或高管
  • 需要基于线程记录排查邮件类告警的运维或 SRE 工程师