Перейти к содержанию

На этой странице

Дайте агенту собственный выделенный почтовый ящик через AgentMail. Отправляйте, получайте и управляйте электронной почтой автономно, используя принадлежащие агенту адреса электронной почты (например, hermes-agent@agentmail.to).

Метаданные навыка​
Источник
Путь
Версия
Теги

Справочник: полный SKILL.md​

info Ниже приведено полное определение навыка, которое Hermes загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навык активен.

AgentMail — Почтовые ящики, принадлежащие агенту

Требования​

  • API-ключ AgentMail (требуется) — зарегистрируйтесь на https://console.agentmail.to (бесплатный тариф: 3 ящика, 3 000 писем в месяц; платные тарифы от $20/мес)
  • Node.js 18+ (для MCP-сервера)

Когда использовать​

Используйте этот навык, когда вам нужно: * дать агенту собственный выделенный адрес электронной почты * отправлять электронные письма автономно от имени агента * получать и читать входящие письма * управлять почтовыми цепочками и перепиской * регистрироваться в сервисах или проходить аутентификацию по электронной почте * общаться с другими агентами или людьми по электронной почте

Это НЕ для чтения личной почты пользователя (для этого используйте himalaya или Gmail). AgentMail даёт агенту собственную идентичность и почтовый ящик.

Настройка​

1\. Получите API-ключ​

  • Перейдите на https://console.agentmail.to
  • Создайте аккаунт и сгенерируйте API-ключ (начинается с am_)

2\. Настройте MCP-сервер​

Добавьте в ~/.hermes/config.yaml (вставьте ваш реальный ключ — переменные окружения MCP не раскрываются из .env):

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

[/code]

3\. Перезапустите Hermes​

[code] hermes

[/code]

Все 11 инструментов AgentMail теперь доступны автоматически.

Доступные инструменты (через MCP)​

Инструмент Описание
list_inboxes Список всех почтовых ящиков агента
get_inbox Получение информации о конкретном ящике
create_inbox Создание нового ящика (получение реального email-адреса)
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 сообщения и текстом ответа

Примеры рабочих процессов​

Регистрация в сервисе:

[code] 1. create_inbox (username: "signup-bot")
2. Используйте адрес ящика для регистрации в сервисе
3. list_threads для проверки письма подтверждения
4. get_thread для чтения кода подтверждения

[/code]

Контакт агента с человеком:

[code] 1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads для проверки ответов

[/code]

Подводные камни​

  • Бесплатный тариф ограничен 3 ящиками и 3 000 писем в месяц
  • Письма приходят с домена @agentmail.to на бесплатном тарифе (собственные домены на платных тарифах)
  • Требуется Node.js (18+) для MCP-сервера (npx -y agentmail-mcp)
  • Необходимо установить пакет mcp для Python: pip install mcp
  • Входящая почта в реальном времени (вебхуки) требует публичного сервера — для личного использования используйте опрос list_threads через cron-задачу

Проверка​

После настройки проверьте работу с помощью:

[code] hermes --toolsets mcp -q "Создай почтовый ящик AgentMail с именем test-agent и скажи мне его email-адрес"

[/code]

Вы должны увидеть возвращённый адрес нового ящика.

Ссылки​