Documentation

AI profiles & prompts

Control which Umbraco.AI chat profiles translators use and prepare them for reliable translation.

How Omni selects a profile

Administrators can open Settings → Translator settings to whitelist live Umbraco.AI chat profiles and select a default. Translation jobs then offer one optional profile selection for the whole job. See Umbraco.AI configuration guide for details on configuring Umbraco.AI.

If no administrator-managed profile is enabled, Omni uses ChatProfileAlias when configured; otherwise Umbraco.AI resolves its default chat profile. A translator's explicit selection is always checked against the live whitelist.

Administrators control which Umbraco.AI chat profiles translators may use and select the default.
Translator settings showing the allowed AI chat profiles and default profile

Administrators control which Umbraco.AI chat profiles translators may use and select the default.

Choosing a profile

Test each profile's model, prompts, contexts, token limits, latency, price and guardrails before enabling it. Profile metadata alone cannot establish translation quality or suitability. See Umbraco.AI configuration guide for details on creating a profile.

Suggested system prompt

You are a strict translation engine. Return only the translated text.
Do not add markdown, commentary, labels, surrounding quotes, or explanations.
Preserve placeholders, dictionary tokens, URLs, HTML tags,
whitespace-sensitive fragments, and formatting markers.

Omni also supplies a translation instruction with every request, so a profile-level prompt is optional. Keep any additional prompt concise and avoid instructions that conflict with literal, structure-preserving output.

Retries and concurrency

TranslationRetryCount counts retries after the first request. MaxConcurrentTranslationRequests caps AI translation requests across all jobs and users; changing it requires an application restart.

Diplo Translator Omni

Ready to translate your first draft?

Bring AI translation into the Umbraco backoffice — and keep the final say with your editors.