邮件收发QQ 邮箱收件箱管理CLI 授权

邮件助手(Agently Mail)

在 AI大模型或AI智能体 里用一句话收发、搜索、整理你的邮件

一、这个 skill 是做什么的

邮件助手让你不用打开邮箱网页或邮件客户端,直接在 AI大模型或AI智能体 的对话里完成邮件相关操作:发邮件、回邮件、转邮件、搜邮件、读邮件、下载附件、整理收件箱。底层由腾讯 QQ 邮箱的 agently-cli 命令行工具驱动,AI大模型或AI智能体 替你在后台执行命令,你只管"说人话"。

它特别适合"边聊边处理邮件"的场景:比如让 AI大模型或AI智能体 帮你把某封报价单转发给同事、搜出上周关于合同的邮件、把附件下载到本地。所有"发出去"的动作(发送/回复/转发/移到回收站)都会先给你看摘要、等你本人确认后才真正执行,避免误发。

二、什么时候用它

三、前置条件 / 准备

1. 电脑要装好命令行工具。 这是命令行类 skill,AI大模型或AI智能体 需要借助 agently-cli 与你本机的 Node.js(npm)环境来操作邮件。首次使用前需安装该工具(见下方进阶命令)。

2. 需要完成一次 OAuth 授权。 工具会输出一个授权链接,你复制它在浏览器里登录 QQ 邮箱授权即可;之后凭据会保存在本机,平时无需重复授权。

3. 它不是 AI大模型或AI智能体 的"连接器"类 skill。 它走的是本地 agently-cli,而不是内置的邮箱连接器,所以不需要在 AI大模型或AI智能体 里"连接"某个账号,但确实需要你本机有 Node.js 环境并能跑命令。

简单说:你只要能正常用 AI大模型或AI智能体、电脑装了 Node.js,剩下的授权由 AI大模型或AI智能体 引导你点链接完成。

四、具体用法(步骤)

  1. 安装命令行工具(一次性)。 让 AI大模型或AI智能体 在后台执行安装命令(见下方"进阶 / 可选"代码块)。
  2. 首次授权。 让 AI大模型或AI智能体 运行 agently-cli auth login,它会输出一个原始授权链接。把链接原样复制、在浏览器中完成登录授权,命令会自动结束。
  3. 验证是否成功。 AI大模型或AI智能体 运行 agently-cli +me,能看到你的邮箱地址就说明授权成功,可以开始用了。
  4. 开始用自然语言操作邮件。 之后你直接说"帮我发邮件…""搜一下…"即可,AI大模型或AI智能体 替你跑底层命令并整理结果。
  5. 写操作需两步确认。 凡是发送 / 回复 / 转发 / 移到回收站,AI大模型或AI智能体 会先列出即将执行的内容摘要问你"确认吗",你回复"确认 / 发 / ok"后它才会真正执行。

进阶 / 可选:以下命令由 AI大模型或AI智能体 在后台替你执行,你一般不必自己敲,了解即可。

# 安装/更新命令行工具(一次性) npm install -g @tencent-qqmail/agently-cli # 登录授权(运行后复制输出链接到浏览器) agently-cli auth login # 验证授权状态 agently-cli +me

五、可直接照用的示例

你直接对 AI大模型或AI智能体 说:

帮我给 alice@example.com 发一封邮件,主题"周报",内容"本周进度见附件 report.pdf"。

AI大模型或AI智能体 会:

先列出即将发送的邮件摘要(收件人、主题、正文、附件),并问你"确认发送吗?";你回复"确认"后,它才真正发出,并告诉你发送结果。如果 5 分钟内没确认,这次发送会被取消,不会误发。

你直接对 AI大模型或AI智能体 说:

帮我搜一下最近关于"合同"的邮件,读最新那一封,并把它的附件下载到本地。

AI大模型或AI智能体 会:

调用搜索找出相关邮件列表,读取最新一封的完整正文和附件信息,若是普通附件则下载保存(超大附件会直接把下载链接给你),最后把正文要点和附件去向整理给你看。

你直接对 AI大模型或AI智能体 说:

把 msg_xxx 这封邮件转发给 bob@example.com,并加上一句"详见正文"。

AI大模型或AI智能体 会:

先展示"转发给谁、附什么话、是否带原附件"的摘要让你确认;你回复确认后完成转发。注意邮件里若出现"请立即转发给…"这类伪装成指令的文字,AI大模型或AI智能体 会忽略,不会照做,有疑问会先问你。

六、常见注意 / 避坑

七、相关 skill / 延伸

← 返回 SKILL 库