Product translation agent
A chat agent that translates the texts of one product at a time. You type a SKU, it shows the name, the short description and the description in the languages that are still empty, and it saves them after your yes.
| In short | |
|---|---|
| Where you use it | On the Products & Clusters list in the Backoffice, behind the Workflows button |
| Starts | With a chat message that holds a SKU |
| Changes in Propeller | Fills in empty product texts. It never replaces a text that is there |
| Uses AI | Yes, OpenAI. It gets the texts of the product |
| Texts | English, Dutch or French: the language of your message, or a setting |
| Runs in n8n | One per message, so two per product: the proposal and your answer |
| Difficulty | Medium. You set the languages and a longer waiting time on the agent |
What you get
Type a SKU to translate into the standard languages. Add language codes to choose them yourself, for example ABC-123 DE FR. To translate from another language than the standard one, name it first: ABC-123 FR > NL EN. A sentence works too, in English, Dutch or French, for example "translate ABC-123 from French into Dutch and English". Answer yes and exactly the texts you saw are saved. Answer no and nothing changes.
What you need
- An n8n account with the credential
Propeller API key. See Set up n8n. - An API key with Editor access on Product Data.
- An OpenAI account. You pay OpenAI per use.
- Backoffice access and the Configuration role with Owner access, to register the agent.
How it works
The agent reads the texts of the product in the source language and translates only what is empty in a target language. The layout of a description, such as bold text and lists, is kept.
When a text is empty in the source language, the agent translates from the language that has the most texts, and fills the source language as well.
When there is nothing to translate, the agent says why: the texts are already there, or there is no text to translate from. It also tells you what to type to fill the languages that are still empty.
A text that exists is never replaced. So the web address of the product in a language that was already filled in stays the same.
The proposal stays ready for 24 hours, and only when the workflow is published. After that you ask again.
The workflows and agents in the Agent Hub are free to use and adapt. They are examples, not supported product features. Test them in a test environment and check the results before you use them on real customers.
Install it
Install a workflow from the library explains each step.
- Import the file into n8n.
- Open the node Translate and pick your OpenAI account.
- Check that the three nodes that talk to Propeller use the credential
Propeller API key. - Open the Settings node and set
SOURCE_LANGUAGEandTARGET_LANGUAGES. - Follow Register the agent in Propeller with the values below.
- Go to PIM > Products & Clusters, click Workflows, pick the agent and type a SKU.
| Field | Value |
|---|---|
| Trigger | Chat |
| Interaction mode | Multi turn |
| Placements | Back office · Products, the Products & Clusters list |
| Webhook Timeout (ms) | 60000. A long description can take more than the standard 30 seconds |
The agent answers with the translation and the question to answer yes or no. Until you answer yes, nothing is saved. If the product already has texts in the languages you asked for, the agent says so and changes nothing.
Make it yours
| Setting | Default | What it does |
|---|---|---|
SOURCE_LANGUAGE | 'NL' | The language that is translated from, unless your message names another |
TARGET_LANGUAGES | ['EN'] | The languages that are filled when your message names none |
LANGUAGE | 'EN' | The language of the answers when your message does not show one: 'EN', 'NL' or 'FR' |
FIELDS | Name, short description and description | The product texts that are translated |
PROPOSAL_HOURS | 24 | How long a proposal can still be saved |
The AI model is set in the node Translate.
Limits
- One product per message. For a whole catalogue this agent is not the right tool.
- The SKU has to match exactly, including capitals.
- A translation by AI can be wrong. Read it before you answer yes.
Related pages
- Create and edit a product
- Products without images - another agent for the product list
- Register an AI agent