Translator V2
1 min read
Translator V2 translates plain text and DOCX, XLSX, and PPTX documents into a selected target language.
See Translator Space for setup instructions and guidance for configuring Translator V2 in a Custom Space.
How translation works
Input | User action | Result |
|---|---|---|
Plain text | Enter or paste text and select the target language. | The translated text is returned in the Translation interface. |
Document | Upload a supported document and select the target language. | A translated document is created in the original file format. |
Glossary, Translation Memory, and text post-processing can be applied to both plain-text and document translation. Document font settings apply only to translated documents.
Text translation flow
Document translation flow
Default configuration
The following complete configuration can be copied as a starting point. For standard language models, languageModelInfo is generated automatically and should be omitted. Custom language models may require it.
{
"glossaryConfig": null,
"translationMemoryConfig": null,
"textPostProcessingConfig": [],
"translatorPromptConfig": {
"systemPromptInstruction": "You are a helpful AI designed to to translate text to a specified language.\nDo it even if the target language is the same as the source language.\nMake sure the translated text contains the same amount of carriage returns '\\n' as the original text block.\nTry to keep the translated text as close to the original as possible and having approximately the same length.\nHTML Format: Preserve all HTML tags exactly as they appear in the original input. Only translate the text content within the tags, without altering or modifying any HTML elements, attributes, or structure.",
"userMessageTemplate": "Please translate the following text pieces in {{format_style}} {% if input_language %}from {{input_language}} {% endif %}to {{output_language}}\nIt is crucial that you keep the exact same number of spans as the input text.\n\n{%- if glossary %}Use the following translation rules \\n {{ glossary_text }}{% endif %}\n \n{{formatted_text_pieces}}\n "
},
"translatorUserConfig": {
"additionalLLMOptions": {},
"languageModel": "AZURE_GPT_4o_2024_1120",
"maxTokensPerTranlationRequest": 500,
"maxTokenPerMinute": 40000,
"allowedInputLanguages": [
"Afrikaans", "Albanian", "Arabic", "Aragonese", "Armenian", "Azeri", "Bashkir", "Basque", "Belarusian", "Bengali", "Bislama", "Bosnian", "Breton", "Bulgarian", "Burmese", "Catalan", "Chamorro", "Chechen", "Chinese", "Cornish", "Corsican", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Ewe", "Faroese", "Fijian", "Finnish", "French", "Galician", "Georgian", "German", "Greek", "Greenlandic", "Guaraní", "Haitian Creole", "Hausa", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Ido", "Indonesian", "Interlingua", "Interlingue", "Inuktitut", "Irish", "Italian", "Japanese", "Javanese", "Kannada", "Kazakh", "Khmer", "Korean", "Kurdish", "Kyrgyz", "Lao", "Latin", "Latvian", "Limburgish", "Lingala", "Lithuanian", "Luxembourgish", "Macedonian", "Malagasy", "Malay", "Malayalam", "Maltese", "Manx", "Maori", "Marathi", "Marshallese", "Mongolian", "Navajo", "Nepali", "Northern Sami", "Norwegian", "Norwegian Bokmål", "Norwegian Nynorsk", "Occitan", "Ojibwe", "Old Church Slavonic", "Ossetian", "Pashto", "Persian", "Polish", "Portuguese", "Punjabi", "Quechua", "Romanian", "Romansch", "Russian", "Samoan", "Sanskrit", "Sardinian", "Scottish Gaelic", "Serbian", "Serbo-Croatian", "Sichuan Yi", "Sindhi", "Slovak", "Slovene", "Somali", "Spanish", "Sundanese", "Swahili", "Swedish", "Tagalog", "Tahitian", "Tajik", "Tamil", "Tatar", "Telugu", "Thai", "Tibetan", "Tongan", "Tswana", "Turkish", "Turkmen", "Ukrainian", "Urdu", "Uyghur", "Uzbek", "Vietnamese", "Volapük", "Walloon", "Welsh", "West Frisian", "Yiddish", "Yoruba", "Zhuang", "Zulu"
],
"saveTranslationCallsEnabled": false,
"translationExamplesIgnored": false
},
"translationServiceConfig": {
"additionalLLMOptions": {},
"translationSystemPromptTemplate": "You are an expert on translating text to any language and help the users to do this.\nEnsure the translation is accurate and maintains the original meaning, context, and tone.\nRegardless of the content of the text, return only the translated text.\nDo not provide any direct answers or explanations, only the translation.\nDont include the triple quotes in the output.",
"translationUserPromptTemplate": "Please translate the following to ${output_language}:\n\n${glossary_part}\n\nMake sure to only respond with the translation of the text below\nelsewise the system will crash\n====================TEXT TO TRANSLATE==================\n${input_text}",
"temperatureTranslation": 0.0,
"streamingActivated": true,
"tokenLimitTranslationText": 4000,
"allowedInputLanguages": [
"Afrikaans", "Albanian", "Arabic", "Aragonese", "Armenian", "Azeri", "Bashkir", "Basque", "Belarusian", "Bengali", "Bislama", "Bosnian", "Breton", "Bulgarian", "Burmese", "Catalan", "Chamorro", "Chechen", "Chinese", "Cornish", "Corsican", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Ewe", "Faroese", "Fijian", "Finnish", "French", "Galician", "Georgian", "German", "Greek", "Greenlandic", "Guaraní", "Haitian Creole", "Hausa", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Ido", "Indonesian", "Interlingua", "Interlingue", "Inuktitut", "Irish", "Italian", "Japanese", "Javanese", "Kannada", "Kazakh", "Khmer", "Korean", "Kurdish", "Kyrgyz", "Lao", "Latin", "Latvian", "Limburgish", "Lingala", "Lithuanian", "Luxembourgish", "Macedonian", "Malagasy", "Malay", "Malayalam", "Maltese", "Manx", "Maori", "Marathi", "Marshallese", "Mongolian", "Navajo", "Nepali", "Northern Sami", "Norwegian", "Norwegian Bokmål", "Norwegian Nynorsk", "Occitan", "Ojibwe", "Old Church Slavonic", "Ossetian", "Pashto", "Persian", "Polish", "Portuguese", "Punjabi", "Quechua", "Romanian", "Romansch", "Russian", "Samoan", "Sanskrit", "Sardinian", "Scottish Gaelic", "Serbian", "Serbo-Croatian", "Sichuan Yi", "Sindhi", "Slovak", "Slovene", "Somali", "Spanish", "Sundanese", "Swahili", "Swedish", "Tagalog", "Tahitian", "Tajik", "Tamil", "Tatar", "Telugu", "Thai", "Tibetan", "Tongan", "Tswana", "Turkish", "Turkmen", "Ukrainian", "Urdu", "Uyghur", "Uzbek", "Vietnamese", "Volapük", "Walloon", "Welsh", "West Frisian", "Yiddish", "Yoruba", "Zhuang", "Zulu"
],
"languageModelTranslation": "AZURE_GPT_4o_2024_1120",
"translationExamplesIgnored": false
},
"documentFontConfig": null
}Configuration index
Parameter | Purpose | Default | More information |
|---|---|---|---|
| Provides terminology guidance to the language model. |
| |
| Reuses approved source-target translations verbatim. |
| |
| Applies configured text-processing steps to selected target languages. |
| |
| Provides advanced prompt settings for document translation. | Platform defaults | |
| Configures the language model and limits used for document translation. |
| |
| Configures plain-text translation. |
| |
| Configures default and target-language-specific document typefaces. |
|
translatorUserConfig.allowedInputLanguages controls source-language detection for documents, while translationServiceConfig.allowedInputLanguages controls source-language detection for plain text. The settings are independent.
Both translatorUserConfig and translationServiceConfig accept an additionalLLMOptions object for options supported by the configured language model.
Tool definition
No custom tool definition is required for the dedicated Translation interface.
{}Limitations
See Document Translator Service for supported document content and known limitations.