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

# Change Stage

> Change the stage and configuration set used for a contact during a conversation.

# Change Stage

`CHANGE_STAGE` updates the contact stage that defines its `configurations_set`. Subsequent responses use the new stage.

## Tool payload

`stage` is required. It must be part of the schema `enum` and match a set configured in the project.

```json theme={null}
{
  "stage": "vendas"
}
```

## Configuration

`config_key` identifies the function made available to the agent. Example names include `promoteAgent`, `transfer`, and `route`.

```json theme={null}
{
  "function_type": "CHANGE_STAGE",
  "output": "You can now discuss this service. Continue answering the customer's questions."
}
```

## Result

For a call such as:

```text theme={null}
promoteAgent({"stage":"sales"})
```

GIA updates the stage and returns the text configured in `output` to the AI.