Repository navigation
Mailboxes
Deutsch: Postfächer
Mailboxes let the AI answer from your e-mails. Ask, for example, "Which mails about the project offer are still unread?", "What did we agree on with the print shop in March?", or "How can I improve my draft to the travel office?" The AI searches your mails, reads the ones that fit, and lists them below its answer.
AI Studio doesn't ask your mail server anew for each question. It keeps a local index of your mails on your computer and synchronizes it with the server in the background. The AI therefore finds mails by their meaning as well as by their words, and it answers quickly.
Requires AI Studio v26.10.1 or newer. Mailboxes are a prototype: a work in progress, so expect bugs and missing features. The AI only reads your mails. It doesn't send, move, delete, or flag any.
- Open "Settings" → "App Options".
- Under "Preview feature visibility", choose "Show also prototype features: these are works in progress; expect bugs and missing features".
- Under "Select preview features", choose both "RAG: Preview of our RAG implementation where you can refer your files or integrate enterprise data within your company" and "Mailboxes: Let the AI search and read your e-mails, kept in a local index on your computer".
Mailboxes build on the data sources, so they need both features. The navigation bar then shows "Data sources", and you can add mailboxes there.
- An embedding provider. It turns your mails into numbers that AI Studio can search. Set one up in "Settings" → "Configure Embedding Providers"; see Providers and Models. With an embedding provider in the cloud, every mail in the chosen folder and period goes to that provider, together with the text of its attachments, and embedding can cost money. AI Studio asks you to confirm this. An embedding provider on your own computer, for example, with ollama, keeps your mails with you.
- A mailbox with IMAP access, and its username and password. Many providers want a step from you first, such as switching IMAP on in your webmail or creating an app password. When you add a mailbox, AI Studio tells you what your provider requires.
Microsoft 365 and Outlook.com don't work yet: they no longer accept a password over IMAP, only a sign-in with Microsoft. A Microsoft Exchange Server of your organization works once your IT department has enabled IMAP for it.
Open "Settings" → "Configure Data Sources", or the gear icon on the "Data sources" page. Click "Add Data Source" and choose "Mailbox (IMAP)". Without an embedding provider, the entry reads "Mailbox (IMAP), requires an embedding provider" and can't be chosen. When your organization doesn't allow new mailboxes, it shows a lock.
Then work through the dialog from top to bottom.
- "Data Source Name": at most 40 characters. The AI sees this name, so choose one that tells what the mailbox is for.
- "Provider": choose your mail provider, and AI Studio fills in the server settings for you. The list starts with "Another provider", where you enter the settings yourself. Then follow the mail servers of your organization, marked with a building, if your IT department has set up any. Last come well-known providers.
For a mail server of your organization, a box tells you how to sign in and may link its instructions. For a well-known provider, it tells you what the provider requires, what to enter as the username, and links the instructions of the provider:
| Provider | Before you start |
|---|---|
| Gmail, iCloud Mail | Create an app password. Your usual password doesn't work. |
| GMX, WEB.DE | Enable IMAP in the settings of your webmail. With two-factor authentication, also create an app password. |
| mailbox.org | With two-factor authentication, create an app password. |
| IONOS, STRATO, Hetzner (konsoleH), Posteo | Nothing. |
| Microsoft Exchange Server | Your IT department enables IMAP for the server and for your mailbox. Ask them for the address of the server. |
Once AI Studio has filled in the server settings, they wait behind "Show Server Details", and the sign-in follows right away. With "Another provider", enter them yourself:
- "IMAP server host", for example,
imap.example.org. - "Port" and "Encryption": "TLS from the start (usually port 993)" or "STARTTLS (usually port 143)". AI Studio never connects without encryption.
Your organization may allow mailboxes only on its own mail servers. Then you choose one of them, and the server settings can't be changed.
- Enter your "Username" and your "Password". AI Studio keeps the password in the credential store of your operating system, under the name of the mailbox.
- Click "Test connection & load folders".
AI Studio adds a mailbox only after a successful test. When you later change the server settings or the password, it asks for a new test.
After the test, the dialog shows the folders of your mailbox:
- "Whole mailbox", the default: AI Studio indexes every folder apart from the trash and the junk folder.
- A folder: AI Studio indexes this folder together with its subfolders, and the AI reads only from there. This keeps, for example, the mails of a project apart from the rest. The trash and the junk folder can't be chosen.
Under "New folder", you can create a folder for this. AI Studio creates it on the server right away, inside the selected folder or at the top level of the mailbox.
With a folder, "Include sent mails and drafts?" decides whether your sent mails and your drafts come along. It's on by default. AI Studio recognizes these two folders by the mark your mail server gives them. Without a folder, they belong to the whole mailbox anyway.
- "Period": "The last 3 months", "The last 6 months", "The last 12 months", the default, "The last 24 months", or "All mails". AI Studio indexes the newest mails first. Flagged mails and drafts are always indexed, however old they are.
- "Index the text of attachments?": on by default. AI Studio then reads the text of attached documents: the same types as in a local folder, such as PDF, Word, Excel, PowerPoint, text files, and source code. Of other attachments, such as images, it keeps only the names.
- "Largest attachment to index, in MB": 10 MB by default, up to 2,048 MB. Of a larger attachment, only the name is indexed.
- "Embedding": the embedding provider. With one in the cloud, confirm that your mails may go to it.
- "Required provider confidence level": you have to choose one. Only providers with at least this level see the content of your mails, both the provider of the chat and the embedding provider. The levels range from "Very Low" to "High". See Provider Confidence.
- "Where a chat may send data after reading mails": mails come from strangers and may contain instructions meant for the AI. This setting decides where a chat may still send data once it has read from this mailbox. The default is "Only services configured in AI Studio": such a chat doesn't search the web, and it reads no web pages apart from those of the services configured in AI Studio, such as your Confluence wiki. See Where a chat may send data. Your organization may demand a stricter level.
"Show Expert Settings" offers:
- "Token limit" and "Token overlap": how AI Studio cuts your mails into pieces before embedding them. By default, a piece may be as long as the embedding provider takes at once.
- "How many mails do you want at most per search?": 10 by default, and at least 10.
Click "Add" at the end. AI Studio starts to synchronize the mailbox right away; see Synchronization.
The table of your data sources lists each mailbox with the buttons "Edit" and "Delete".
- Once AI Studio has indexed mails of a mailbox, its server, its username, and its folder can't be changed anymore. Another account or folder holds other mails, so add another mailbox for it.
- Everything else can be changed. A new embedding provider, a new token limit or overlap, and changed attachment settings make AI Studio index all mails again. It asks you first, since this takes a while and costs money with an embedding provider in the cloud.
- A changed period, or the switch for sent mails and drafts, takes effect right away: AI Studio synchronizes the mailbox once you save.
- When you rename a mailbox, its password stays. AI Studio stores it under the new name and deletes the old entry.
- "Delete" removes the index of the mailbox and its stored password from AI Studio. Your mails stay on the server as they are.
While AI Studio runs, it synchronizes each mailbox every 16 minutes: it fetches new mails, notes which ones you moved, flagged, or read, and removes the ones you deleted from its index.
- The newest mails first. AI Studio works through a mailbox in steps of at most 500 mails or 5 minutes, so that your other data sources get their turn in between. The first synchronization of a large mailbox can take hours. Meanwhile, the AI already finds the newest mails.
- Your mails stay as they are. AI Studio reads them without marking them as read, and it changes nothing on the server. The only exception is a folder that you create yourself in the settings of the mailbox.
- Each mail is embedded only once. When you move a mail to another folder, AI Studio merely notes where it lies now.
- After sleep and without a network. After your computer wakes up, AI Studio synchronizes within a minute. When it can't reach the server, for example, because your VPN is off, it tries again after 1, 2, 4, and 8 minutes, and then with the regular rounds.
The switch "Automatic local data source refresh" in the settings of the data sources applies to mailboxes, too. When it's off, AI Studio synchronizes a mailbox only when you ask for it: with "Refresh" in the table of data sources, or with "Refresh this data source" on the "Data sources" page.
The "Data sources" page in the navigation bar shows each mailbox with its progress, for example, "1,234 of 5,678 mails are indexed.", and "Last complete sync:" with the time. As long as the first synchronization isn't finished, it says so instead. A list names the mails that couldn't be indexed, by their subject; AI Studio tries them again during the next synchronization.
Some situations need you, and the page shows the buttons for them.
When the server rejects the password, AI Studio stops signing in to this mailbox, even after a restart. Otherwise, a password that you changed elsewhere could lock your account after a few attempts. The page shows when the sign-in failed, and two buttons:
- "Change the password": opens the settings of the mailbox. Enter your current password and save it.
- "Try to sign in again": tries exactly once, for example, after your IT department unlocked your account.
When the server can't be reached at all, AI Studio doesn't stop: that's no failed sign-in.
When a synchronization would remove at least 100 mails and at least a fifth of the index of a mailbox at once, it waits for you. This happens, for example, after you chose a shorter period or another folder, or when a folder was renamed on the server. On the server, the mails stay as they are. Should they come back later, they have to be embedded anew, which takes time and, with an embedding provider in the cloud, money.
- "Remove them from the index": agrees to remove exactly the number shown. If the number changed meanwhile, AI Studio asks again after the next synchronization.
- "Change the settings of the mailbox": for example, to choose the larger period again.
Meanwhile, new mails still come in.
- The server no longer lists the folder to which the mailbox is limited: perhaps it was renamed or deleted. AI Studio removes nothing from the index. Rename the folder back on the server, or add the mailbox anew.
- Your organization allows mailboxes only on its own mail servers, and the server of this mailbox is none of them: AI Studio doesn't connect to it, and the AI doesn't read this mailbox.
- The password couldn't be read from the operating system: enter it again in the settings of the mailbox.
Of a mail encrypted with S/MIME or PGP, or protected with the rights management of Microsoft, AI Studio indexes only the header: the sender, the recipients, the subject, and the date. The AI can find such a mail but can't read it, and it tells you so instead of guessing what it says. Signed mails usually stay readable.
Mailboxes come to the chat as a tool, not as a data source: they don't appear under "Select the data you want to use here.", and neither classic RAG nor "Semantic Search" searches them.
- In the chat, click "Select tools" in the toolbar.
- Choose "Mailboxes".
You need a model that can use tools; see Tools in the Chat. "Mailboxes" holds three tools that the AI uses as needed:
- "Search Mails" searches your mailboxes by meaning and by words. It also lists mails by sender, recipient, date, folder, or by whether they're unread, flagged, encrypted, important, or have attachments.
- "Read Mail" reads a mail that the AI found, and on request its attachments and its full header.
- "Count Mails" counts mails, for example, the unread ones or those in a project folder. It also tells the AI how many mails the server holds.
The AI also learns how far back the index of each mailbox reaches and when it was last synchronized. So it can tell you when an older mail may be missing.
Like any tool, "Mailboxes" can be switched off in "Settings" → "Tool Settings", and you can set its "Minimum provider confidence" there. To start every new chat with it, choose it in the "Chat Options" under "Default tools for chat".
Your sent mails and your drafts are part of the index, too; see Folder. Ask, for example, "When did I last write to the travel office?" or "Which drafts haven't I sent yet?".
A draft is often only minutes old. When the AI looks for drafts and the last complete synchronization was more than a minute ago, AI Studio starts a synchronization and tells the AI that new drafts may still be missing. If a draft you just saved isn't found, ask again shortly. This needs "Automatic local data source refresh".
The AI can improve a draft in the chat, but it can't save it. Copy the improved text into your mail program.
The AI searches a mailbox only when both the provider of the chat and the embedding provider meet the "Required provider confidence level" of the mailbox. Otherwise, AI Studio doesn't offer the mailbox to the AI at all, and without any such mailbox, the AI gets no mail tools in this chat.
Once the AI has read from a mailbox, the chat is restricted according to the setting of this mailbox, by default to "Only services configured in AI Studio". After several mailboxes, the strictest setting counts. A restricted chat doesn't offer the tools it may no longer use, and the tool selection explains why. A new chat without mails can use them again. See Where a chat may send data.
The mails that the AI found or read are listed below its answer, as "Mail:" with the subject, the sender, and the date. They are text without a link.
Mails may contain hidden instructions meant to make the AI do something you didn't ask for. AI Studio takes the text of a mail from the part you see, without hidden elements. It removes such instructions when it indexes a mail, and again before the AI receives the results of the mail tools, and tells you. See Attachments.
- Mails per search: "How many mails do you want at most per search?", 10 by default. A search returns at most this many mails, page by page, and the AI can ask for the next page. Requires AI Studio v26.11.1 or newer. Older versions could return up to twice as many, because the search by meaning and the search by words each brought their own mails.
- Text per call: "Search Mails" returns up to 100,000 characters per call. "Read Mail" returns a mail or an attachment in pages of 30,000 characters, and the header up to 20,000 characters. "Count Mails" shows the 20 largest groups.
- Per answer: the limits for all tools apply, up to 15 tool calls and 300,000 characters; see Tools in the Chat.
- The index of your mails lies on your computer, in the data folder of AI Studio.
- The embedding provider receives the text of your mails and attachments when AI Studio indexes them, and your search queries. The provider of the chat receives what the AI finds and reads. Choose the confidence level of the mailbox accordingly.
- AI Studio keeps the password in the credential store of your operating system.
- The log of AI Studio names your mailboxes, but neither the subjects of your mails nor addresses.
- A backup contains the index of your mails, but not the password; see Backup and Restore.
- Tools in the Chat: the other tools, and what a chat may still do after reading mails.
- Data Sources: let the AI search your own documents, too.
- Provider Confidence: keep confidential mails away from some providers.
Describes MindWork AI Studio v26.11.1 · Found a mistake? Open an issue
User guide
Basics
Chat
- Using the Chat
- Workspaces and Chat Search
- Attachments
- Tools in the Chat
- Data Sources
- Mailboxes (prototype)
- Voice Input
Assistants
- Overview
- General
- Business
- Learning
- Software Engineering
- AI Studio Development
More
Enterprise IT
Deployment
Configuring
Topics
- Providers and API Keys
- Confidence and Data Security
- Assistants and Templates
- Tools and Web Access
- Labeling and Usage Statistics
- Managing Backups
Scenarios and help
Developers
Deutsch