Chuyển tới nội dung chính

{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

Thư đại lý

Cung cấp cho đại lý hộp thư đến email chuyên dụng của riêng mình thông qua AgentMail. Gửi, nhận và quản lý email một cách tự động bằng địa chỉ email do đại lý sở hữu (ví dụ: Hermes-agent@agentmail.to).

Siêu dữ liệu kỹ năng​

NguồnTùy chọn — cài đặt với
`Hermes skills install official/email/agentmail
`
Đường dẫn

optional-skills/email/agentmail ` | | Phiên bản |

1.0.0 ` | | Nền tảng | Linux, macOS, Windows | | Thẻ |

email

, `communication

, `agentmail

, MCP |

Tham khảo: đầy đủ SKILL.md​

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

AgentMail - Hộp thư đến email do đại lý sở hữu

Yêu cầu​

  • Khóa API AgentMail (bắt buộc) — đăng ký tại https://console.agentmail.to (cấp miễn phí: 3 hộp thư đến, 3.000 email/tháng; gói trả phí từ $20/tháng)
  • Node.js 18+ (dành cho máy chủ MCP)

Khi nào nên sử dụng​

Hãy sử dụng kỹ năng này khi bạn cần:

  • Cung cấp cho đại lý địa chỉ email riêng
  • Gửi email tự động thay mặt đại lý
  • Nhận và đọc email đến
  • Quản lý chủ đề email và các cuộc hội thoại
  • Đăng ký dịch vụ hoặc xác thực qua email
  • Giao tiếp với các đại lý hoặc con người khác qua email

Điều này KHÔNG dành cho việc đọc email cá nhân của người dùng (sử dụng Himalaya hoặc Gmail cho việc đó). AgentMail cung cấp cho đại lý danh tính và hộp thư đến riêng.

Thiết lập​

1. Nhận khóa API​

)

2. Cấu hình máy chủ MCP​

Thêm vào

~/.Hermes/config.yaml ` (dán khóa thực của bạn - các biến env MCP không được mở rộng từ .env):

`

MCP_servers:
  agentmail:
    command: "npx"
    args: ["-y", "agentmail-MCP"]
    env:
      AGENTMAIL_API_KEY: "am_your_key_here"

`

### 3. Khởi động lại Hermes

`
`bash
Hermes

`

Tất cả 11 công cụ AgentMail hiện đều có sẵn tự động.

## Công cụ có sẵn (thông qua MCP)

| Công cụ | Mô tả |
|------|-------------|
| 
`list_inboxes
` | Liệt kê tất cả các hộp thư đến đại lý |
| 
`get_inbox
` | Nhận thông tin chi tiết của một hộp thư đến cụ thể |
| 
`create_inbox
` | Tạo hộp thư đến mới (lấy địa chỉ email thực) |
| 
`delete_inbox
` | Xóa hộp thư đến |
| 
`list_threads
` | Liệt kê các chủ đề email trong hộp thư đến |
| 
`get_thread
` | Nhận một chuỗi email cụ thể |
| 
`send_message
` | Gửi email mới |
| 
`reply_to_message
` | Trả lời email hiện có |
| 
`forward_message
` | Chuyển tiếp email |
| 
`update_message
` | Cập nhật nhãn/trạng thái tin nhắn |
| 
`get_attachment
` | Tải xuống tệp đính kèm email |

## Thủ tục

### Tạo hộp thư đến và gửi email

1. Tạo hộp thư đến chuyên dụng:
   - Sử dụng 
`create_inbox
` với tên người dùng (ví dụ: 
`Hermes-agent

)
   - Đại lý lấy địa chỉ: 
`Hermes-agent@agentmail.to

2. Gửi email:
   - Sử dụng 
`send_message
` với 
`inbox_id

, 
`to

, 
`subject

, 
``` text

`
3. Kiểm tra câu trả lời:
   - Sử dụng 
`list_threads
` để xem các cuộc hội thoại đến
   - Sử dụng 
`get_thread
` để đọc một chủ đề cụ thể

### Kiểm tra email đến
1. Sử dụng 
`list_inboxes
` để tìm ID hộp thư đến của bạn
2. Sử dụng 
`list_threads
` với ID hộp thư đến để xem cuộc hội thoại
3. Sử dụng 
`get_thread
` để đọc một chủ đề và tin nhắn của nó

### Trả lời email
1. Lấy sợi chỉ bằng 
`get_thread

2. Sử dụng 
`reply_to_message
` với ID tin nhắn và văn bản trả lời của bạn

## Ví dụ về quy trình làm việc`**Đăng ký dịch vụ:**

`

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

`
``**Tiếp cận giữa tác nhân với con người:**

`

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

`

## cạm bẫy
- Cấp miễn phí giới hạn ở 3 hộp thư đến và 3.000 email/tháng
- Email đến từ miền 

@agentmail.to
` ở cấp miễn phí (miền tùy chỉnh ở gói trả phí)
- Cần có Node.js (18+) cho máy chủ MCP (
`npx -y agentmail-MCP

)
- Phải cài đặt gói Python 
`MCP

: 
`pip install MCP

- Email gửi đến theo thời gian thực (webhooks) yêu cầu máy chủ công cộng - thay vào đó hãy sử dụng tính năng bỏ phiếu 
`list_threads
` qua cronjob cho mục đích sử dụng cá nhân

## Xác minh
Sau khi thiết lập, hãy kiểm tra với:

`

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

`

Bạn sẽ thấy địa chỉ hộp thư đến mới được trả về.

## Tài liệu tham khảo
- Tài liệu AgentMail: https://docs.agentmail.to/
- Bảng điều khiển AgentMail: https://console.agentmail.to
- Kho lưu trữ AgentMail MCP: https://GitHub.com/agentmail-to/agentmail-MCP
- Giá cả: https://www.agentmail.to/pricing