> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Step types in a flow agent

> Every step type you can add to a flow agent: what each one does on a call, which transitions it gets, and which settings every step shares.

A flow agent is made of steps. Each step does one job on a call: it speaks, calls an API, picks a path, sets variables, changes settings, transfers the call or ends it. This page lists every step type, what it does and how it moves on, so you can pick the right one.

The flow builder says "node" on some buttons and panels. The button that adds a step is **Add node**, in the canvas tool rail. See [Work in the flow builder](https://docs.tryhamsa.com/agents/flow/flow-builder.md) for the canvas itself.

## Every step type

| Step | What it does on a call | Transitions | Page |
| - | - | - | - |
| **Start** | Begins every call. Either speaks an opening message and waits for the caller (**Conversation mode**) or calls an API first (**Tool mode**). | Conversation mode: **Prompt**, **When a live variable matches**, **DTMF input**, **After user replies**. Tool mode: **On Success**, **On Failure**. | [Start](https://docs.tryhamsa.com/agents/flow/steps/start.md) |
| **Conversation** | Speaks a message, then talks with the caller until a transition fires. | **Prompt**, **When a live variable matches**, **DTMF input**, **Skip if**, **Auto**, **After user replies** | [Conversation](https://docs.tryhamsa.com/agents/flow/steps/conversation.md) |
| **Tool** | Calls one of your API tools and saves values from the response. | **On Success**, **On Failure**, **Skip if**. An async tool gets a single **Move to**. | [Tool](https://docs.tryhamsa.com/agents/flow/steps/api-request.md) |
| **Web tool** | Runs a web tool in the caller's browser or app and saves values from its reply. | **On Success**, **On Failure**, **Skip if** | [Web tool](https://docs.tryhamsa.com/agents/flow/steps/web-tool.md) |
| **Router** | Checks your variables against conditions and picks a path, without speaking. | **Equation** (one per path), **Skip if**, plus a fixed **Else** | [Router](https://docs.tryhamsa.com/agents/flow/steps/router.md) |
| **Transfer call** | Transfers the caller to a phone number or SIP address, cold or warm. | **On Failure**, **Skip if** | [Transfer call](https://docs.tryhamsa.com/agents/flow/steps/transfer-call.md) |
| **Transfer to agent** | Hands the call to another agent in the same project, on the same call. | **On Failure**, **Skip if** | [Transfer to agent](https://docs.tryhamsa.com/agents/flow/steps/transfer-agent.md) |
| **End call** | Speaks an optional final message and hangs up. | None | [End call](https://docs.tryhamsa.com/agents/flow/steps/end-call.md) |
| **Set local variables** | Sets or clears variables, then moves on. | **Auto-advance**, **Skip if** | [Set local variables](https://docs.tryhamsa.com/agents/flow/steps/set-variables.md) |
| **Change agent settings** | Changes the voice, system prompt or call settings for the rest of the call. | **Auto-advance**, **Skip if** | [Change agent settings](https://docs.tryhamsa.com/agents/flow/steps/change-settings.md) |

Every flow has exactly one **Start** step. It isn't in the **Add node** list, and you can't delete or copy it.

The **Add node** list shows the types in this order, with these descriptions when you hover:

| In the list | Hover description |
| - | - |
| **Conversation** | Interactive dialog with the user |
| **Tool** | Execute pre-configured tools |
| **Web tool** | Execute web-based tools |
| **Transfer call** | Transfer call to another number |
| **Transfer to agent** | Transfer conversation to another agent |
| **Router** | Logic splitting node with conditional routing |
| **Set local variables** | Set local variables for use in subsequent nodes |
| **Change agent settings** | Override agent settings mid-flow |
| **End call** | End the conversation |

Two types have a shorter name in the panel title: **Transfer to agent** shows as **Transfer agent**, and **Change agent settings** shows as **Change settings**. Once you give a step a label, the label becomes the panel title and the type moves underneath it.

![The Add node list open next to the tool rail, with Router highlighted](https://mintcdn.com/hamsa-452fa79a/2xrN5xxbhCUDZ-2o/images/agents/flow/add-node-menu-light.webp?fit=max\&auto=format\&n=2xrN5xxbhCUDZ-2o\&q=85\&s=55d2a85f5b30688691a083533698a88f)

## Choose a step type

* To say something and listen for an answer, use **Conversation**.
* To look something up or save something in your systems, use **Tool**.
* To read or change something on the web page the caller is using, use **Web tool**.
* To branch on a value you already have (an amount, a status, a yes or no), use **Router**. It checks the values directly, without asking the model.
* To store a value, a flag or a counter for later steps, use **Set local variables**.
* To switch the voice, the system prompt or call timing from a point on, use **Change agent settings**.
* To hand the caller to a person, use **Transfer call**. To hand them to another agent, use **Transfer to agent**.
* To finish, use **End call**.

## What every step has

Each step's panel starts with the step's main fields, then has sections you open one at a time.

| Section | What it holds |
| - | - |
| **Transitions** | Where the call goes next. Every type except **End call** has one. See [Transitions](https://docs.tryhamsa.com/agents/flow/transitions.md). |
| **Variables** | Values the step captures or sets. Every step can set **Local variable**s when the call reaches it. Conversation and Start also capture values from the caller; Tool and Web tool read values from the response. See [Variables](https://docs.tryhamsa.com/agents/variables/overview.md). |
| **Global** | Makes the step reachable from anywhere in the flow. See [Global steps](https://docs.tryhamsa.com/agents/flow/global-steps.md). |

![A Conversation step's settings panel: the Message field, then the Transitions, Interruption, Variables and Global sections](https://mintcdn.com/hamsa-452fa79a/Rl78D_qJIpinmg19/images/agents/flow/steps/conversation-step-light.webp?fit=max\&auto=format\&n=Rl78D_qJIpinmg19\&q=85\&s=173b85444d3513faf19cae051dbe06d6)

A step's label can be up to 100 characters.

### Confirm before proceeding

In the **Global** section of a Conversation, Tool, Web tool, Router, Transfer call, Transfer to agent or End call step, **Confirm before proceeding** ("Require confirmation before advancing to this node") makes the agent check with the caller before the step runs.

On a call, the agent repeats back what the caller asked for and waits for a clear yes or no. On yes, the step runs. On no, the call goes back to the last Conversation step. The agent asks again every time the call reaches the step.

## How it works on a call

* **Steps run in a chain.** When a step finishes, the next one starts right away. The chain stops at a step that waits for the caller, or when the call ends.
* **Local variables come first.** When the call reaches any step, that step's local variables are set before it does anything else.
* **Only Conversation and Start can be interrupted.** Their **Interruption** setting decides whether the caller can talk over the agent. Every other step's speech (processing messages, transfer messages, the final message) plays to the end.
* **The caller can keep talking while the flow works.** While the call passes through steps that don't speak, such as a Tool or a Router, the agent doesn't answer. It keeps what the caller says, and the next step that speaks answers it in the same reply. Transfer and End call steps keep those words in the transcript but don't answer them.

## Related

> [card] [Flow agents](https://docs.tryhamsa.com/agents/flow/overview.md)
>
> When a flow fits better than a single prompt, and how a call moves through steps.

> [card] [Transitions](https://docs.tryhamsa.com/agents/flow/transitions.md)
>
> Every transition type and how the next step is chosen.

> [card] [Work in the flow builder](https://docs.tryhamsa.com/agents/flow/flow-builder.md)
>
> Add, connect and find steps on the canvas.

> [card] [Variables](https://docs.tryhamsa.com/agents/variables/overview.md)
>
> The kinds of variables steps can capture, set and read.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.