> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-service-account.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. Equivalent to passing the flat fields below. See [HumanReview Config](/workflows/hitl/human-review). |
| `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[UserInputField]]`            | `None`             | Schema defining expected input fields                                                                                                      |
| `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                                                                                                 |
| `hitl_max_retries`        | `int`                                       | `3`                | Max re-executions when an output review is rejected with `OnReject.retry`                                                                  |
| `hitl_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: `approve`, `reject`, `cancel`                                                                        |
| `on_reject`               | `OnReject`                                  | `OnReject.skip`    | Action when rejected: `skip`, `cancel`, `retry`                                                                                            |
| `on_error`                | `OnError`                                   | `OnError.skip`     | Action on error: `fail`, `skip`, `pause`                                                                                                   |

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