Skip to content

Commit f72da34

Browse files
ouiliameclaude
andcommitted
docs(blocks): give the Agent intro the weight it deserves
The opening was too flat for the central block. New lead: 'The Agent block is where a workflow thinks' — model, reasoning, tools, structured output, and the contrast with data-moving blocks. The agent-vs-Agent-block disambiguation moves from an info callout into a second paragraph framed as the block's role in building agents (the unit you build agents from). Dropped the now-unused Callout import. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 6769487 commit f72da34

1 file changed

Lines changed: 3 additions & 6 deletions

File tree

apps/docs/content/docs/en/blocks/agent.mdx

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,14 @@ description: The Agent block runs a model over your inputs to reason, call tools
44
pageType: reference
55
---
66

7-
import { Callout } from 'fumadocs-ui/components/callout'
87
import { BlockPreview, WorkflowPreview, CLASSIFY_WORKFLOW } from '@/components/workflow-preview'
98
import { FAQ } from '@/components/ui/faq'
109

11-
The **Agent block** runs a model as one step of a workflow. It reads the values you give it, optionally calls tools and reads files, and returns a result, either plain text or structured JSON, that later blocks read by reference.
10+
The **Agent block** is where a workflow thinks. It runs a model with the instructions, context, and tools you give it: the model reads the input, reasons about it, decides which tools to call, and returns plain text or structured JSON for the rest of the workflow to build on. Other blocks move and shape data; the Agent block is the step that understands it.
1211

13-
<BlockPreview type="agent" />
12+
It's also the unit you build agents from. An *agent* — the thing you ship — is a whole workflow that reasons and acts on its own; an *Agent block* is one reasoning step inside it. The simplest agent is a single Agent block with tools. Larger ones wire several together, with conditions, loops, and other blocks around them. See [Building agents](/building-agents).
1413

15-
<Callout type="info">
16-
An *agent* and an *Agent block* are not the same thing. An agent is a workflow you build and ship that reasons and acts on its own. An Agent block is one reasoning step inside it. A simple agent is a single Agent block; a larger one wires several together with other blocks. See [Building agents](/building-agents).
17-
</Callout>
14+
<BlockPreview type="agent" />
1815

1916
## Configuration
2017

0 commit comments

Comments
 (0)