Skip to main content
After you configure target locales in your agentic workflow, export translatable text to CSV files, add translations, and import them back using CLI commands.

​
Exporting translations

Export translatable text from an agentic workflow to a CSV file:
Bash
orchestrate tools translation-export \
  -k flow \
  --name my_flow_name \
  --translation translations.csv
You can also export from an agentic workflow JSON file before importing:
Bash
orchestrate tools translation-export \
  -k flow \
  -f path/to/flowJson.json \
  --translation translations.csv

​
Creating translations

The exported CSV file contains:
  • key: Unique identifier for each translatable text element
  • en: Source language text or your configured source locale
  • locale: Source locale code
  • Additional columns for each target locale
Edit the CSV file and add translations for each target locale: 
key,en,locale,fr,es
form.instructions,Please fill out this form,en,Veuillez remplir ce formulaire,Por favor complete este formulario
form.submit_button,Submit,en,Soumettre,Enviar
form.cancel_button,Cancel,en,Annuler,Cancelar
field.name.label,Your Name,en,Votre nom,Su nombre
field.name.placeholder,Enter your full name,en,Entrez votre nom complet,Ingrese su nombre completo
user_activity.user_name.display_name,Enter your name,en,Entrez votre nom,Ingrese su nombre
user_activity.user_name.help_text,Please provide your full name,en,Veuillez fournir votre nom complet,Por favor proporcione su nombre completo
Ensure your CSV file uses UTF-8 encoding to properly handle special characters in different languages.

​
Importing translations

Import translations from a CSV file into an agentic workflow:
Bash
orchestrate tools translation-import \
  -k flow \
  --name my_flow_name \
  --translation translations.csv

​
Importing agentic workflows with translations

Import an agentic workflow and its translations in a single command:
Bash
orchestrate tools import \
  -k flow \
  -f path/to/my_flow.py \
  --translation translations.csv
This command imports the agentic workflow and applies the translations automatically.