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
Navigate to the AI section in the main navigation.
Click Settings in the tree.

Available Settings
Default Chat Profile
The profile used for chat operations when no profile is explicitly specified.
Default Chat Profile
Select from available chat profiles
When set, this profile is used by:
IAIChatService.GetChatResponseAsync()without a profile IDPrompts 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.
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.
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.
Default Speech-to-Text Profile
Select from available speech-to-text profiles
When set, this profile is used by:
IAISpeechToTextService.TranscribeAsync()without a profile IDThe 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.
Default Image Generation Profile
Select from available Image Generation profiles
When set, this profile is used by:
IAIImageGenerationService.GenerateImagesAsync()without a profileThe Image Generation Management API and
UaiImageGenerationControllerwithout aprofileIdOrAlias
Default Decision Profile
The profile used for decisions when no profile is explicitly specified.
Default Decision Profile
Select from available Decision profiles
When set, this profile is used by:
IAIDecisionService.AskAsync()without a profileThe Decision Management API and
UaiDecisionControllerwithout aprofileIdOrAliasThe 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.
Default Extraction Profile
Select from available Extraction profiles
When set, this profile is used by:
IAIExtractionServicecalls without a profileThe Extraction Management API and
UaiExtractionControllerwithout aprofileIdOrAliasThe 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.
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
Navigate to the AI section > Settings.
Select the desired profiles via the pickers, and choose an AI Disclosure Notice option.
Click Save.
Settings Precedence
Settings can be specified in multiple places. The order of precedence is:
Explicit parameter - Profile ID passed in code (always takes priority)
Database settings - Configured in the backoffice (this screen)
When Defaults Are 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:
Open the picker.
Select the empty option.
Save.
When no default is configured:
Operations without an explicit profile will fail with an error.
Related
Settings Concept - Understanding settings
Profiles - Profile configuration
Last updated
Was this helpful?