Testing, activating and removing a provider

These actions are available on each provider's row under Settings, Administration, Model providers. They need the admin ability.

Test a provider#

Select Test on an active provider. The product asks the provider for its model list, which confirms the address is reachable and the key is accepted. It sends no model request, so a test never costs you money.

For Amazon Bedrock the test lists the models and inference profiles in the chosen region, so the credentials need bedrock:ListFoundationModels and bedrock:ListInferenceProfiles (see Use AWS Bedrock). A failure names the cause: no AWS credentials found, access denied, expired credentials, or the region unreachable.

For Azure OpenAI the test checks that the endpoint is reachable and the key is accepted, and the models are the deployments you entered. For Google Vertex AI the test confirms Google accepts the service account key, and the models are the Gemini, Claude and embedding models the product knows for Vertex AI. Neither sends a model request.

• On success the row shows "N models found", and the model chips refresh.
• On failure it shows the provider's error.

Test appears only on active providers. Run it after you add or replace a key, or when a Coworker reports it cannot reach its model.

Activate or deactivate a provider#

Each provider row has an active/inactive toggle switch. Turn it on to activate the provider; turn it off to deactivate it. A confirmation dialog appears before the change takes effect, so you can review what will happen before confirming.

A provider that has no stored key, no base URL, and is not an Amazon Bedrock provider using the server's IAM role cannot be activated with the switch alone. Select Edit, enter a key in the API key field and select Save changes, which also activates it. For Amazon Bedrock, use Edit to enter credentials.

Remove a provider#

1. Select Remove.
2. In the dialog "Remove name?", read "Its key is deleted immediately. Coworkers bound to this provider will block the removal."
3. Select Remove provider.

The removal is refused, with a message, when any of these is true:

• Coworkers are bound to the provider. The message lists up to five of them. Rebind those Coworkers to another provider first.
• The provider backs the company default model, default small model or default embeddings model. You cannot remove the default provider; clear or change the default under Default models first.
• A Knowledge Base was created with the provider's embedding model.

If the provider backs the default image generation model, removing it clears that default instead (see Default models).

Removal is permanent. To keep the provider but stop using it, turn off its Active switch instead (see Provider keys).