How Artifacts Work
When an agent generates a file in its sandbox (using code execution, data processing, or any tool that produces a file), it exports the file using a built-in export tool. This:- Saves the file to secure cloud storage
- Creates a versioned artifact record
- Generates preview thumbnails and representations
- Displays the file as a rich card in the chat
Viewing Artifacts
In-Chat Preview
When an agent exports a file, it appears as a card in the chat message showing the filename, file type icon, and a thumbnail preview (for supported types). Click the card to open a side panel preview without leaving the chat.Dedicated Viewer Page
Each artifact has its own shareable page at a unique URL. The viewer page shows:- Full-width file preview
- Filename, file type, and size
- Who created it and which agent generated it
- Links to view the source chat and agent (if you have access)
Files Sidebar
All files from a conversation are listed in the Files section of the chat sidebar. Click any file to preview it, open it in a new tab, copy its link, or download it.Supported Preview Types
Gumloop can render inline previews for many file types:| File Type | Preview |
|---|---|
| HTML (.html) | Interactive sandboxed preview |
| Images (.png, .jpg, .gif, .webp, .svg) | Native image viewer |
| PDF (.pdf) | PDF viewer |
| Spreadsheets (.csv, .xlsx, .xls) | Spreadsheet viewer |
| Presentations (.pptx, .ppt) | Slide viewer or PDF preview |
| Text & Code (.txt, .md, .py, .js, .json, etc.) | Syntax-highlighted text viewer |
| All other files | Download prompt with file size |
Files larger than 50 MB cannot be previewed inline and are shown as download-only.
Actions
From the viewer page or the in-chat card, you can perform several actions on an artifact:
| Action | Description |
|---|---|
| Download | Download the original file to your device |
| Share | Open the share dialog to manage who can access the file |
| Copy link | Copy a shareable URL to your clipboard |
| Open in new tab | Open the dedicated viewer page |
| Version history | View all versions of the file |
| Full screen | Available for HTML artifacts only |
Automatic Versioning
When an agent exports a file with the same filename multiple times in the same conversation, Gumloop automatically creates new versions instead of overwriting. This gives you a full history of how a file evolved during the conversation.
- Version number (v1, v2, v3, etc.)
- Timestamp of when it was created
- File size
Sharing & Access Control
Artifacts use Gumloop’s share permissions system. You can control who can view, download, and manage each file.Share Dialog
Click Share from the options menu to open the share dialog:
- Add specific users by email
- Set General Access to control broader visibility
General Access Levels
| Level | Who Can Access |
|---|---|
| Restricted | Only you and explicitly shared users |
| Organization | All members of your organization |
| Anyone | Anyone with the link, including people without a Gumloop account |
Default File Sharing
Each agent has a Default File Sharing setting that controls how new artifacts are shared when created. You can configure this in Agent Settings > Chat Preferences > Default File Sharing:| Setting | What Happens |
|---|---|
| Default | Team agents share with the team. Personal agents keep files restricted (only you). |
| Organization | Files are shared with your entire organization |
| Anyone | Files are publicly accessible via link |
The default sharing setting applies to new artifacts only. You can always change the sharing level of any individual artifact after it’s created.
Requesting Access
If someone shares a file link with you but you don’t have access:- Not signed in: You’ll see a prompt to create a Gumloop account
- Signed in, no access: You’ll see a Request Access button that sends an email to the file’s owner or a workspace admin
HTML Artifacts
HTML files get special treatment. Agents can generate fully interactive HTML pages, dashboards, and web applications that render directly in the viewer.Security
HTML artifacts run in a strict security sandbox. This is important because agents can generate arbitrary HTML and JavaScript. The sandbox:- Blocks access to your Gumloop session, cookies, and storage
- Blocks direct network requests (fetch, XHR, WebSocket)
- Prevents opening new windows or popups
- Automatically strips sensitive headers from any proxied requests
Full Screen Mode
HTML artifacts support a full screen mode that hides the toolbar and gives the artifact the full browser window. This is useful for dashboards, interactive tools, and presentations. Click the full screen button in the viewer toolbar to enter full screen.Mobile Behavior
On mobile devices, artifacts work slightly differently:- Clicking a file card opens the dedicated viewer page in a new tab (instead of a side panel)
- Auto-preview of new files is disabled to avoid disrupting the chat experience
Common Questions
Where are my files stored?
Where are my files stored?
Artifacts are stored securely in Google Cloud Storage. Files are accessible through the Gumloop viewer or via download. They persist as long as the conversation exists.
Is there a file size limit?
Is there a file size limit?
There is no hard limit on file size for creation. However, files larger than 50 MB cannot be previewed inline and will show a download prompt instead.
Can I delete an artifact?
Can I delete an artifact?
Artifact deletion is managed by the file owner. If you’re the owner (the person who ran the agent conversation that created the file), you have full control.
What happens if the agent generates the same file multiple times?
What happens if the agent generates the same file multiple times?
If the agent exports a file with the same filename in the same conversation, it automatically creates a new version. You can browse all versions from the version history panel. No data is lost.
Can I share a file with someone outside my organization?
Can I share a file with someone outside my organization?
Why can't I see the 'View chat' or 'View agent' link on a shared file?
Why can't I see the 'View chat' or 'View agent' link on a shared file?
Can I change the default sharing for all files my agent creates?
Can I change the default sharing for all files my agent creates?
Yes. Go to your agent’s Settings > Chat Preferences > Default File Sharing and choose between Default, Organization, or Anyone. This applies to all new files the agent creates going forward.
Related Documentation
Agents
Learn how to create and configure agents
Share Permissions
Understand roles, access levels, and sharing
Working With Files
Upload and manage files in workflows