🏠 Главная › user guide › email agentmail

{/ Эта страница автоматически создается на основе файла SKILL.md навыка с помощью сайта site/scripts/generate-skill-docs.py. Редактируйте исходный код SKILL.md, а не эту страницу. /}

Агентская почта

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

Метаданные навыков
Источник Необязательно — установите с помощью hermesskills installofficial/email/agentmail
Путь необязательные навыки/электронная почта/агентская почта
Версия 1.0.0
Платформы Linux, MacOS, Windows
Теги электронная почта, коммуникация, агентная почта, mcp

Ссылка: полная версия SKILL.md:::информация

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

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

Требования

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

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

Это НЕ для чтения личной электронной почты пользователя (используйте для этого 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

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

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

Инструмент Описание
list_inboxes Список всех входящих сообщений агентов
get_inbox Получить подробную информацию о конкретном почтовом ящике
create_inbox Создать новый почтовый ящик (получает реальный адрес электронной почты)
удалить_входящие Удалить входящие
list_threads Список веток электронной почты во входящих
get_thread Получить конкретную цепочку писем
отправить_сообщение Отправить новое письмо
reply_to_message Ответить на существующее письмо
forward_message Переслать письмо
обновление_сообщение Обновить метки/статус сообщений
get_attachment Загрузить вложение к электронной почте

Процедура

Создайте почтовый ящик и отправьте электронное письмо

  1. Создайте отдельный почтовый ящик:
  2. Используйте create_inbox с именем пользователя (например, hermes-agent)
  3. Агент получает адрес: hermes-agent@agentmail.to
  4. Отправьте электронное письмо: – Используйте send_message с inbox_id, to, subject, text.
  5. Проверьте ответы:
  6. Используйте list_threads для просмотра входящих разговоров.
  7. Используйте get_thread для чтения определенной темы.

Проверьте входящую электронную почту

  1. Используйте list_inboxes, чтобы найти идентификатор своего почтового ящика.
  2. Используйте list_threads с идентификатором папки «Входящие», чтобы видеть разговоры.
  3. Используйте get_thread для чтения потока и его сообщений.

Ответ на электронное письмо

  1. Получите поток с помощью get_thread
  2. Используйте reply_to_message с идентификатором сообщения и текстом ответа.

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

Запишитесь на услугу:

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

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

Проверка

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

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

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

Ссылки