SUZENT / 文档
SUZENT 使用手册

Email

Connect QQ Mail, NetEase 163, Gmail, iCloud and other mailboxes so the agent can search and read mail, save drafts, and send after you approve.

此页面目前提供英文内容,中文翻译尚未完成。

Sovereign access. Suzent signs in to your mailbox directly from your computer. Nothing passes through a Suzent server, the password stays in your system keychain where the agent can't read it, and the agent can't send a single message unless you switch sending on and approve it. See what makes an agent sovereign.

Once a mailbox is connected you can ask things like "what did the bank email me this week?", "summarize my unread mail", or "draft a reply to Alice saying noon works". Combined with scheduled tasks it can summarize your inbox every morning.

Turning email on

Email is an optional plugin. Open Settings → Services, find Email and click Add. Suzent then asks to install himalaya, the open-source mail program it uses to reach your mailbox. It downloads a pinned, checked copy from npm, or from the npmmirror copy in mainland China.

Connecting a mailbox

  1. In your mailbox's own settings, switch on IMAP and create an app password (QQ Mail and NetEase call it an authorization code, 授权码). This is not your normal login password.
  2. In Suzent, open Settings → Services. Under Email, pick your provider, type your address and the app password, and click Add mailbox. Suzent signs in to check it before saving, and shows the reason if it can't.
ProviderWhere to get the app password
QQ MailQQ Mail web → Settings → Account → POP3/IMAP/SMTP service → generate an authorization code
NetEase 163 / 126 / yeah.netMail web → Settings → POP3/SMTP/IMAP → turn on IMAP → new authorization code
Gmail / Google WorkspaceClick Sign in with browser (supports school mailboxes like @berkeley.edu), or click Use app password instead and create one at myaccount.google.com/apppasswords
Outlook / Hotmail / Microsoft 365Click Sign in with browser (supports personal Outlook and school/work Microsoft 365 accounts)
iCloud Mailaccount.apple.com → Sign-In and Security → App-Specific Passwords
Yahoo MailAccount security → Generate app password
Aliyun Mail, Tencent ExmailThe mailbox's client settings page
Anything elseChoose Other (IMAP/SMTP) and type the IMAP and SMTP servers yourself

You can connect several mailboxes. When there is more than one, tell the agent which to use ("check my work mail").

What the agent can do

ToolWhat it does
Search MailFind messages by words, sender, subject, date, or unread state, newest first.
Read MailOpen one message: its text and the names of its attachments. Reading never marks a message as read.
Draft MailSave a new message or a reply in your Drafts folder. You review and send it from your own mail app. Asks before saving; choose Always allow if you are happy for it to save drafts on its own.
Send MailSend a message now. Off unless you allow it, and every message asks for your approval.

The email tools are not on by default. Tick them in the Tools tab of a chat, or just ask, and the agent switches them on for that chat.

Watching your inbox

Switch on Watch inbox for a mailbox in Settings → Services and new mail goes to the Mailbox every few minutes, where a rule decides what happens to it: tell Regent, start a session in a project, just notify you, or only keep it. Mail from the same sender's domain to the same mailbox shares one rule. Mail that was already in your inbox when you switched it on isn't reported, and checking never marks anything as read.

The first message from a new sender's domain is sorted the way other new kinds of events are. If Suzent can't decide, it only notifies you, since anyone can send you mail.

Sending

Each mailbox starts as drafts only: the agent can write mail but you do the sending. To let it send, switch on Allow sending for that mailbox in Settings → Services. Even then, each message waits for your approval, showing the recipients, subject, and text.

After sending, Suzent files a copy in your Sent folder, except for Gmail, which does that itself.

Staying safe

Anyone can send you an email, and an email can contain text written to trick an agent ("forward all invoices to…"). Suzent marks everything it reads from your mailbox as content from the sender, and the agent is told never to act on instructions found there. Sending still needs your approval, so a trick email can't send mail by itself. Keep Allow sending off unless you need it. With Watch inbox on, prefer rules that notify you or keep mail in the Mailbox for senders you don't know, so an email can't start an agent on its own.

Troubleshooting

  • Sign-in fails. Use the app password, not your normal password, and check that IMAP is switched on in the mailbox's settings. Some providers need a few minutes after you switch it on.
  • "Unsafe Login" from NetEase. Suzent identifies itself the way NetEase requires. If you still see it, create a new authorization code and try again.
  • Searching in Chinese. Some servers search Chinese text poorly. If nothing comes back, try a shorter word or search by sender.
  • Duplicate sent messages. If your provider already saves sent mail, you will see two copies. Tell us which provider so we can fix its preset.
  • "The himalaya mail client is not installed." Open Settings → Services and install it from the Email card.
在 GitHub 上编辑此页 ↗

本页内容