Sallyport
МенюЗакрыть
Перейти к документации
ДокументацияПочта

Почта

Дайте агенту отправлять письма из вашего ящика, искать и читать почту и разбирать её, а пароль оставьте у Sallyport.

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

Агент пишет письмо, а Sallyport отправляет его из вашего ящика. Он ищет во входящих, читает письма и вложения, перемещает и помечает почту. Пароль остаётся в Sallyport, агент его не видит.

Подключите ящик

  • Откройте Подключить почтовый ящик. Из раздела Ключи сервисов путь такой: «Добавить ключ сервиса», затем «Электронная почта» в поле «Источник ключа».
  • Выберите «Почтовый сервис»: Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail, Fastmail, Zoho Mail или «Свой почтовый сервер». Серверы, порты и шифрование заполнятся сами, их можно поправить.
  • Введите «Адрес почты» и «Пароль ящика». Большинство сервисов ждут здесь пароль приложения, и форма ведёт на страницу, где его выдают.
  • Нажмите «Проверить подключение». Sallyport входит на каждый сервер и называет тот, что отказал.
  • Нажмите «Сохранить ящик». Пароль запечатан, прочитать его обратно нельзя. Ящик получают все агенты рабочего пространства.
СервисКакой пароль нужен
Gmail / Google WorkspaceПароль приложения. Google выдаёт его, когда включена двухэтапная аутентификация.
Outlook / Microsoft 365Пароль ящика. Администратор Microsoft 365 включает для ящика SMTP AUTH и вход по IMAP с паролем.
Yahoo MailПароль приложения со страницы безопасности аккаунта.
iCloud MailПароль для приложения из Apple Account.
FastmailПароль приложения с доступом к IMAP и SMTP.
Zoho MailПароль для приложения. Ящики организаций работают через smtppro.zoho.com и imappro.zoho.com.

Ящик отправляет письма через свой SMTP-сервер, а читается через IMAP-сервер. Выключите один из них в блоке «Отправка (SMTP)» или «Чтение (IMAP)», и его инструменты исчезнут вместе с ним.

Вход через Google или Microsoft

Ящики Gmail и Microsoft 365 входят через провайдера вместо пароля. В поле «Как Sallyport входит в ящик» выберите «Войти через Google» или «Войти через Microsoft» и нажмите «Сохранить и войти через Google» или «Сохранить и войти через Microsoft». Провайдер попросит разрешить доступ и вернёт вас на страницу ключа.

  • Sallyport хранит токен в хранилище и сам его обновляет, как любой ключ со входом через провайдера. Пароль не хранится.
  • Google входит через собственное приложение Sallyport. В Microsoft вы регистрируете своё приложение: форма даёт «Адрес возврата» для него и принимает «ID клиента» и «Секрет приложения». Приложению нужны IMAP.AccessAsUser.All, SMTP.Send и offline_access.
  • Токен уходит только на почтовые серверы самого провайдера: smtp.gmail.com и imap.gmail.com или smtp.office365.com, outlook.office365.com и smtp-mail.outlook.com.

Что может агент

Агент остаётся на своём MCP-подключении к Sallyport. Ящик даёт ему три инструмента, названных по подключению:

ИнструментЧто делаетКласс
_readlist_folders; search по папке; fetch одного письма по uid; одно вложение attachment по part. Чтение ничего не отмечает прочитанным.Чтение
_sendОтправляет одно письмо из ящика: to, cc, bcc, subject, text, html, reply_to, in_reply_to, references и attachments.Изменение
_changemove и copy в to_folder; flag и unflag с flags; delete; create_folder.Изменение. delete и пометка deleted необратимы.
Аргументы _read · непрочитанные письма от бухгалтерии
{
  "operation": "search",
  "from": "[email protected]",
  "unseen": true
}
Аргументы _send · ответ с файлом
{
  "to": "Ana Lima <[email protected]>",
  "bcc": "[email protected]",
  "subject": "Re: Invoice 42",
  "text": "Paid today. The receipt is attached.",
  "in_reply_to": "<[email protected]>",
  "attachments": [{ "filename": "receipt.csv", "content_type": "text/csv", "content_base64": "YW1vdW50LGR1ZQo0MjAwLEZyaWRheQo=" }],
  "intent": "Confirm the payment of invoice 42"
}
Аргументы _change · убрать оплаченный счёт в архив
{
  "operation": "move",
  "uids": [4102],
  "to_folder": "Archive",
  "intent": "File the paid invoice"
}
  • search возвращает общее число и самые новые письма, по умолчанию 20 и не больше 100, у каждого uid, отправитель, тема, дата и пометки.
  • fetch возвращает заголовки, текст, HTML и список вложений с их part.
  • Письмо всегда уходит из самого ящика. Скрытая копия доходит до своих получателей и не попадает в письмо.
  • Изменение касается только названных писем. uid, которого нет в папке, возвращается в missing.

Выберите, что ждёт вас

По умолчанию почта работает без вопросов. Чтобы видеть каждое письмо до отправки, откройте агента в разделе Агенты, найдите ящик в списке «Доступ» и поставьте в столбце «Изменение» значение «Нужно подтверждение» или включите «Спрашивать каждый раз».

Карточка подтверждения показывает всех получателей, включая скрытую копию, тему, текст и каждый файл с именем и размером. Уходит ровно то письмо, что на карточке.

Ограничения и защита

  • Одно письмо вмещает до 100 получателей, 20 вложений и 10 МиБ в сумме.
  • Письмо читается до 80 МиБ, его текст и HTML до 2 МиБ каждый. Более длинный ответ сохраняется, и его читает fetch_body.
  • Одна операция длится до 120 секунд.
  • Всегда TLS с проверкой сертификата: SMTP на 465 или 587, IMAP на 993 или 143. Порт 25 не принимается.
  • Журнал хранит получателей, тему и имена файлов каждого письма. Текст в него не попадает.