Files for uploads
Add the files your app takes, such as a CSV to import or an image to attach, so Re:agent can upload them in the chat.
Some flows need a file, such as a spreadsheet of customers to import or a photo for a profile. Re:agent uploads only files that belong to the project, so you add them once under Files for tests, and every chat in the project can use them by name.
The Files for tests page describes its files as ones a test uploads while it runs, but tests cannot upload files yet. Today only Re:agent uses them, while it walks a flow in the chat, and a flow with an upload is saved but does not become a test, as Files and tests explains.
Add a file Link to Add a file
Step 1: Open Files for tests
Open Settings. In the project's group, which reads Project · Parcel, choose Files for tests. Seeing the page needs the Use Re:agent and View projects permissions.
Step 2: Drop or choose the file
Drop the file on Drop a file here, or press Choose a file and pick it on your computer. You can add several at once, and they go up one after another. Adding a file needs the Manage projects permission.
A file can be up to 25 MB, in one of these kinds:
| Kind | Formats |
|---|---|
| Images | JPEG, PNG, GIF and WebP |
| Documents | PDF, Word .docx and plain text |
| Data | CSV, JSON and Excel .xlsx or .xls |
| Archives | Zip |
| Audio | WebM, Ogg and MP4 |
| Video | MP4, QuickTime and WebM |
Each file in the list shows its size and the day it was added or last replaced, and its download button opens it.
A file you attach to a message in the chat stays with that message and is not a project file. When a question from Re:agent mentions a file, an upload or an attachment, someone with Manage projects sees Add a file in it, which opens Files for tests.
Use a file in the chat Link to Use a file in the chat
Name the file in your message, so Re:agent knows which one to use:
Sign in as member, import customers.csv on the Import page and check that 20 customers appear in the list.Re:agent checks the project's files, and its row reads Checked the files. It attaches the file through the page's file field or the file chooser it opens, and the row reads Attached customers.csv. A widget that only takes a file dragged onto it cannot be used, because Re:agent does not drag files.
Files and tests Link to Files and tests
Re:agent can walk and save a flow with an upload, but Rehearsal does not write a test from it yet. The block in the reply says "This flow uploads a file. Tests cannot upload files yet." The flow stays saved with the file it used.
An exploration's subagents do not upload files, so project files make no difference to an exploration.
Replace or remove a file Link to Replace or remove a file
The upload button on a file's row replaces the file with a new version under the same name. A saved flow keeps the version it was saved with, so a new version changes only the flows saved after it.
The remove button takes a file off the list once you confirm. Flows already saved with it keep the version they used.
Files your app sends Link to Files your app sends
Some flows end with a file to download, such as an export or an invoice. After a browser downloads one, Re:agent can read it if it is text, or look at it if it is a PNG, JPEG or WebP image. It cannot read the words inside an image. It can also compare the download with a project file, byte for byte or pixel for pixel, which checks that what one person sent is what another received.
That check happens in the chat only. A flow with a download does not become a test yet, and its block says "This flow downloads a file. Tests cannot check downloads yet."