Электронная почта вашего агента¶
У каждого агента есть собственный адрес электронной почты. Письма, отправленные на него, попадают в почтовый ящик на сервере агента: агент может читать их, искать и отвечать, а вы — читать их в панели.
Адрес¶
Адрес вашего агента — agent + его номер + @mintbot.ai: у агента 1234 это
agent1234@mintbot.ai. Он доступен с момента создания агента на любом пакете,
и ничего настраивать не нужно.
Вы найдёте его в панели в разделе Настройки → Электронная почта, а также на небольшой карточке, которая открывается при нажатии на имя агента вверху боковой панели. Нажатие на адрес в карточке копирует его.
Для чего он пригодится:
- Регистрации, которые агент проходит за вас. Письмо с подтверждением приходит в его собственный ящик, поэтому он может прочитать код или ссылку и завершить задачу.
- Письма, связанные с работой агента: подтверждения заказов, счета, рассылки, которые вы хотите получать в кратком изложении, ответы людей, которым он писал.
- Письма вашему агенту из любой почтовой программы.
Ящик принадлежит агенту, а не отдельному человеку: все пользователи агента видят одни и те же письма. Письмо, которое прочитал один из вас, считается прочитанным для всех, а удалённое исчезает у всех.
Что агент делает с почтой¶
Просите обычными словами:
- «Пришёл ли счёт из типографии?»
- «Найди код подтверждения с сайта бронирования».
- «Что пришло по проекту магазина на этой неделе?»
- «Ответь Анне, что четверг подходит».
Агент может показывать список писем и искать в своей почте (по отправителю, дате, проекту, наличию вложений), читать письмо и сохранять его вложения, а также отправлять письма со своего адреса.
- Он пишет от своего имени, а не от вашего. Письма отправляются с адреса
агента. Если у агента есть имя, оно стоит в строке отправителя перед адресом:
Name <agent1234@mintbot.ai>. - Отправка входит в платные пакеты. В бесплатном пробном периоде агент получает почту, но не отправляет её.
- Никаких массовых рассылок. Агент отправляет до 100 писем в день, каждое — не более чем 20 получателям, суммарно — не более 300 получателям в день. Счётчик обнуляется в полночь UTC. Адрес не предназначен для рассылок или непрошеных коммерческих предложений.
- Частые возвраты писем приостанавливают отправку. Если слишком много писем агента не удаётся доставить (адреса не существуют), отправка приостанавливается на сутки, а затем возобновляется автоматически. На получение это не влияет.
Письмо — не инструкция
Вашему агенту может написать кто угодно, поэтому он воспринимает содержание письма как внешний материал: читает его и рассказывает вам о нём, но не действует по нему. Единственное исключение — список, который вы сами настраиваете ниже в разделе Инструкции по электронной почте.
Почтовый ящик в панели¶
Настройки → Электронная почта показывает почту: входящие, спам и отправленные письма, поиск по отправителю, теме и тексту, а также каждое письмо с текстом и вложениями. Вы можете отметить письмо как непрочитанное или удалить его.
Письмо можно закрепить: закреплённые письма отображаются в разделе Закреплённые независимо от папки, в которой находятся. Кнопка Удалить всё, которая очищает открытую папку, их не затрагивает.
Здесь вы можете писать и сами. Новое письмо открывает новый разговор с формой письма (получатели, тема, текст): заполните её и нажмите Отправить или попросите агента написать письмо прямо там. Ответить под открытым письмом позволяет ответить таким же образом. Ваши письма уходят с адреса агента, учитываются в его дневном лимите и сохраняются в разделе Отправленные, где все пользователи агента видят их рядом с письмами, которые отправил сам агент. Скрепка рядом с Отправить прикрепляет файлы (до 10, общим размером 7 MB): они сразу сохраняются вместе с черновиком и остаются на месте, когда вы возвращаетесь к нему позже. Файл можно также перетащить на форму. Корзина на краю формы удаляет черновик. Для текста доступно то же форматирование, что и в поле сообщения чата: Ctrl+B — полужирный, Ctrl+I — курсив, Ctrl+U — подчёркивание, Ctrl+S — зачёркивание (⌘ на Mac).
Или поручите написать агенту: Попросить агента ответить под письмом или Попросить агента написать в форме открывает чат с готовым запросом. Добавьте, что нужно сказать в письме, и отправьте. Агент покажет черновик и отправит его после вашего согласия.
Закрепите Электронную почту в боковой панели: она будет доступна одним нажатием, а рядом появится число непрочитанных писем.
Раздел Технические сведения внизу страницы свёрнут, пока вы его не откроете. Он показывает состояние отправки: сколько писем отправлено сегодня относительно дневного лимита, сколько писем за последнюю неделю вернулось недоставленными, приостановлена ли отправка, когда почта была получена в последний раз и насколько заполнен ящик.
Письма, похожие на спам, попадают в Спам. Уведомлений о них нет, и через 30 дней они удаляются, если вы их не закрепили.
Адрес для каждого проекта¶
Если вы используете проекты, у каждого есть собственный адрес: адрес агента с точкой и именем папки проекта.
agent1234.shop@mintbot.ai
Почта, отправленная туда, сразу попадает в папку этого проекта в почтовом ящике. Пока проекты включены, Настройки → Электронная почта сообщает об этом под адресом агента, показывая в качестве примера самый часто используемый проект: нажатие на адрес копирует его.
Откройте проект в панели, и Настройки → Электронная почта покажет его письма и адрес, который можно скопировать; переключатель над списком позволяет посмотреть почту другого проекта. Общее показывает всё: письма всех проектов и те, которые не относятся ни к одному.
Полезно знать:
- Вместо точки можно использовать плюс:
agent1234+shop@mintbot.ai— тот же адрес. - Письма несуществующему проекту (опечатка или удалённый проект) не возвращаются отправителю. Они приходят в общий почтовый ящик.
- Переименование проекта не меняет имя его папки, поэтому адрес остаётся прежним.
Когда приходит новая почта¶
В разделе Настройки → Электронная почта → Когда приходит новая почта выберите, где получать уведомления:
| Вариант | Что вы получаете |
|---|---|
| В панели и в Telegram | Оба варианта ниже. Это значение по умолчанию. |
| Только в панели | Уведомление с кнопкой, открывающей письмо. |
| Только в Telegram | Сообщение с отдельной кнопкой для каждого письма: нажатие показывает его текст прямо в чате. |
| Нигде | Ничего. Почта ждёт в ящике. |
Выбор действует для всех пользователей агента.
Инструкции по электронной почте¶
Вы можете разрешить выбранным людям давать агенту задания по электронной почте. По умолчанию это выключено. Чтобы включить, откройте Настройки → Электронная почта → Инструкции по электронной почте, включите переключатель и добавьте адреса, которым доверяете (до 20).
После этого, когда с одного из этих адресов пишут агенту:
- В панели открывается разговор с маленьким значком конверта, а письмо становится его первым сообщением.
- Агент выполняет то, о чём просят в письме.
- Он отвечает на письмо с результатом.
Ответ в той же почтовой цепочке продолжает тот же разговор, поэтому агент знает, что уже сделал.
Прежде чем добавить адрес:
- Учитывается только подтверждённая почта. Почтовый сервис отправителя должен подтвердить, что письмо действительно пришло с этого адреса (проверка называется DMARC, см. ниже). Письмо, которое лишь выдаёт себя за отправленное с адреса из списка, игнорируется, как и письмо, попавшее в Спам.
- Запросом считается только собственный текст письма. Его вложения и страницы, на которые ведут ссылки, — внешний материал: агент читает их, но не выполняет найденные там инструкции.
- Любой, кто может отправлять письма с адреса из списка, может управлять вашим агентом и сервером, на котором он работает. Добавляйте только адреса, которые вы контролируете или которым полностью доверяете.
- О некоторых действиях агент всё равно сначала спрашивает: удалении данных, тратах, передаче личных данных или доступа другим. Он отвечает и спрашивает разрешения, а не выполняет их на основании одного письма.
Какая почта считается подтверждённой¶
DMARC — проверка, позволяющая принимающему серверу подтвердить, что письмо действительно отправлено с домена в адресе From. Без неё любой может указать любой адрес отправителя.
- Работает без настройки: Gmail, Outlook, Hotmail, Yahoo, iCloud, Proton Mail, Fastmail, GMX, Zoho.
- Собственный домен (Google Workspace, Microsoft 365, почта хостинг-провайдера): работает, если для домена есть запись DMARC вместе с SPF или DKIM. Это настраивает тот, кто управляет доменом.
- Не учитывается: домен без записи DMARC, а также часто письма, автоматически пересланные или отправленные через список рассылки.
Письмо, не прошедшее проверку, не теряется: оно остаётся в ящике как обычная почта, просто его задание не выполняется.
Ограничения¶
- Входящее письмо может занимать до примерно 15 MB вместе с вложениями; отправляемое агентом — до 10 MB.
- Ящик вмещает до 2 GB. Когда он заполнен, приём новой почты откладывается, а сервер отправителя в течение нескольких дней просят повторить попытку позже. Удалите письма, чтобы освободить место.
- Пока работа агента приостановлена, его почта не принимается: сервер отправителя продолжает попытки, обычно в течение нескольких дней, и почта приходит, когда агент снова работает.