Switch model provider
Switching replaces the workspace's model provider with another one. Analysis, the Advanced editor and chat run on the new provider as soon as you save.
Before you begin
- More than one provider is enabled for your workspace. Switch provider is not shown when a single provider is set for the workspace.
- You have the credentials for the new provider. See the page for that provider under Model providers.
What a switch discards
| Part | What happens on save |
|---|---|
| Credentials of the previous provider | Deleted. To switch back you enter them again. |
| Model mapping | Cleared. IDs on one provider mean nothing on another, so you map the models again. |
| Embeddings | The stored key is not carried over, and the Embeddings step starts on Not configured unless the new provider is LiteLLM or Vercel AI Gateway. Saving it that way turns knowledge off. |
Nothing changes until you save. Cancel at any step leaves the previous provider in place.
Switch provider
To switch:
- In the portal, go to Settings > Model Provider.
- Select Switch provider. The Provider step opens with the previous provider marked current.
- Select the new provider.
- In Credentials, enter the values for the new provider and select Continue.
- If the provider has a Models step, enter the model IDs, select Test connection, and select Continue.
- In Embeddings, select an option and enter its key, then select Continue.
- In Review & save, select Test connection.
- Select Save changes.
The card shows the new provider with an Active badge.
The model mapping is also cleared when you change the Endpoint of Amazon Bedrock between invoke and mantle, because the two endpoints use different model IDs.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| There is no Switch provider button | One provider is enabled for the workspace. | Contact Faustine to enable another provider. |
| The Embeddings row shows Not configured after the switch | The previous embeddings option does not exist on the new provider, or its key was not entered again. | Select Edit in the Embeddings row. See Choose an embeddings provider. |
Next steps
- Choose an embeddings provider: the options for the new provider.
- Choose the chat model: check which model each agent uses on the new provider.
- Usage: see the tokens consumed on each model.
Last updated November 13, 2026