Files
A task can carry files: an invoice you want checked, the export a connector hands back, the report the agent builds for you. Whatever their source, a task’s files are kept together — listed in the task’s side panel, opened in the same viewer, downloadable, shareable by link, and copied onto the agent’s computer so it can work on them.
An agent can also be given knowledge files — price lists, procedures, contracts — that it searches in every task. Those belong to the agent rather than to one task; see Knowledge files.
Where a task’s files come from
Section titled “Where a task’s files come from”| Source | How it arrives | Largest file | Kept for |
|---|---|---|---|
| You attach it | From the composer, when you send a message | 50 MB | 2 days — 8 hours for a file over 10 MB |
| A connector returns it | A file in the connector’s answer, or an answer too large to hand the agent whole — a site call’s long answer included | 50 MB | 1 hour |
| The agent makes it | Saved as output from its work on its computer | 50 MB | 10 days |
Each workspace can hold up to 10 GB of files that have not yet expired. Past that, a new file is refused with this workspace has used its file storage allowance until older ones expire.
Attaching files
Section titled “Attaching files”Attach files to any message — on New task or in a task that is already under way — with Attach a file, or by dropping them on the page (Drop files to attach).
- Up to 50 files per message, 50 MB each. Any type of file can be attached. A file over 10 MB is kept for only 8 hours after upload, and the composer says so before you send it.
- Pictures can be marked up before you send them. Open the picture and choose Annotate: draw freehand, lines, rectangles and ellipses, or add text, in red, blue, green or gray. Save annotated image replaces the picture with a marked-up PNG copy. A file cannot be annotated once it has been sent.
- The agent sees attached pictures at once. A PNG, JPEG, GIF or WebP picture of up to 5 MB goes to the agent inside your message — up to three per message — so it can answer “what does this screenshot say?” without opening anything.
- Every file is also placed on the agent’s computer, in the task’s files
folder,
/tmp/<task id>/files/, and the agent is told its name. Two files with the same name in one task are kept apart: the secondinvoices.csvbecomesinvoices-2.csv.
A file sent partway through a task is marked Sent mid-task in the side panel.
Files a connector returns
Section titled “Files a connector returns”Some connectors answer with a file — an export as a spreadsheet or CSV, say. The file is kept with the task and the agent is given its path, its type and size, and a preview of its contents. A large export may arrive as several parts.
If a file in an answer cannot be kept, the rest of the answer still reaches the agent, with a note saying which file was not kept and why.
An answer too large to hand the agent whole — roughly 20 KB or more — is kept
the same way, as a .json file (or .csv or .txt when the answer is plain
text), and the agent gets a preview and the path instead. It then reads what
it needs from the file on its computer, rather than carrying the whole answer
through the conversation. A long answer from a
site call is kept the same way, and
follows every rule below.
A connector’s data is never cut in the middle. What you can rely on:
- A result is kept whole or not at all. A large result is never trimmed to its first part. If it could not be saved as a file, the agent gets none of its rows — only a note that it could not be saved — and is told to ask for less (a filter, a smaller page, a shorter date range) or to say the data could not be read. It does not fill the gap in.
- A list is also a file. An answer with ten or more rows is saved as a data file as well, so the agent can compute over every row with code. It reads the rows from that file; it does not retype figures into a script or add them up in its head. The file notes when the data was fetched, because it goes out of date.
- A file that was taken off the computer comes back. Files a connector returned may be removed from the agent’s computer a few minutes after they arrive; when the agent’s code needs one again, it is put back. A file past its retention is not: the agent is told when it was fetched and asks the connector again.
- Slow downloads are waited for. When the agent downloads a file from a
website — an export, a PDF — it waits for the download to finish (up to 30
seconds) and keeps the result in the task’s
downloadsfolder, rather than working from a half-written file or from what the page shows.
If part of a result still did not reach the agent, the transcript says so and the agent is stopped from sending anything built on it; see When a connector’s data comes back incomplete.
Files the agent makes
Section titled “Files the agent makes”An agent can work on files with code, on its computer: read a spreadsheet, total a column, pull the text out of a PDF, compare two lists, draw a chart, produce a report. It shows in the transcript as Working with the files on the computer.
Anything the agent saves as output is kept for you — shown in the conversation under the agent’s reply, and in the side panel. Common documents keep their real type, so a PDF, Word, Excel, PowerPoint or CSV file opens as one; a picture it draws, the agent can look at too. It can also keep any other file from the task’s files folder on purpose, shown as Keeping a file for you. Each kept file can be up to 50 MB.
The agent can also share one of the task’s files by link when you ask it to.
The guardrail Can analyse files in the agent’s configuration controls this, and it is on for a new agent. Off, the agent cannot work on files with code at all.
Whether it asks first is an approval level. At Ask for everything, the first time in a task the agent asks: The agent wants to read and analyse the files on this task’s computer. If you approve, it can do this for the rest of this task without asking again. From Files without asking up, it does not ask.
Working on files needs the agent’s computer, so a task with no agent cannot do it.
On its computer the agent can also put a task file into a website’s upload field — shown as Uploading a file — for example to attach an invoice to a form in one of your systems.
Where files are kept
Section titled “Where files are kept”A task’s file has two copies.
- The stored copy is kept in AptiveAI’s file storage for the time in the table above — 2 days for a file you attached (8 hours for one over 10 MB), an hour for one a connector or a site call returned, 10 days for one the agent made. This is the copy you view, download and share. Each file in Documents says when it goes — File expires in 9 d, File expires in 5 h — and so does the share dialog. After it expires, the file stays listed but reads Download expired, and it can no longer be opened.
- The copy on the computer is what the agent works on. Files are copied there when the task has a computer. A task never starts a computer just to hold a file: until it has one, its files wait, and they are copied when it gets one — again if it moves to a new computer. This copy lasts only as long as the computer does.
Download your results before they expire if you need to keep them.
Seeing a task’s files
Section titled “Seeing a task’s files”-
In the transcript. Files you attached appear under your message; files the agent made appear under its reply. Click one to open it. A web page the agent made can also show right in the conversation, as a card under its reply.
-
In the side panel. The Documents tab lists Files — every file in the task, whatever its source. Each shows a preview or a type icon, its name, Click to view or Click to download with File expires in …, its size, when it arrived and when its download expires. Clicking the row opens the file; the eye button previews it beside the transcript. Its ⋯ menu has Download, Share link… and, while the file has a live link, Copy share link and Turn off share link — then the file’s earlier versions and Delete, where they apply. A file with a live link carries a Shared · 71 h chip: the hours its link has left.
Files are grouped as Uploaded, Generated and Agent’s artifacts — what connectors and site calls fetched, which is removed from the agent’s computer a few minutes after it arrives and whose downloads expire after an hour.
-
On the agent’s Files page. Every file of an agent’s tasks you can see, across tasks — see The agent’s dashboard and files.
The viewer
Section titled “The viewer”Clicking a file opens it in the viewer. ◀ and ▶ (or the arrow keys) move between the files of the same message or list, Esc closes it, and a download button is always there. In a task, the viewer’s header also has Share link… (Sharing a file by link) and Present (Presenting a file).
| File | Shown as |
|---|---|
| Pictures — PNG, JPEG, GIF, WebP, BMP | The picture, with Zoom in, Zoom out and Reset zoom |
| Your browser’s own PDF reader — pages, zoom, search and print. Open in a new tab reads it full size, which is the better choice on a phone | |
Spreadsheets — Excel (.xlsx, .xlsm, .xls), OpenDocument (.ods), CSV and TSV | A table with lettered columns and numbered rows, one tab per sheet. Up to 5,000 rows, 200 columns and 50 sheets are shown |
Word (.docx) | The document |
PowerPoint (.pptx) | The slides — Preview — layout may differ from PowerPoint. |
| Markdown | Formatted text |
Text and data — .txt, .log, JSON, XML, YAML | A read-only text view, with highlighting for JSON, XML and YAML. The first 500,000 characters are shown |
Web pages — .html | The page, in a sandbox: its own scripts run, but it cannot reach the internet, your account or anything else in the task, and it cannot download files |
| Anything else | Its name and size, with Download |
When part of a file is not shown, the viewer says so; the download is always the whole file.
Presenting a file
Section titled “Presenting a file”Present in the viewer’s header shows the file full screen, for a meeting or a screen share.
- A PowerPoint file becomes a slideshow, one slide at a time on a dark screen. The arrow keys or Space move between slides (Arrow keys or Space to move, Esc to exit), and Exit or Esc ends it.
- Any other file fills the screen in the same viewer: scroll it, zoom it or use it as you would in the viewer. Esc ends it.
The shared page has the same Present button on a computer, with Exit presentation to leave.
Sharing a file by link
Section titled “Sharing a file by link”You can share one file of a task with someone who has no AptiveAI account — a report for a client, a deck for a meeting — through a private link. The link opens that file and nothing else, for a short time.
Who can share
Section titled “Who can share”Anyone who can work in the task can share its files: make a link, copy it again and turn it off. Someone who can only view the task — read-only — cannot. Any file of the task can be shared, whether you attached it, a connector returned it or the agent made it.
Making a link
Section titled “Making a link”Share from any of these:
- the file’s ⋯ menu in the task’s Documents tab → Share link…;
- Share link… in the viewer’s header, while the file is open;
- the share button on a web page the agent shows in the conversation;
- the file’s ⋯ on the agent’s Files page or dashboard.
The dialog, Share “‹file name›”, says Only this file is shared. Nothing else from the task. Choose how long the link works — 24 hours, 48 hours or 72 hours (the default) — read Before you share, and select Create link:
Anyone who has this link, including people it gets forwarded to, can view and download this file until it expires. Files made by agents can include names, numbers and other details from the work they came from. Check the file first, and don’t share anything you wouldn’t send by email.
The note is shown every time a link is made. The dialog then shows the link with Copy link, when it expires, Make a new link and Turn off link.
Immersive view, a switch in the same dialog, is for a dashboard or a report that should look like a page of its own. It is set per link, and you can change it at any time: the link stays the same. See What someone with the link sees.
- One live link per file. Making a new link turns the old one off, so it is also how you replace a link that went to the wrong person.
- A shared file shows it. In Documents and on the agent’s Files page, the file carries a Shared · N h chip, and its ⋯ adds Copy share link and Turn off share link.
- If the dialog says This link is on, but its address can’t be shown again, select Make a new link to get one you can copy.
What someone with the link sees
Section titled “What someone with the link sees”The link opens a page without signing in. It shows only that file, in the same viewer as the console. Nothing else reaches it: not the task, its conversation, the agent, your workspace, its other files, or who shared it.
- The bar at the bottom has the file’s name, how long the link has left (Expires in 71 h), Search when the file has text, Download and, on a computer, Present. Whoever has the link can download the file.
- A web page runs in the same sandbox as in the console.
- A small “Powered by AptiveAI Agents” mark sits in the corner and opens aptiveai.io.
- It is not indexed by search engines.
Immersive view
Section titled “Immersive view”With Immersive view on, the page shows only the file, filling the screen, with the AptiveAI mark in the corner and, on a computer, a small round full-screen button. People who open the link do not see its name, when it expires, or the Search, Download and Present buttons.
The link itself still works the same way: it expires, it can be turned off, and anyone who has it can reach the file.
On a phone or tablet
Section titled “On a phone or tablet”On an iPhone, iPad or Android device, there is no Present and no full-screen button, because a page cannot really go full screen there. The rest of the page is the same.
When a link stops
Section titled “When a link stops”A link stops working, and the page then reads This link has expired, when:
- its time is up;
- someone turns it off — Turn off share link in the file’s ⋯, or Turn off link in the dialog;
- a new link is made for the same file;
- the file is deleted, or reaches the end of the time it is kept;
- the task is deleted.
A link never outlasts its file. If the file goes before the link’s 24, 48 or 72 hours are up, the link stops with it, and the dialog says so: The file is kept until ‹date›. A link can’t outlast it. So a connector’s file (kept an hour) or a large upload (kept 8 hours) can be shared only that long. A page someone already has open keeps what it has loaded, but nothing more.
When the agent shares a file
Section titled “When the agent shares a file”You can ask the agent to share one of the task’s files — “share report.pdf with me as a link”. It makes the same link you would, for 24 hours unless you ask for 48 or 72, and the transcript shows Shared a file: report.pdf. The link is yours: it appears on the file in Documents, where you can copy it or turn it off.
With the AptiveAI Messaging connector, the agent can also email the link to someone — “share the report and email the link to our accountant”. Sending the email asks first, like every Messaging send — see When it asks first.
Knowledge files
Section titled “Knowledge files”Knowledge files are uploaded in an agent’s builder, under Configure → Knowledge, and belong to that agent. They do not expire, and they are not copied onto its computer: the agent searches and reads them directly, in every task it works on.
| File types | PDF, PNG and JPEG pictures, text (.txt, .md, .csv), Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) |
| Limits | 25 MB per file, 20 files per agent, up to 50 scanned pages per file |
When a file is added it is read once, and its status moves from Reading the file… to Ready — or Failed, with the reason.
- PDFs are read from their text. A page with no text on it — a scan — is read by text recognition, in English and Spanish, and the status says how many scanned pages were read. A picture is read the same way. Printed text only: handwriting, charts and photos are not read.
- Spreadsheets and CSV files are kept as tables: each row stays a row, with its column names. Excel values keep their formatting — dates as dates, percentages as percentages — and one sheet is one page.
- Word and text files are split into pages of about 3,000 characters; PowerPoint is one page per slide.
In a task, the agent sees each file’s name, page count and description. When it needs a fact, it searches them (Searching its knowledge for …) and reads the pages it needs, up to ten at a time (Reading a knowledge file).
Who can see a task’s files
Section titled “Who can see a task’s files”A file is visible to exactly the people who can see its task — its starter, the people it was shared with, and people who can see the automation that started it. Owners who open a task by its link can read it, view-only. There is no admin override. A file you attached but have not sent yet is visible only to you. Once a task is deleted, nobody can open its files.
The one exception is a share link: anyone who has it can view that one file, without signing in, until the link stops.
An agent’s knowledge files are listed in its builder. Only people who may configure the agent add, describe or remove them, and the agent only ever searches its own. AptiveAI Agents offers no download of a knowledge file, so keep your own copy.