Step | Agno

Parameter	Type	Default	Description
`name`	`Optional[str]`	`None`	Name of the step for identification
`agent`	`Optional[Agent]`	`None`	Agent to execute for this step
`team`	`Optional[Team]`	`None`	Team to execute for this step
`executor`	`Optional[StepExecutor]`	`None`	Custom function to execute for this step
`workflow`	`Optional[Workflow]`	`None`	Nested workflow to execute for this step
`step_id`	`Optional[str]`	`None`	Unique identifier for the step (auto-generated if not provided)
`description`	`Optional[str]`	`None`	Description of the step's purpose
`max_retries`	`int`	`3`	Maximum number of retry attempts on failure
`skip_on_failure`	`bool`	`False`	Whether to skip this step if it fails after all retries
`strict_input_validation`	`bool`	`False`	If True, fail on missing step inputs. If False, only log a warning
`add_workflow_history`	`Optional[bool]`	`None`	If True, add the workflow history to the step. `None` inherits the workflow-level `add_workflow_history_to_steps` setting
`num_history_runs`	`int`	`3`	Number of previous runs to include when workflow history is added to the step
`human_review`	`Optional[HumanReview]`	`None`	All HITL settings in a single config. See HumanReview Config.

When the step's agent or team calls a tool decorated with @tool(requires_confirmation=True), requires_user_input=True, or external_execution=True, the workflow pauses with pause_kind="executor". See Executor HITL.

HumanReview configuration

Pass these settings inside human_review=HumanReview(...). They are not direct constructor arguments. See HumanReview for the complete configuration and supported combinations.

Parameter	Type	Default	Description
`requires_confirmation`	`bool`	`False`	Pause for user confirmation before execution
`confirmation_message`	`Optional[str]`	`None`	Message shown to user when requesting confirmation
`requires_user_input`	`bool`	`False`	Pause to collect user input before execution
`user_input_message`	`Optional[str]`	`None`	Message shown to user when requesting input
`user_input_schema`	`Optional[List[Union[Dict, UserInputField]]]`	`None`	Schema defining expected input fields, as dicts or `UserInputField` objects
`requires_output_review`	`Union[bool, Callable[[StepOutput], bool]]`	`False`	Pause after execution to review the step's output. See Output Review.
`output_review_message`	`Optional[str]`	`None`	Message shown to user during output review
`max_retries`	`int`	`3`	Max re-executions when an output review is rejected with `OnReject.retry`
`timeout`	`Optional[int]`	`None`	Seconds before the HITL pause auto-resolves. See Timeout.
`on_timeout`	`Union[OnTimeout, str]`	`OnTimeout.cancel`	Action when the HITL timeout expires: `cancel`, `skip`, `approve`
`on_reject`	`Union[OnReject, str]`	`OnReject.skip`	Action when rejected: `skip`, `cancel`, `retry`
`on_error`	`Union[OnError, str]`	`OnError.skip`	Action on error: `fail`, `skip`, `pause`

Constructor example (install agno first):

from agno.workflow.step import Step
from agno.workflow.types import HumanReview, StepInput, StepOutput

def prepare(step_input: StepInput) -> StepOutput:
    return StepOutput(content=step_input.input)

step = Step(name="prepare", executor=prepare, human_review=HumanReview(requires_confirmation=True))

Step.max_retries controls execution retries; HumanReview.max_retries controls review-triggered re-executions. They are separate settings.

HumanReview configuration

On this page