Documents
What this is for. Documents is the file library: PDFs, images, archives, and other blobs you (or a conversation / knowledge page) attach. They are stored locally (optional S3 sync) and available for retrieval. This is not the Knowledge wiki and not a Memory vault note — it is the file itself.
When to use it
Section titled “When to use it”- You have a PDF, image, or archive the agent should be able to open later.
- A headless
browser_downloadjust ingested a file from the web — it shows up here, linked to the conversation. See Browser Use. - You want to see every file in one place, filtered by type, in grid or list view.
- You need to download or delete a file, or see where it is used.
- You are configuring local storage vs S3-compatible remote sync.
Typical workflow
Section titled “Typical workflow”- Open Documents in the sidebar (Content section) — route
/documents. - Files arrive from conversation Attach file, knowledge Attachments, or an upload zone (Drop files here / or click to browse).
- Filter All / Images / PDFs / Archives / Other, search by filename, switch grid/list.
- Open Settings → Documents (
/documents-settings) if you need stats or S3 credentials. You should see the file in the library and in search; the agent can retrieve it when the conversation has it attached or indexed.
Features
Section titled “Features”Empty: No documents yet. Hint: Files are attached from conversations and knowledge articles. Filtered empty: No files match your filter.
Library
Section titled “Library”| Control | Meaning |
|---|---|
| Grid view / List view | Layout |
| Search files… | Filename filter |
| All · Images · PDFs · Archives · Other | MIME categories |
| Used in N location(s) / Unlinked | Where the file is attached |
| Sync badge | Synced · Sync pending · Sync error · Remote storage not configured |
| Download | Save locally |
| Delete | Click again to confirm |
Settings (/documents-settings)
Section titled “Settings (/documents-settings)”Subtitle: Storage configuration and statistics.
| Area | Meaning |
|---|---|
| Storage Statistics | Total files, local, synced, pending, errors |
| Top File Types | MIME breakdown |
| Local Storage | Files on the instance filesystem. Storage Directory is relative to the EYAS data root (read-only here — change in config) |
| S3 Remote Storage | Optional S3-compatible sync: endpoint, bucket, region, access key, secret key. Save credentials |
Do not confuse this with Search Sources (code/doc trees on disk) or Memory (durable notes).