Agent Skills
返回列表
📁

Mailbot 可编程收件箱

办公效率 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/mailbot-programmable-inbox-ld2i。

技能介绍

解决什么问题

给 AI agent 接邮件时，常见做法是拿一个 SMTP 库或调用邮件 API，手动拼参数。这种方式有两个根本问题：一是缺少线程感知——agent 发出的回复往往不会保持在原线程内，导致收件人看到的是一封新邮件而不是回复；二是缺少可观测性——邮件是否送达、是否被打开、webhook 是否触发，这些信息要么拿不到，要么散落在不同平台的后台。

Mailbot 把这些问题抽象成面向 agent 的基础设施层。它不是在人类收件箱上做包装，而是为 agent 通信专门设计：每个 agent 拥有独立邮箱身份，所有消息按 Thread 组织，发送、接收、追踪、重放通过同一套 REST API 完成。

核心能力与工作方式

核心模型分五层：

  • Account：顶层所有权，管理 API key 的权限范围
  • Domain：默认使用共享沙盒域名 @mailbot.id，生产就绪后可切换自定义域名
  • Inbox：一个程序化邮箱标识，绑定到具体 agent
  • Thread：一次完整对话的时间线，保证上下文连贯
  • Message：线程中的一封入站或出站邮件

认证采用邮箱 OTP + API key 机制。开发者通过 POST /v1/auth/register 一步注册，系统自动分配沙盒 inbox 并返回 mb_ 前缀的 API key，后续请求都使用该 key 作为 Bearer token。

沙盒是默认路径，地址格式为 {username}--{accountShortId}@mailbot.id。这意味着 agent 在开发阶段不需要配置 DNS 或验证域名，可以直接开始集成测试。工作流稳定后再通过 API 添加自定义域名。

投递层面，Mailbot 使用自研 MTA，官方可达性指标为 99/100。webhook 回调内置 SSRF 防护和 fail-closed 限流策略，避免恶意邮件触发内部网络请求。

适用场景与边界

适合以下场景：需要给 agent 持久邮箱身份、按线程管理对话上下文、从入站邮件触发自动化动作、追踪投递与用户互动、在调试或故障恢复时重放 webhook 事件。

注意边界：Mailbot 是 agent 通信基础设施，不是人类邮箱的替代品。它没有传统邮件客户端的 UI 层，所有操作都通过 API 完成，若需要人工阅读邮件需自行搭建前端。自定义域名验证需要 DNS 配置，文档未展开细节，建议查阅 references/mcp-setup.md。

使用场景

  • 自动化流程需要专属邮箱身份，在沙盒地址接收验证邮件并调用 API 回发结果，避免使用个人邮箱账号。
  • 客服或通知类 agent 需要按线程保留上下文，把同一话题的后续邮件继续归入原 Thread，而不是开新会话。
  • 入站邮件需要触发后续动作，例如把工单内容转发到内部系统，并用 webhook 处理状态变化和失败重放。
  • 需要审计邮件发送记录、追踪投递与互动数据，排查某次任务未收到回复时是送达失败还是 webhook 未触发。

适合人员

  • 构建 agent 通信链路的后端工程师，需要快速拿到邮箱身份、API key 和沙盒环境来联调发送与接收逻辑。
  • 做自动化运维或客户支持的工程师，希望入站邮件按线程聚合，并用 webhook 触发工单流转和重试。
  • 负责合规与审计的技术人员，需要集中查看 agent 的邮件发送历史、投递状态和 API 使用记录。
  • 为内部工具补齐邮件能力的开发者，需要在不搭建自有 MTA 的情况下获得稳定投递和自定义域名支持。