# Step (/reference/workflows/step)



| 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](/workflows/hitl/human-review).                             |

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](/workflows/hitl/executor).

## HumanReview configuration [#humanreview-configuration]

Pass these settings inside `human_review=HumanReview(...)`. They are not direct constructor arguments. See [HumanReview](/workflows/hitl/human-review) 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](/workflows/hitl/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](/workflows/hitl/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):

```python
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.