Skip to content

Settings

The Settings page lets you configure the core AI providers that power TeamWeb AI. There are two provider types that need to be configured:

LLM Provider

The LLM (Large Language Model) provider powers your assistants’ conversations, content generation, and reasoning. This is the AI model that processes messages and generates responses.

Embedding Provider

The embedding provider converts text into vector representations for semantic search. This is used by the knowledge base to find relevant information when an assistant searches for context.

Configuring a Provider

Navigate to Settings

Go to Settings in the sidebar (admin access required).

Select a Provider

The settings page shows the currently active providers for both LLM and embedding. Click on an available provider to configure it.

Enter Configuration

Each provider has its own configuration form with fields like:

  • API Key — Your provider’s API key
  • Model — Which model to use
  • Other settings — Provider-specific options

Secret fields like API keys are masked after saving.

Activate

Save the configuration to activate the provider. Only one provider of each type (LLM, embedding) can be active at a time.

Deactivating a Provider

You can deactivate a provider to fall back to environment variable configuration. This is useful if you prefer to manage API keys through your deployment environment rather than the web interface.

Environment Variable Fallback

If no provider is configured through the settings UI, TeamWeb AI falls back to configuration from environment variables. This is the typical setup for initial installation before running the setup wizard.

Provider configuration through the UI takes precedence over environment variables. Deactivate the UI configuration to revert to environment variables.