[BUG] Agent Workflows documentation

[matthiasa4]

Checks

• I have updated to the lastest minor and patch version of Strands
• I have checked the documentation and this is not expected behavior
• I have searched ./issues and there are no duplicates of my issue

Strands Version

v1.10.0

Python Version

3.10

Operating System

macOS 26.0

Installation Method

pip

Steps to Reproduce

The Agent Workflows documentation is currently confusing to me:

1. It seems to define partly that you are able to pass the output of one agent into the next one and that way compose multiple agents into a workflow.
2. Later in those documentation, a Workflow Tool gets introduced which seems to describe a dynamic task scheduler system.

Are the two unrelated? Why are they sharing the same page? Coming from ADK (which has Workflow Agents) this page is a bit confusing. Assuming an agent returns text which can be passed into another agent, the start of that page seems a bit irrelevant and the second part seems more interesting (but might benefit from more information).

Expected Behavior

Actual Behavior

Additional Context

No response

Possible Solution

The top part of the page seems more like a pattern on how to do multi-agent (and workflow in that way seems like a subset of what a graph would do?) while the latter seems a separate concept all together which deserves its own page.

Related Issues

No response