For the complete documentation index, see llms.txt. This page is also available as Markdown.

Managing Settings

Configure global AI settings in the Umbraco backoffice.

AI Settings provide a central place to configure system-wide defaults, including which profiles are used when no specific profile is specified.

Accessing Settings

  1. Navigate to the AI section in the main navigation.

  2. Click Settings in the tree.

The AI Settings page with Default Chat, Classifier, and Embedding profile pickers

Available Settings

Default Chat Profile

The profile used for chat operations when no profile is explicitly specified.

Field
Description

Default Chat Profile

Select from available chat profiles

When set, this profile is used by:

  • IAIChatService.GetChatResponseAsync() without a profile ID

  • Prompts without an associated profile

  • Agents without an associated profile

Classifier Chat Profile

An optional profile for internal classification tasks such as agent routing. The classifier profile lets you use a cheaper or faster model for basic classification decisions, reducing costs.

Field
Description

Classifier Chat Profile

Select from available chat profiles

When set, this profile is used by:

  • Agent routing in "Auto" mode, in both Contextual Copilot and Copilot Workspace (selecting the best agent for a user prompt)

If not set, the default chat profile is used instead.

When the experimental Decision capability is enabled and a Default Decision Profile is set, Auto mode tries Decision first. The classifier chat profile is then used only as a fallback.

Default Embedding Profile

The profile used for embedding operations when no profile is explicitly specified.

Field
Description

Default Embedding Profile

Select from available embedding profiles

When set, this profile is used by:

  • IAIEmbeddingService.GenerateEmbeddingsAsync() without a profile ID

Default Speech-to-Text Profile

The profile used for speech-to-text operations when no profile is explicitly specified.

Field
Description

Default Speech-to-Text Profile

Select from available speech-to-text profiles

When set, this profile is used by:

  • IAISpeechToTextService.TranscribeAsync() without a profile ID

  • The voice input button in Contextual Copilot and Copilot Workspace

Default Image Generation Profile

The profile used for image generation when no profile is explicitly specified.

Field
Description

Default Image Generation Profile

Select from available Image Generation profiles

When set, this profile is used by:

  • IAIImageGenerationService.GenerateImagesAsync() without a profile

  • The Image Generation Management API and UaiImageGenerationController without a profileIdOrAlias

Default Decision Profile

The profile used for decisions when no profile is explicitly specified.

Field
Description

Default Decision Profile

Select from available Decision profiles

When set, this profile is used by:

  • IAIDecisionService.AskAsync() without a profile

  • The Decision Management API and UaiDecisionController without a profileIdOrAlias

  • The Ask Yes/No, Ask Pick-One, Ask Score, and Ask Questions Umbraco Automate actions without a profile

  • Agent routing in "Auto" mode, which tries Decision before the classifier chat profile. See Decision-Based Routing

Default Extraction Profile

The profile used for extraction when no profile is explicitly specified.

Field
Description

Default Extraction Profile

Select from available Extraction profiles

When set, this profile is used by:

  • IAIExtractionService calls without a profile

  • The Extraction Management API and UaiExtractionController without a profileIdOrAlias

  • The Extract Values Umbraco Automate action without a profile

AI Disclosure Notice

Controls the notice that tells users a response is AI-generated. The notice reads "Responses are AI-generated and may be inaccurate." and appears in:

  • The chat in Contextual Copilot and Copilot Workspace, after the first message in a conversation.

  • The prompt preview, once a prompt response has loaded.

Option
Behavior

Always

The notice is always shown. This is the default.

Dismissible

The notice shows a Dismiss button. Once dismissed, it stays hidden in that browser.

Off

The notice is never shown.

With Dismissible, each location is dismissed separately. Hiding the notice in the chat does not hide it in the prompt preview. The dismissal is stored in a cookie in the user's browser for one year, so it applies per browser rather than per user account.

The setting is found in the Transparency group on the Settings page.

Configuring Settings

  1. Navigate to the AI section > Settings.

  2. Select the desired profiles via the pickers, and choose an AI Disclosure Notice option.

  3. Click Save.

Settings Precedence

Settings can be specified in multiple places. The order of precedence is:

  1. Explicit parameter - Profile ID passed in code (always takes priority)

  2. Database settings - Configured in the backoffice (this screen)

For advanced scenarios like CI/CD or infrastructure-as-code, defaults can also be configured in appsettings.json. However, database settings take precedence. See Settings Concept for details.

When Defaults Are Used

Scenario
Default Used

_chatService.GetChatResponseAsync(chat => chat.WithAlias("my-feature"), messages)

Yes

_chatService.GetChatResponseAsync(chat => chat.WithAlias("my-feature").WithProfile(profileId), messages)

No (explicit)

Prompt without ProfileId

Yes

Prompt with ProfileId

No (explicit)

Agent without ProfileId

Yes

Agent with ProfileId

No (explicit)

Clearing Defaults

To remove a default:

  1. Open the picker.

  2. Select the empty option.

  3. Save.

When no default is configured:

  • Operations without an explicit profile will fail with an error.

Last updated

Was this helpful?