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
Amazon Bedrock	The region, and a Bedrock API key or an IAM keypair	Connect Amazon Bedrock
Azure AI Foundry	The Foundry resource name and its API key	Connect Azure AI Foundry
LiteLLM	The base URL of your LiteLLM gateway and its API key	Connect LiteLLM
Vercel AI Gateway	An AI Gateway API key of your Vercel team	Connect 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:

In the portal, go to Settings > Model Provider.
Select Configure a provider.
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.
In Credentials, enter the values from the table above and select Continue. Faustine stores secrets encrypted and does not show them again.
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.
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.
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. To change only the embeddings, see Choose an embeddings provider.

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.

Next steps

Quickstart: add an agent to your web app: create a Web Agent now that the analysis can run.
Model providers: what each provider covers and how Faustine uses it.
Usage: the tokens each feature used on your provider.