Перейти к основному содержимому

Agentmail

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

Метаданные навыка​

ИсточникОпционально — установка через vibeos skills install official/email/agentmail
Путьoptional-skills/email/agentmail
Версия1.0.0
Платформыlinux, macos, windows
Тегиemail, communication, agentmail, mcp

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

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

Требования​

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

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

Используйте этот навык, когда необходимо:

  • Предоставить агенту собственный выделенный email-адрес
  • Автономно отправлять письма от имени агента
  • Получать и читать входящие письма
  • Управлять цепочками писем и перепиской
  • Регистрироваться в сервисах или проходить аутентификацию по email
  • Общаться с другими агентами или людьми по email

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

Настройка​

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

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

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

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

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

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

vibeos

Все 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 с именем пользователя (например, vibeos-agent)
    • Агент получает адрес: vibeos-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: "vibeos-outreach")
2. send_message (to: user@example.com, subject: "Привет", text: "...")
3. list_threads для проверки ответов

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

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

Проверка​

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

vibeos --toolsets mcp -q "Создай ящик AgentMail с именем test-agent и скажи мне его email-адрес"

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

Ссылки​