You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(files): generating.mdx accuracy — operation names and cards
Same V5-operation slip as using-in-workflows had (fixed in #4896): there is no
'Get' operation — Read returns workspace file objects (not 'parsed files'),
Get Content returns text. Cards fixed: 'Using files in workflows' pointed at
passing-files, 'File block' pointed at the /files overview with the wrong
operation set — now /integrations/file with the real five. Verified accurate
while auditing: ElevenLabs audioFile output, write-time content-type detection
(manage/route.ts:351), Files panel categories, dedup suffix behavior.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: apps/docs/content/docs/en/files/generating.mdx
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Most generated files start as the output of an earlier block. Two patterns are c
19
19
20
20
A block returns **text content** you want to keep. An [Agent](/workflows/blocks/agent) writes an analysis or summary; a [Function](/workflows/blocks/function) builds a CSV or formats a report. That text is part of the block's output, read by reference as `<agent.content>` or `<function.result>`. To make it a file, you pass that value into a File block set to Write.
21
21
22
-
A block returns a **file object** directly. ElevenLabs text-to-speech returns an `audioFile`; an image generator returns a generated image; the File block's own Read operation returns parsed files. These are already [UserFile](/files/passing-files) objects (an object with `id`, `name`, `url`, `size`, and `type`), so they appear in the output panel as files with no Write step. You can hand one to a downstream block, or write its content to the Files store to persist it.
22
+
A block returns a **file object** directly. ElevenLabs text-to-speech returns an `audioFile`; an image generator returns a generated image; the File block's own Read operation returns workspace file objects. These are already [UserFile](/files/passing-files) objects (an object with `id`, `name`, `url`, `size`, and `type`), so they appear in the output panel as files with no Write step. You can hand one to a downstream block, or write its content to the Files store to persist it.
23
23
24
24
<Callouttype="info">
25
25
A block's output is remembered under the block's name for the rest of the run, and a later block reads it by key, like `<elevenlabs.audioFile>` or `<agent.content>`. Producing content and saving it are two separate steps: the producing block holds the value, the File block persists it.
@@ -48,7 +48,7 @@ A saved file lands in the workspace [Files](/files) store, the same place upload
48
48
49
49
{/* VISUAL: Files panel UI: generated files listed with name, size, type icon, owner, modified date, folder */}
50
50
51
-
Files are scoped to the workspace, not to one workflow. A file written by one workflow is visible to every other workflow in the same workspace. Any later run can read it back with the File block's Read or Get operation, or by selecting it in a file picker.
51
+
Files are scoped to the workspace, not to one workflow. A file written by one workflow is visible to every other workflow in the same workspace. Any later run can read it back with the File block — Read for the file object, Get Content for its text — or by selecting it in a file picker.
52
52
53
53
During a run, the file also appears in the output panel as the File block's output, shown as a structured object with its `id`, `name`, `url`, and `size`. The output panel shows you one run as it happens, while the Files store is where the file stays afterward.
54
54
@@ -62,7 +62,7 @@ When a workflow is deployed as an [API](/workflows/deployment/api), a generated
62
62
63
63
<Cards>
64
64
<Cardtitle="Files overview"href="/files"description="The artifact layer of your workspace." />
65
-
<Cardtitle="Using files in workflows"href="/files/passing-files"description="Provide files to a workflow and receive files back." />
66
-
<Cardtitle="File block"href="/files"description="Read, Get, Write, and Append operations in full." />
65
+
<Cardtitle="Using files in workflows"href="/files/using-in-workflows"description="Read a file's contents, pass files between blocks, and write results." />
66
+
<Cardtitle="File block reference"href="/integrations/file"description="Read, Get Content, Fetch, Write, and Append in full." />
67
67
<Cardtitle="API deployment"href="/workflows/deployment/api"description="Expose a workflow as an API and return file references." />
0 commit comments