Managing translations for agentic workflows

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

Show command flags

--kind (-k)

string

required

Must be flow for translation operations.

--name (-n)

string

Name of an imported agentic workflow tool. Required if you do not provide --file.

--file (-f)

string

Path to an agentic workflow JSON file. Required if you do not provide --name.

--translation

string

required

Path where the system saves the translation CSV file.

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

Show command flags

Flag	Type	Required	Description
`--kind` (`-k`)	string	Yes	Must be `flow` for translation operations.
`--name` (`-n`)	string	Yes	Name of the imported agentic workflow tool.
`--translation`	string	Yes	Path to the translation CSV file to import.

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.

Release Notes

Get Started

Build

Deploy

Analyze

Developer experience

Legal notices

Exporting translations

Creating translations

Importing translations

Importing agentic workflows with translations

​Exporting translations

​Creating translations

​Importing translations

​Importing agentic workflows with translations

Exporting translations

Creating translations

Importing translations

Importing agentic workflows with translations