This article details how you can use the Translate Glossary to add translations for specific terms and to control any terms that should not be changed by the translation.
It also details how you can make changes to the Translate Instructions to change the ChatGPT prompts if you are familiar with ChatGPT prompts code. This allows you to fine-tune the translation of your articles by customizing the ChatGPT prompts to better align the translation with your brand's language and jargon.
You can also add a Translation Notice which adds a disclaimer to the articles translated with AI. This text is translated along with your article and inserted at either the beginning or the end of the translated version. You can use HTML to format the text.
Translate Glossary, Translate Instructions, Translation Notice can be accessed from the Translation Settings in the Bulk Translate function or from the Settings. Refer to Translating Articles with Bulk Translate and Help Center Manager Settings for Syncing, Translation and Auto Translate.
In this Article
Using the Translate Glossary
Setting up the Glossary .csv File
Adding the Glossary
Changing the Translate Instructions to Change the ChatGPT Prompts
Adding a Translation Notice to Include a Disclaimer in the Translation
Using the Translate Glossary
You can add a Glossary that is used in the translate. The Glossary allows you to control the translations for specific terms and phrases to maintain a specific brand voice or ensure that terms are consistent. You can use this to add translations for specific terms and also to control any terms that should not be changed by the translation. For example, use this so that your company or brand name, address details, are not translated, or for any other terms that need a specific translation.
The Glossary is saved and kept for all the future translations. The Glossary is also used when translating articles individually from the Article View.
You maintain the Glossary items in a comma separated (.csv) file which you upload.
If you have uploaded a Glossary in Translate Conversations, this will automatically show as loaded in Help Center Manager.
Changing or clearing the Glossary from one app will impact the Glossary in the other.
If you have added a Translate Prompt in Translate Conversations, this is not used in Help Center Manager and a different prompt is used in the two apps. The Translation Notice in Help Center Manager is not used in Translate Conversations.
Refer to Translate Conversations Configuration - Glossary, Translation Prompt, Known Languages for Team Member and App Settings in the Translate Conversations help.
Setting up the Glossary .csv File
First set up a .csv file. The .csv file has a heading row with each language and a column for "All". Add a row for each term with the translations for each language. Where there is a common translation applicable to all languages, add this under the "All" column to indicate there is no other translation for this term.
The following is an example of an Excel spreadsheet with the entries. The file must be saved as a .csv file.
Adding the Glossary
- Select at least one article on the Articles page and click Translate.
From the Translate, click Translation Settings in the Source section.
Or
From the options at the bottom of the left-hand side menu, select Settings, then select Translation.
This displays the Glossary tab.
The Available languages displays the languages that you have enabled in your Help Center.
- Click or drag the prepared .csv file to upload it.
The following shows how the example .csv file above looks when loaded as the Glossary.
- Click Save Glossary.
When a .csv Glossary file has been uploaded, you can click the Download icon to download the file directly from the Settings.
CSV Column Delimiter Changer.
Changing the Translate Instructions to Change the ChatGPT Prompts
The Translate function includes a default Prompt for ChatGPT.
Display this from the Translate pop-up by clicking Translation Settings in the Source section, or, from the options at the bottom of the left-hand side menu, select Settings, then select Translation.
Then click the Translate Instructions tab.
- The System Instructions help to set the behavior of the translation and holds the main instructions for the translation.
The System Instructions in the Prompt provides the Role and is defined as "professional translator". The Prompt then includes instructions, rules and constraints for ChatGPT. The output of the task needs to be an HTML document.
The target language is specified with the variants of {{locale}} and {{language}} which are taken from the selections in the Destination section. The selection in Help Center Translation (the Zendesk Help Center Translation code, for example en-us or es) is the {{locale}} and the Translation language is {{language}}.
- The User Message provides requests or comments for ChatGPT to respond to.
- For details, refer to the OpenAI documentation GPT Models.
In the Translate Instructions, you have the option to save any changes by clicking Save Prompt.
You can restore the Swifteq defaults by clicking the Reset to Default Prompt link.
Adding a Translation Notice to Include a Disclaimer in the Translation
You can add a Translation Notice to include a disclaimer to articles translated with AI.
Display this from the Translate pop-up by clicking Translation Settings in the Source section, or, from the options at the bottom of the left-hand side menu, select Settings, then select Translation.
Then click the Translation Notice tab.
The disclaimer text in the Translation Notice is translated, along with your article, into the language of the translation.
You can select to insert this at either the beginning or the end of the translated version and you can use HTML to format the text.
- Enter the Translation Notice text that you want to add to translated articles and include any HTML.
- Select the Position as "Beginning of each article" or "End of each article".
- Click Save Notice.