mail

用途

该技能用于通过 Shift 操作 Gmail 邮件，涵盖三类需求：列出最近的 Gmail 邮件会话、查看某个会话的详情、发送新邮件。适合在需要快速浏览收件箱、在手动回复前了解会话上下文，或直接发送邮件的场合使用。

主要能力

• 列出 Gmail 会话（list-threads），支持指定查询条件与返回数量，例如按标签或时间范围筛选。
• 查看单个会话详情（get-thread），通过 threadId 获取指定会话内容。
• 发送邮件（send），支持纯文本（text）和 HTML（html）两种正文形式，收件人可为单个地址或地址数组。

认证方式

该技能使用当前智能体已连接的 gmail provider 凭据进行认证。

使用方式

读取类操作通过 Shift 的 Skill Router 调用，使用 curl 向 $SHIFT_LOCAL_GATEWAY/skill-router/invoke 发送 POST 请求，请求体中指定 skillProvider 为 gmail、skill 为 mail、action 为对应操作，并在 input 中传入参数。

列出会话示例：

curl -X POST "$SHIFT_LOCAL_GATEWAY/skill-router/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "skillProvider": "gmail",
    "skill": "mail",
    "action": "list-threads",
    "input": {
      "query": "label:inbox newer_than:7d",
      "maxResults": 10
    }
  }'

获取会话示例：

{
  "skillProvider": "gmail",
  "skill": "mail",
  "action": "get-thread",
  "input": {
    "threadId": "THREAD_ID"
  }
}

发送邮件使用预编译代码技能：

node dist/index.js '{"operation":"send","to":"user@example.com","subject":"Hello","text":"Hi from Shift."}'

发送 HTML 邮件示例：

node dist/index.js '{"operation":"send","to":["user@example.com"],"subject":"Weekly Digest","html":"<h1>Weekly Digest</h1><p>Everything is on track.</p>"}'

适用场景

• 查看最近收件箱会话。
• 在手动回复前查看会话详情。
• 发送纯文本或 HTML 邮件。

限制

除上述内容外，关于该技能的调用频率限制、权限范围、错误处理方式、是否支持附件或抄送密送等，资料中暂未提供。