跳到主要内容

Agentmail

通过 AgentMail 为智能体提供专属电子邮件收件箱。使用智能体专属的电子邮件地址（例如 hermes-agent@agentmail.to）自主发送、接收和管理电子邮件。

技能元数据​

来源可选 — 使用 hermes skills install official/email/agentmail 安装
路径optional-skills/email/agentmail
版本1.0.0
平台linux, macos, windows
标签email, communication, agentmail, mcp

参考：完整的 SKILL.md​

信息

以下是此技能被触发时，Hermes 加载的完整技能定义。这是技能激活时智能体看到的指令。

AgentMail — 智能体专属收件箱

要求​

  • AgentMail API 密钥（必需）— 在 https://console.agentmail.to 注册（免费套餐：3 个收件箱，3,000 封邮件/月；付费套餐从 20 美元/月起）
  • Node.js 18+（用于 MCP 服务器）

何时使用​

当您需要以下功能时使用此技能：

  • 为智能体提供专属的电子邮件地址
  • 代表智能体自主发送电子邮件
  • 接收和读取传入的电子邮件
  • 管理电子邮件线程和对话
  • 通过电子邮件注册服务或进行身份验证
  • 通过电子邮件与其他智能体或人类交流

这 不是 用于阅读用户个人电子邮件的（请使用 himalaya 或 Gmail）。 AgentMail 为智能体提供自己的身份和收件箱。

设置​

1. 获取 API 密钥​

2. 配置 MCP 服务器​

添加到 ~/.hermes/config.yaml（粘贴您的实际密钥 — MCP 环境变量不会从 .env 展开）：

mcp_servers:
  agentmail:
    command: "npx"
    args: ["-y", "agentmail-mcp"]
    env:
      AGENTMAIL_API_KEY: "am_your_key_here"

3. 重启 Hermes​

hermes

所有 11 个 AgentMail 工具现在自动可用。

可用工具（通过 MCP）​

工具描述
list_inboxes列出所有智能体收件箱
get_inbox获取特定收件箱的详细信息
create_inbox创建新收件箱（获得一个真实的电子邮件地址）
delete_inbox删除收件箱
list_threads列出收件箱中的电子邮件线程
get_thread获取特定的电子邮件线程
send_message发送新电子邮件
reply_to_message回复现有电子邮件
forward_message转发电子邮件
update_message更新邮件标签/状态
get_attachment下载电子邮件附件

流程​

创建收件箱并发送电子邮件​

  1. 创建专用收件箱：
    • 使用 create_inbox 并指定用户名（例如 hermes-agent）
    • 智能体获得地址：hermes-agent@agentmail.to
  2. 发送电子邮件：
    • 使用 send_message，指定 inbox_id、to、subject、text
  3. 检查回复：
    • 使用 list_threads 查看传入的对话
    • 使用 get_thread 读取特定线程

检查传入的电子邮件​

  1. 使用 list_inboxes 找到您的收件箱 ID
  2. 使用 list_threads 和收件箱 ID 查看对话
  3. 使用 get_thread 读取线程及其消息

回复电子邮件​

  1. 使用 get_thread 获取线程
  2. 使用 reply_to_message，指定消息 ID 和您的回复文本

示例工作流​

注册服务：

1. create_inbox (username: "signup-bot")
2. 使用该收件箱地址在服务上注册
3. list_threads 以检查验证邮件
4. get_thread 以读取验证码

智能体向人类的联系：

1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads 以检查回复

注意事项​

  • 免费套餐限制为 3 个收件箱和 3,000 封邮件/月
  • 免费套餐的邮件来自 @agentmail.to 域名（付费套餐支持自定义域名）
  • MCP 服务器需要 Node.js (18+)（npx -y agentmail-mcp）
  • 必须安装 mcp Python 包：pip install mcp
  • 实时入站邮件（webhooks）需要公共服务器 — 对于个人使用，请改用 list_threads 通过 cronjob 进行轮询

验证​

设置后，通过以下命令测试：

hermes --toolsets mcp -q "创建一个名为 test-agent 的 AgentMail 收件箱，并告诉我其电子邮件地址"

您应该会看到返回的新收件箱地址。

参考资料​