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

# Change agent settings step

> Change the voice, system prompt or call timing partway through a call with a Change agent settings step, and see which settings apply on a live call.

A Change agent settings step changes how the agent sounds and behaves from a point in the flow onward: a different voice, a different system prompt, or different call timing. The new settings last for the rest of the call. The step speaks nothing and moves straight on.

## When to use it

* To switch to a voice for another language or dialect once you know what the caller speaks.
* To give the agent a different system prompt for one part of the call, such as a stricter one for payments.
* To give the caller more time to answer, for example while they look for a card number.

## Add a Change agent settings step

**1. Add the step**

On the canvas, click **Add node** and choose **Change agent settings** ("Override agent settings mid-flow"). The panel title reads **Change settings**: "Override agent settings from this point in the flow."

**2. Change what you need**

Open **System prompt**, **Voice settings** or **Call settings** and change the fields you want. Each field starts at the value the call would have at this point; any field you change becomes an override.

![A Change settings step panel with its System prompt, Voice settings, Call settings and Local variables sections, Call settings showing 1 override](https://mintcdn.com/hamsa-452fa79a/Rl78D_qJIpinmg19/images/agents/flow/steps/change-settings-step-light.webp?fit=max\&auto=format\&n=Rl78D_qJIpinmg19\&q=85\&s=a542bb33142866ab05f38883b36c0286)

**3. Connect Auto-advance**

Connect the step's **Auto-advance** transition to the next step.

Each section shows how many overrides it has. To drop a section's overrides, click its reset icon (**Reset overrides**). Fields you don't change keep the agent's settings, or the ones an earlier Change agent settings step set.

![The Call settings section of a Change settings step with User inactivity timeout raised to 30 s and the reset icon at the top](https://mintcdn.com/hamsa-452fa79a/Rl78D_qJIpinmg19/images/agents/flow/steps/change-settings-call-settings-light.webp?fit=max\&auto=format\&n=Rl78D_qJIpinmg19\&q=85\&s=e7f03e17cb64452f4085d10131bc068c)

## Settings you can change

### System prompt

| Field | What it does |
| - | - |
| **System prompt** | Replaces the agent's system prompt for the rest of the call. Variables and [Jinja](https://docs.tryhamsa.com/agents/variables/jinja.md) are filled in when the call reaches the step. Leaving it empty keeps the current prompt. |

### Voice settings

| Field | What it does |
| - | - |
| Voice (**Select voice**, or **Change**) | Opens **Select agent voice**. The new voice also sets the language it speaks. See [Choose a voice](https://docs.tryhamsa.com/agents/voices/choose-a-voice.md). |

The section also has **Expressiveness** and **Voice dictionaries**. Both take effect from this step for the rest of the call, like the voice. See [Pronunciation dictionaries](https://docs.tryhamsa.com/agents/voices/dictionaries.md).

### Call settings

| Field | What it does | Range |
| - | - | - |
| **Response delay** | The minimum time the agent waits after the caller stops talking before it answers. | 100 to 1500 ms, in steps of 100 |
| **User inactivity timeout** | Seconds of silence before the agent checks in with the caller. | 5 to 60 s |
| **Minimum interruption duration** | How long the caller must speak before it counts as an interruption. | 0.2 to 1.5 s, in steps of 0.1 |
| **VAD activation threshold** | The sensitivity threshold for detecting that the caller is speaking. | 0.2 to 0.9, in steps of 0.1 |

These work as in [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md). Interruption isn't set here: use the **Interruption** setting on each [Conversation step](https://docs.tryhamsa.com/agents/flow/steps/conversation.md).

### Local variables

**Local variables** sets variables when the call reaches the step, as in a [Set local variables step](https://docs.tryhamsa.com/agents/flow/steps/set-variables.md).

## Transitions

| Transition | Taken when |
| - | - |
| **Auto-advance** | Always, as soon as the settings are applied. |

**Auto-advance** is created with the step and can't be removed.

You can also add **Skip if** to this step: when its conditions already hold as the call arrives, the call goes straight to its target and the step doesn't run. See [Skip if](https://docs.tryhamsa.com/agents/flow/transitions.md#skip-if).

## How it works on a call

1. The step's local variables are set.
2. The overrides are applied to the live call: the new voice, system prompt and call settings take effect from the agent's next reply.
3. The call moves on through **Auto-advance**. Nothing is spoken.

Overrides stay in place for the rest of the call, whichever path the call takes afterward. To go back, add another Change agent settings step with the original values.

## Good to know

* The step has a **Global** section, without **Confirm before proceeding**.

## Related

> [card] [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md)
>
> What each call setting does for the whole agent.

> [card] [Voice, language and dialect](https://docs.tryhamsa.com/agents/settings/voice-and-language.md)
>
> The agent's voice and language settings.

> [card] [Conversation step](https://docs.tryhamsa.com/agents/flow/steps/conversation.md)
>
> Turn interruption on or off per step.

> [card] [Step types](https://docs.tryhamsa.com/agents/flow/steps/overview.md)
>
> Every step type at a glance.


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