Tämän ohjeen avulla saat käyttöön modernin OpenAI-kääntäjän, joka ymmärtää sivukontekstin, palauttaa JSON-vastaukset ja skaalautuu eri hintatasoihin. Näin nopeutat tuotteiden ja käyttöliittymän lokalisointia ilman manuaalista copy-pastea.

Hyödyt yhdellä silmäyksellä

• Konteksti mukaan (taulu, sarake, sivu) → tarkemmat käännökset
• Mallivalinta nopeuden ja hinnan mukaan → https://platform.openai.com/docs/pricing
• Voit määritellä itse Translation Instructions → Mahdollista rakentaa glossaario

Mistä editoidaan?

Avaa Hallintapaneeli → Configuration → MyStore → OpenAI **. Kaikki alla mainitut asetukset löytyvät samasta näkymästä.

Asetukset

OpenAI Translation Instruction

OpenAI Translation Instruction -kenttä lähetetään mallille aina developer-roolissa, joten siihen ei pidä lisätä etuliitteitä kuten SYSTEM:, DEVELOPER: tai USER:.

Sovellus antaa jo valmiiksi mallille perussäännöt (lähdekieli → kohdekieli, kontekstitiedot, JSON-vastausmuoto, HTML:n käsittely sekä brändien, SKU:iden, numeroiden, yksiköiden ja hintojen säilyttäminen). Siksi sinun ei tarvitse toistaa niitä tässä kentässä.

Kenttä on tarkoitettu vain kauppakohtaisiin ohjeisiin (esim. tone-of-voice ja termivalinnat). Ohjeilla ei voi muuttaa sovelluksen liiketoimintalogiikkaa: sovellus kääntää aina vain tyhjät kohdekielen kentät, eikä koskaan “toisinpäin” tai jo täytettyjä käännöskenttiä.

System-tasolla annetaan myös alla olevat säännöt:

• Jos teksti on jo kokonaan kohdekielellä, palauta se sellaisenaan.
• Jos teksti sisältää sekoituksen lähde- ja kohdekieltä, käännä vain lähdekieliset osat kohdekielelle.
• Jos teksti on liian pitkä yhteen vastaukseen, käännöksen loppuun lisätään [CONTINUE].

Vaiheittainen käyttöönotto

1. Avaa Hallintapaneeli → Configuration → MyStore → OpenAI **.
2. Valitse OpenAI Translation Model tarpeesi mukaan:
   • o1-mini – nopea & edullinen testaukseen
   • GPT5 – paras laatu laajoihin teksteihin
3. Muokkaa OpenAI Translation Instruction, jos haluat yrityksesi tone-of-voice-säännöt (älä lisää SYSTEM/DEVELOPER/USER-etuliitteitä).
4. Tarvittaessa säädä Translation API - Monthly Character Limit suojarajaksi. Huomioi että merkkeihin lasketaan vain käännöstekstit. Pitkä tai monimutkainen Translation Instruction ja Glossaari nostavat todellista tokenien käyttöä huomattavasti!
5. Varmista, että OpenAI API Key on asetettu ympäristöön (katso ”API-avaimen luonti”).
6. Tallenna muutokset ja tee testikäännös esimerkiksi tuotekortille.

Vertailu DeepL-ratkaisuun

Glossaryn muokkaus

1. Avaa Local & Taxes > Languages > Valitse kieli > Glossary.
2. Kirjoita esim:

Ohjaustarvikkeet=Liikluskorralduse lisaseadmed, Opastimet=Käeshoitavad märgid, Käsiopastimet=Käesignaalid ...

1. Tallenna. Glossaari lähetetään developer-roolissa, joten se ohittaa käännettävän tekstin sanamuodot.

Käyttöönotto

1. Tyhjennä tarvittaessa Google Translate ja DeepL -avaimet, jotta myöhemmin ei tule epäselvyyttä käytössä olevasta käännöspalvelusta.
2. Siirry https://platform.openai.com/api-keys
3. Valitse API Keys → + Create new secret key.
4. Kopioi avain heti.
5. Tallenna se My Storessa kohtaan OpenAI API Key