Skip to content

Commit 661112d

Browse files
ouiliameclaude
andcommitted
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>
1 parent 2c2debb commit 661112d

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

apps/docs/content/docs/en/files/generating.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Most generated files start as the output of an earlier block. Two patterns are c
1919

2020
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.
2121

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.
2323

2424
<Callout type="info">
2525
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
4848

4949
{/* VISUAL: Files panel UI: generated files listed with name, size, type icon, owner, modified date, folder */}
5050

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 blockRead for the file object, Get Content for its text — or by selecting it in a file picker.
5252

5353
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.
5454

@@ -62,7 +62,7 @@ When a workflow is deployed as an [API](/workflows/deployment/api), a generated
6262

6363
<Cards>
6464
<Card title="Files overview" href="/files" description="The artifact layer of your workspace." />
65-
<Card title="Using files in workflows" href="/files/passing-files" description="Provide files to a workflow and receive files back." />
66-
<Card title="File block" href="/files" description="Read, Get, Write, and Append operations in full." />
65+
<Card title="Using files in workflows" href="/files/using-in-workflows" description="Read a file's contents, pass files between blocks, and write results." />
66+
<Card title="File block reference" href="/integrations/file" description="Read, Get Content, Fetch, Write, and Append in full." />
6767
<Card title="API deployment" href="/workflows/deployment/api" description="Expose a workflow as an API and return file references." />
6868
</Cards>

0 commit comments

Comments
 (0)