For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Start a conversation here button at the top of a workspace
Start a conversation here appears above the workspace list

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.

Attached workspace tag displayed below the MaiGPT input box
The workspace tag below the input box
  • You can attach one workspace to a conversation at a time.

  • You can also click Start a conversation in the file details, or select multiple files and click Start a conversation, to bring only the selected files into the conversation.


Let AI Read Files and Answer

With a workspace attached, you can ask questions using file names or descriptions of their contents:

Try asking
What AI does

“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

AI presents a plan comparison table after reading the Q3 quotation, with workspace attachments displayed above the input box
AI shows which files it has read; files it has read appear as attachments labeled “From workspace”

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.

Toolbar at the top of a workspace, with the pointer over the document icon showing the Workspace guide tooltip
The Workspace guide is in the toolbar to the right of Start a conversation here

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.

Workspace guide window showing a system-organized file map and retrieval strategy, with only the last updated time at the top right and the Save button at the bottom right disabled
An automatically updated guide shows only the update time; Save is unavailable until you make changes

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.

1

Edit the Draft

Click Edit, and the content becomes an editable text box. When you finish, click Save below the text box. This only updates the draft in the window and does not write it to the workspace yet. While you are editing, Save at the bottom right is disabled; finish editing first.

2

Confirm and Save

Save at the bottom right is available only when the draft differs from the current content. After you click it, “Workspace guide saved” appears and the window closes.

Workspace guide window showing a draft with an added answering-principles section, with the Save button at the bottom right enabled
After the draft is edited, Save at the bottom right becomes available

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.

Workspace guide window with a yellow notice at the top about detected file changes and an Apply suggestion button, with the name of the last person to save (masked) and the last updated time on the right
When files change in a manually saved guide, an update suggestion is shown instead
  1. 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.

  2. 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.

  3. 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.

If the system updates the suggestion again based on new file changes while you are reviewing it, clicking Save displays “The suggestion has been updated. Please review the latest content before saving,” and the window loads the latest content. Review it again before applying.

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.

After an attachment is uploaded in the conversation, a notification shows it was filed in A1 Launch Proposal and provides an Undo button
The filing notification remains until you act on it

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.

The Output list in the right panel of MaiGPT shows a Word file generated by AI
The Output list in the right panel
File details in temporary storage show Agent output as the source, along with the source workspace and output conversation
Generated file details identify the source workspace and output conversation

You can move outputs you want to keep long term from temporary storage to a permanent workspace.


Last updated

Was this helpful?