# Connect your model provider

Connect a model provider to your workspace in **Settings** > **Model Provider**. Analyses, chat and the Advanced editor run on that provider, and it bills you for the usage. Until a provider is connected, the portal does not start anything that uses AI.

## What is blocked without a provider

While the workspace has no active provider, every page of the portal shows the banner **Connect your AI provider to start.** The buttons that start AI work, such as **New Web Agent**, are disabled, and the wizards for a new Web Agent, a new API and Faustine Chat show **Connect your AI provider first** in place of their first step.

## Before you begin

- Choose a provider and have its credentials at hand. Each provider has its own page with where to get them:

| Provider | What you enter | Guide |
| --- | --- | --- |
| Anthropic | An Anthropic API key | [Connect Anthropic](https://docs.faustine.ai/technologies/anthropic/) |
| Amazon Bedrock | The region, and a Bedrock API key or an IAM keypair | [Connect Amazon Bedrock](https://docs.faustine.ai/technologies/amazon-bedrock/) |
| Azure AI Foundry | The Foundry resource name and its API key | [Connect Azure AI Foundry](https://docs.faustine.ai/technologies/azure-ai-foundry/) |
| LiteLLM | The base URL of your LiteLLM gateway and its API key | [Connect LiteLLM](https://docs.faustine.ai/technologies/litellm/) |
| Vercel AI Gateway | An AI Gateway API key of your Vercel team | [Connect Vercel AI Gateway](https://docs.faustine.ai/technologies/vercel-ai-gateway/) |

- To use knowledge (uploaded documents the agent can search), you also need an embeddings model. LiteLLM and Vercel AI Gateway serve one with the same credentials. The other providers need a separate key: an OpenAI API key, or with Amazon Bedrock and Azure AI Foundry an Azure OpenAI deployment.

## Connect the provider

To connect a provider:

1. In the portal, go to **Settings** > [**Model Provider**](https://auth.faustine.ai/go?to=%2Fsettings%3Ftab%3Dprovider).
2. Select **Configure a provider**.
3. In **Provider**, select your provider. The list shows the providers that are enabled for your workspace. If the step shows **Set by your Faustine admin**, the provider is already chosen.
4. In **Credentials**, enter the values from the table above and select **Continue**. Faustine stores secrets encrypted and does not show them again.
5. For Amazon Bedrock, Azure AI Foundry and LiteLLM, the next step is **Model names on your provider**. Enter what each model is called on your provider, or keep the suggested ID where the field shows one. Select **Test connection** to make one call to each model. For Vercel AI Gateway the step is **Models on your provider** and you can leave it empty.
6. In **Embeddings**, select where embeddings run and enter its key. If you select **Not configured**, documents cannot be uploaded and the agent cannot search them.
7. In **Review & save**, select **Test connection**, then **Save & activate**.

The tab now shows your provider with an **Active** badge, and the banner is gone. Analyses, chat and the Advanced editor run on the provider from this moment.

## Change the provider or its credentials

The same tab shows the connected provider with its credentials, models and embeddings. **Re-validate** tests the stored credentials against the provider. To move to another provider, see [Switch model provider](https://docs.faustine.ai/workspace/switch-provider/). To change only the embeddings, see [Choose an embeddings provider](https://docs.faustine.ai/workspace/embeddings/).

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| The banner says **Your AI provider credentials were rejected.** | The provider stopped accepting the stored key or token. Analyses, chat and the Advanced editor are paused. | Select **Fix credentials** and enter a new key. |
| A new Web Agent, a new API or the Faustine Chat setup shows **Connect your AI provider first** | No provider is active for the workspace. | Select **Set up AI provider** and follow the steps on this page. |
| Documents cannot be uploaded to an agent's knowledge | **Embeddings** is set to **Not configured**. | [Choose an embeddings provider](https://docs.faustine.ai/workspace/embeddings/). |

## Next steps

- [Quickstart: add an agent to your web app](https://docs.faustine.ai/get-started/quickstart-web-agent/): create a Web Agent now that the analysis can run.
- [Model providers](https://docs.faustine.ai/workspace/model-providers/): what each provider covers and how Faustine uses it.
- [Usage](https://docs.faustine.ai/workspace/usage/): the tokens each feature used on your provider.