Every AI feature in Trace.Space runs on a model from an AI provider. The AI Providers page is where an org admin decides which providers and models the organization may use, adds providers with the organization's own API keys, and picks the default model.
Opening the page
Click the settings gear in the top bar, choose Organization settings, then AI Providers in the left sidebar. Only org admins see this entry.
The page has two parts. Built-in providers that come with your Trace.Space deployment are listed first. Below the Custom providers line are the providers your organization has added itself.
Enabling and disabling models
Each provider has a switch at the top that turns the whole provider on or off. Expand a provider to see its models. Each model has its own switch, so you can offer your team a short list instead of everything the provider sells. The provider header summarizes this as all models enabled or, for example, 3 models enabled.
Enabled models are what users see in the model selector of the AI chat.
Setting the default model
Hover an enabled model and click Set as default. The model gets a Default tag and the provider header shows Default model. The default model is used everywhere a user does not pick a model themselves: new chats, attribute generation, quality fixes, type changes, and the AI reviewer in reviews.
The default model cannot be switched off. Set another model as default first.
If no default is set, or the default model's provider is disabled, a warning banner at the top of the page reads "AI features are unavailable. Make sure you have at least one provider and one model enabled and set as default." Users see no AI button until this is fixed.
Adding your own provider
Click New AI Provider and fill in:
Field | What to enter |
Name | How the provider appears to your team. Must be unique. |
Provider | One of OpenAI, GroqCloud, Bedrock, Anthropic, Google Vertex, Mistral, xAI, or OpenAI Compatible. |
API Key | The key from your account with that provider. |
Hosting URL (optional) | The address of a self-hosted or custom deployment. Leave blank to use the provider's public API. |
Click Test and Save configuration. Trace.Space connects to the provider with the key before saving. If the key is wrong you see "Unable to authenticate with the provided API key"; if the URL cannot be reached you see "Failed to communicate with AI provider."
Once saved, the provider's models are listed and you can enable them and set a default like any other provider. The key is stored encrypted and is never shown again.
Editing and removing a custom provider
Hover a custom provider to show the edit and delete buttons. When editing, the API Key field shows a placeholder; leave it as it is to keep the current key, or paste a new one to replace it. Deleting asks you to confirm Delete AI Provider? and removes the provider permanently. Built-in providers cannot be edited or deleted.
Who can use AI
The AI chat button appears for every member as soon as a default model is set. Users pick a model per chat from the enabled list; see Working with AI. For what each role can do with AI, see Roles and permissions reference.