Use Workspaces in MaiGPT
Start a MaiGPT conversation from a file workspace so AI can find files, read them in full, and then answer. Learn how workspace guides, automatic filing of conversation attachments, and automatic savi
Once you attach a workspace to MaiGPT, you no longer need to upload files one by one. AI finds the files relevant to your question, reads them in full, and answers with source citations. Attachments you upload in the conversation and files AI generates are also saved automatically to the file library.
Use Case
A sales representative clicks Start a conversation here in the “A1 Launch Proposal” workspace. She first asks, “What files are in this workspace?” to check what AI can access, then asks, “Summarize the differences between the plans in the Q3 quotation.” AI reads the quotation and presents a comparison table. When the customer sends a new requirements document, she drags it directly into the conversation, and the system displays “Filed in ‘A1 Launch Proposal’.” She then asks AI to write a proposal outline as a Word file based on the specifications and the new requirements. The file is saved automatically to her temporary storage, with details identifying the source workspace and conversation.
Start a Conversation from a Workspace
1. Start a Conversation Here
Open the workspace you want to use in the file library, then click Start a conversation here.

2. Confirm the Workspace Is Attached
When MaiGPT opens, a workspace tag (such as “A1 Launch Proposal”) appears below the input box, indicating that the workspace is attached to this conversation. Click × next to the tag to detach it.

Let AI Read Files and Answer
With a workspace attached, you can ask questions using file names or descriptions of their contents:
“What files are in this workspace?”
Lists folders and files so you can check what it can access
“Summarize the differences between the plans in the Q3 quotation”
Finds the quotation, reads it in full, and answers with source citations
“Compare the specifications with the competitor presentation”
Reads multiple files as needed and summarizes the differences

File reading rules:
AI can read up to 5 files at a time. If you need more files, split your questions across several requests.
Files that are still being parsed or failed to parse cannot be read. Wait for parsing to finish before asking.
If the file name is ambiguous, AI asks you to confirm which file you mean.
If the workspace has more than 300 items, AI first sees a folder-level overview, then searches deeper based on your question.
For members with view-only access, AI can still read files but will not modify them.
Workspace Guide
Each workspace has a Workspace guide describing its contents and what each file is for. AI refers to this guide when answering. After opening a workspace, click Workspace guide (the document icon) in the toolbar at the top to open it.

Use Case
A sales representative opens the workspace guide for “A1 Launch Proposal” and sees that the system has already organized a file map based on the quotation and the specifications. She wants AI to add a reminder when answering about pricing, so she clicks Edit and adds “Pricing follows the Q3 quotation; remind the user when its validity period has expired.” She first clicks Save below the input box to confirm the draft, then clicks Save at the bottom right of the window. The screen displays “Workspace guide saved,” and her name and the update time are recorded next to the guide. A few days later, a colleague uploads a competitor comparison presentation. When she opens the guide again, she sees a notice that an update suggestion has been generated. She clicks Apply suggestion to review the new content first, and after confirming it, clicks Save. The guide then returns to automatic maintenance.
View the Guide
The guide content appears at the top of the window, and the information about the last update appears on the right:
Guides updated automatically by the system: Show only Last updated: and the time.
Guides saved by someone with the bottom-right Save button (including saves after applying a suggestion): The name of the person who last saved it is added before the time, for example, “Alex Wang・Last updated: 2026-10-25 10:51:55,” until the next automatic update of the guide by the system.

When the guide has no content yet (for example, the workspace has no files), the message “No workspace guide has been set. Click ‘Regenerate’ to have AI generate a suggestion based on the existing files” appears.
Edit, Save, and Cancel
Changing the guide takes two steps: first edit a draft in the window, then click Save at the bottom right to actually write it.
If you change your mind partway through, click Cancel to close the window. The draft is discarded and the guide keeps its original content.
No automatic overwriting after a manual save: After you save a guide, the system does not rewrite it directly when files change. Instead, it generates an update suggestion, as described in the next section.
Regenerate: Click Regenerate, and the system rewrites a version based on the current files and places it in the draft, displaying “New guide suggestion generated.” Click Save at the bottom right to keep it; if you click Cancel, nothing changes.
Apply an Update Suggestion
When nobody has manually edited the guide, the system automatically rewrites it after files are imported, moved, or deleted, or attachments are filed. Multiple changes made within a short period are combined into one update. An entry labeled Workspace guide automatically updated is added to the version history and can be restored.
When the guide has been saved manually, the system instead generates an update suggestion, and the notice “File changes detected. The system has generated a workspace guide update suggestion (not applied automatically because you edited the guide manually)” appears at the top of the window.

Click Apply suggestion in the notice. The suggested content is placed in the draft for you to review first; it has not been written yet.
If it looks right, click Save at the bottom right. After you apply it, the guide returns to automatic maintenance, and later file changes update it directly. Until the system's next automatic update, your name and save time still appear next to the guide.
To modify the suggestion first, click Edit, adjust it, and then save. This counts as a manual save, and the guide does not return to automatic maintenance.
Permissions
You need edit permission for the space to see Edit, Regenerate, Apply suggestion, and Save.
Members with view-only access can open the workspace guide to read its content, but cannot modify it.
Automatically File Conversation Attachments
When you upload a file in a conversation with a workspace attached, the file is automatically added to that workspace. The message “Filed in ‘Workspace name’” appears in the upper-right corner. If it was filed in the wrong place, click Undo in the notification to undo the filing.

To put the file in another workspace, say so directly in your message, for example, “Put this in the Client Project workspace.” If that workspace cannot be found or you do not have write access, the file stays in the current workspace and the system explains why.
Automatically Save AI Outputs
Documents, images, and videos that AI generates in a conversation are automatically saved to Temporary storage under My files, so you do not need to download and organize them separately.
Output list on the right: Output in the panel on the right lists this conversation’s outputs chronologically. You can preview and download them. Clicking Open in file library takes you to the folder containing the file and opens its details.
File details: Open a generated file in temporary storage to see its Source, labeled Agent output, along with the Source workspace and Output conversation. Click the output conversation to return to the original conversation.


Related Pages
Last updated
Was this helpful?
