跳到主要內容

Agentmail

通過 AgentMail 為智能體提供其專用的電子郵件收件箱。使用智能體擁有的電子郵件地址（例如 hermes-agent@agentmail.to）自主發送、接收和管理電子郵件。

技能元數據​

來源可選 — 使用 hermes skills install official/email/agentmail 安裝
路徑optional-skills/email/agentmail
版本1.0.0
標籤email, communication, agentmail, mcp

參考：完整 SKILL.md​

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時智能體看到的指令。

AgentMail — 智能體擁有的電子郵件收件箱

要求​

  • AgentMail API 密鑰（必需）— 在 https://console.agentmail.to 註冊（免費層級：3 個收件箱，每月 3,000 封郵件；付費計劃從 $20/月起）
  • Node.js 18+（用於 MCP 服務器）

何時使用​

當您需要執行以下操作時，請使用此技能：

  • 為智能體提供其專用的電子郵件地址
  • 代表智能體自主發送電子郵件
  • 接收並閱讀 incoming 電子郵件
  • 管理電子郵件線程和對話
  • 註冊服務或通過電子郵件進行身份驗證
  • 通過電子郵件與其他智能體或人類進行溝通

這不用於讀取用戶的個人電子郵件（為此請使用 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. 創建專用收件箱：
    • 使用用戶名（例如 hermes-agent）調用 create_inbox
    • 智能體獲得地址：hermes-agent@agentmail.to
  2. 發送電子郵件：
    • 使用 send_message，參數包括 inbox_id、to、subject、text
  3. 檢查回覆：
    • 使用 list_threads 查看 incoming 對話
    • 使用 get_thread 閱讀特定線程

檢查 incoming 電子郵件​

  1. 使用 list_inboxes 查找您的收件箱 ID
  2. 使用收件箱 ID 調用 list_threads 查看對話
  3. 使用 get_thread 閱讀線程及其消息

回覆電子郵件​

  1. 使用 get_thread 獲取線程
  2. 使用 reply_to_message，傳入消息 ID 和您的回覆文本

示例工作流​

註冊服務：

1. create_inbox (username: "signup-bot")
2. Use the inbox address to register on the service
3. list_threads to check for verification email
4. get_thread to read the verification code

智能體向人類外聯：

1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads to check for replies

常見陷阱​

  • 免費層級限制為 3 個收件箱和每月 3,000 封郵件
  • 免費層級的電子郵件來自 @agentmail.to 域名（付費計劃支持自定義域名）
  • MCP 服務器 (npx -y agentmail-mcp) 需要 Node.js (18+)
  • 必須安裝 mcp Python 包：pip install mcp
  • 實時 inbound 電子郵件（webhooks）需要公共服務器 — 個人使用建議改為通過 cronjob 輪詢 list_threads

驗證​

設置完成後，使用以下命令進行測試：

hermes --toolsets mcp -q "Create an AgentMail inbox called test-agent and tell me its email address"

您應該看到返回的新收件箱地址。

參考​