Me
Based on these criteria: Names the doc(s)you drew from and clearly cite them.
Preserves visuals: includes at least one relevant image/screenshot from the doc.
Preserves links: any in-page or cross-doc links are present and correctly formatted.
Lists key fields with short explanations, defaults, and any validation rules (required/optional).
Mentions limits (size, file type, counts, rate limits) if the feature has them.
State what’s not covered if the needed info isn’t in the KB page, without referencing “chunks”.
Formatting: clear headings/bullets/tables; no jargon unexplained; no hallucinations. Explain how to generate AI Translations
Enki
# Generating AI Translations
This guide explains how to use the AI translation feature in Harmony's Localisation service to automatically translate your game's text into multiple languages.
**Source:** [Managing Localisations in Harmony](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3230760961)
---
## Overview
The AI Translations feature automates the translation of localisation keys within your game. Instead of manually translating text or uploading CSV files, you can generate translations for multiple languages directly through the interface.
---
## How to Generate AI Translations
### Step 1: Navigate to Translations (Test)
1. Access Harmony at:
- **Staging**: https://harmony-staging.tripledotapi.com/admin
- **Production**: https://harmony.tripledotapi.com/admin
2. Select your game from the home page
3. From the left sidebar, go to **Localisations > Translations (Test)**
### Step 2: Request AI Translation
1. Click the **[Download with AI]** button to open the translation request popup
2. **Select Target Languages**: Choose which languages you want translations generated for
3. Click **[Confirm]** to send the request to AI
### Step 3: Track Progress
After clicking **[Confirm]**, you'll see a message: "Operation has been successfully finished."
To monitor your translation request:
1. Navigate to **Localisations > AI Translations** from the left sidebar
2. View the status of your request in the table, which includes:
- Request date/time
- Target languages
- Current status (Scheduled, In Progress, Generated, or Failed)
- Download option (when complete)
---
## Downloading AI-Generated Translations
Once your translations are ready:
1. Go to **Localisations > AI Translations**
2. Locate your file in the table
3. If the status shows **"Generated"**, click the **Download** button
4. The CSV file will download in the same format as the standard Download/Upload feature
**Troubleshooting Download Issues:**
If the CSV doesn't download automatically:
- Right-click the **Download** button
- Select **"Save Link As..."**
- Choose your save location
---
## Using AI Translations in Your Game
The downloaded CSV contains your AI-generated translations in the same format as manual translations:
### CSV Format
- **Key**: Your localisation key name
- **Type**: Content type
- **Desc**: Description field
- **Language columns**: Translations for each requested language (using ISO-639-1 codes like `pt-BR`, `de`, `fr`)
### Applying Translations
1. Review the downloaded CSV to verify translation quality
2. Make any necessary adjustments to the translations
3. Upload the CSV via **Translations (Test) > [Upload CSV]**
4. Click **[Save]** to apply to your test environment
5. Test the translations in a test build
6. When satisfied, click **[Review Difference]** then **[Apply to Live]** to push to production
---
## Managing AI Translation Files
### Deleting Files
You can delete AI translation files that are:
- Scheduled (not yet processed)
- Generated (completed)
- Failed (encountered errors)
To delete:
1. In the **AI Translations** table, locate the file
2. Click the **delete** icon
3. Confirm deletion in the popup
---
## Key Points
- **Translation source**: AI uses your English (EN) source text as the basis for translations
- **Synchronization**: New translations are generated shortly after confirmation
- **File format**: Downloads match the standard CSV format for easy integration
- **Languages**: Only languages already added in **Localisations > Languages** can be selected
- **Quality control**: Always review AI translations before applying to production
- **Test first**: Use the test environment to verify translations before going live
---
## Prerequisites
Before using AI translations, ensure:
1. **Languages are configured**: Target languages must exist in **Localisations > Languages**
2. **Keys exist**: You have localisation keys with English source text in **Translations (Test)**
3. **Permissions**: You have appropriate access to the Localisation service
---
## Limitations Not Covered
This documentation covers the AI translation generation process. For information about:
- Setting up new languages
- Manual translation workflows
- CSV upload specifications
- Applying translations to live environments
Please refer to other sections of the [Managing Localisations in Harmony](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3230760961) documentation.