SuperAPI AI 工具集

mail

办公与效率

查看项目

更新于 10-28 05:16

技能介绍

Tariboy Mail 是一个面向 AI 智能体的邮件处理技能。它的核心用途是让智能体在迭代过程中收到并处理信件,以及主动发送、回复、检查和恢复邮件。信件通过名为 tmail 的命令行工具操作,该工具由守护进程放在智能体的 PATH 上;技能目录内的 scripts/mail.sh 启动器会把全部参数转交给 tmail,并需相对于技能目录解析该启动器,而非当前工作目录。

主要能力:接收信件会在迭代提示的“Messages”下以内联形式出现,每封信带有自己的 id、发件人(from)、类型(kind)和主题;请求排在通知之前。对于请求,需要用 tmail reply ID TEXT 回复一次来关闭,若未回复则下一轮再次显示,5 次尝试后进入死信;对于通知,无需回复,本轮迭代结束即自动关闭;对于 task.question 请求,需在任务上用 ttasks comment KEY TEXT 回答(信件中的 answer: 行指明 key),而不是通过邮件回复。来自 system:* 发件人(如 system:goal、system:scripts、system:schedule)的请求,回复内容是智能体报告,因此须说明做了什么和结果,不能只写 ok 或 done。回复仅发给原发件人,且默认是通知;加上 --ask 后变为请求,要求对方回答。

使用方式:回复并关闭用 tmail reply ID TEXT [--ask],TEXT 为 - 时从 stdin 读取;发送用 tmail send --to PRINCIPAL[,PRINCIPAL] --subject S --text T [--deadline 5m] [--notice],收件人 principal 可为 agent:NAME、user:LOGIN、group:NAME 或 plugin:NAME,逗号分隔的 --to 会为每个收件人各写一封信;默认发送的是请求,--notice 表示通知,--deadline 设置期望答复时间,--text - 从 stdin 读正文。检查用 tmail inbox [--all](打开的信件,最旧在前)、tmail sent、tmail archive(已关闭信件,死亡信件标记 dead:REASON)、tmail show ID(单封信及其回复)。恢复用 tmail requeue ID 把死信放回收件箱。close、read、unread、clear 仅供操作员使用,智能体应以回复信件代替归档。

适用场景:智能体在迭代中需要处理收到的请求与通知、向用户/群组/其他智能体发送消息、查询收件与已发记录、恢复死信,以及按任务问题在任务系统内作答。

限制与注意事项:资料要求先完成阅读、命令与检查,再一次性发送能完整关闭请求的消息;不得发送临时或占位文本,不得承诺后续更正;无法确定的事实在同一文本中列为具名未知项并说明如何确认。只有在命令执行能力可用时才执行命令;若不可用,应返回准确命令,绝不声称已发送或已回复,除非命令成功。tmail --help 和 tmail COMMAND --help 是参数说明的权威来源。资料未提供安装方式、收费与价格、支持平台等事实。