Mitä OpenAI-käännösten käyttöönotto edellyttää

AI Commercen OpenAI-käännökset tarvitsevat kaupalle määritetyn OpenAI-palveluntarjoajan, lähdekielen, vähintään yhden kohdekielen ja kuukausibudjetin. API-avain on salaisuus. Sitä ei syötetä artikkelin linkistä luotuna suoraan Hallintapaneelin tavalliseen tekstikenttään eikä lähetetä tukipyyntöön.

Hallintapaneelin Integrations -näkymä on tarkistusnäkymä: integraation kentät ovat vain luettavissa ja salaiset arvot näytetään peitettyinä. Pyydä kaupan konfiguraation omistajaa lisäämään OPENAI_API_KEY hyväksytyn salaisuushallinnan kautta. Omistaja voi samalla määrittää OPENAI_TRANSLATION_MODEL- ja OPENAI_TRANSLATION_INSTRUCTION-arvot, jos kauppa tarvitsee muuta kuin toteutuksen oletuksen.

Varmista käytössä oleva tarjoaja

Avaa /configuration/integrations ja tarkista OpenAI-kortti. OpenAI-integraation pitää olla valmiina ennen kuin automaattikäännöksen kohdekielet voidaan ottaa käyttöön. Peitetyn API-avaimen arvoa ei tarvitse eikä pidä paljastaa tarkistusta varten.

Käännöstyönkulku valitsee OpenAI:n, kun OPENAI_API_KEY on määritetty. Muussa tapauksessa se tarkistaa DeepL-avaimen ja sen jälkeen Google Translate -avaimen. Älä tyhjennä olemassa olevia DeepL- tai Google Translate -tunnuksia vain tämän ohjeen perusteella. Vahvista haluttu tarjoaja AI Automations > Auto-translation -välilehden Tarjoaja-riviltä.

Jos näkymä ilmoittaa, ettei tarjoajaa ole konfiguroitu, pysähdy ja pyydä konfiguraation omistajaa korjaamaan puuttuva tai virheellinen avain. Älä kierrä lukitusta muuttamalla kohdekieliä suoraan tietokannasta.

Älä valitse OpenAI:ta tai DeepL:ää pelkän vertailutaulukon perusteella. Arvioi hyväksytyllä näytteellä kummankin tarjoajan käännöslaatu, kontekstin hyödyntäminen, kielituki, sanasto, suuren tekstin pyyntöraja, nopeus, merkkihinnoittelu ja kokonaiskustannus. OpenAI saa toteutuksessa rakenteisen sivu-, taulu-, sarake- ja instructionKey-kontekstin; tämä ei yksin todista sen olevan jokaiselle sisällölle parempi tai halvempi.

Määritä kuukausibudjetti ja kohdekielet

Avaa OpenAI-käännösten budjetti ja kohdekielet osoitteesta /ai-automations?tab=autoTranslate tai valitsemalla AI Automations > Auto-translation. Näkymä näyttää kaupan oletuskielen, tunnistetun tarjoajan, kuukaudessa käytetyt merkit sekä kuukausirajan.

Anna Kuukausiraja-kenttään nolla tai positiivinen kokonaisluku. Arvo 0 tarkoittaa rajoittamatonta merkkimäärää. Muutos tallentuu automaattisesti. Käyttö lasketaan käännettävistä merkeistä; OpenAI-palvelun todellinen tokeni- ja rahakustannus ei ole sama mittari. Valitse raja hyväksytyn kustannusbudjetin perusteella.

Ota tämän jälkeen käyttöön vain ne kohdekielet, joita ajastettu käännöstyönkulku saa päivittää. Tenantin oletuskieli on käännöksen lähtökieli eikä sitä voi valita kohdekieleksi. Tallenna yksi kieli kerrallaan ja varmista, ettei näkymä palauta tallennusvirhettä. Kun kuukausiraja saavutetaan, automaattikäännökset eivät voi jatkaa ennen seuraavaa jaksoa tai hyväksyttyä rajan muutosta.

Rajaa käännösohje turvallisesti

OPENAI_TRANSLATION_INSTRUCTION välitetään OpenAI-kääntäjälle developer-ohjeena järjestelmän kiinteiden käännössääntöjen lisäksi. Kirjoita siihen vain kaupan omat sanasto-, äänensävy- ja termivalinnat. Älä lisää SYSTEM:, DEVELOPER:- tai USER:-roolietuliitteitä äläkä yritä muuttaa ohjeella sovelluksen käyttöoikeuksia tai liiketoimintalogiikkaa.

Sovellus antaa jo lähtö- ja kohdekielen sekä taulun, sarakkeen, avaimen ja sivun kontekstiksi. Kiinteä ohje pyytää säilyttämään HTML-rakenteen, brändit, SKU:t, numerot, yksiköt ja hinnat sekä palauttamaan JSON-vastauksen. Se myös käsittelee jo kohdekielellä olevan tekstin sellaisenaan ja sekakielisestä tekstistä vain lähtökielisen osuuden. Älä toista näitä sääntöjä kaupan ohjeessa.

Pidä kaupan ohje lyhyenä ja yksiselitteisenä. Pitkä ohje ja kielikohtainen sanasto lisäävät mallille lähetettävää sisältöä, vaikka kuukausiraja mittaa käännettäviä merkkejä. Hallintapaneelissa ei ole OpenAI-sanaston muokkauspintaa; pyydä sanastomuutokset konfiguraation tai kielidatan omistajalta.

Tee rajattu testikäännös

Avaa /cms/translations eli CMS > Käännökset. Valitse testiin sovittu sivu ja kohdekieli. Käytä yhden hyväksytyn käännösrivin Automaattikäännä-toimintoa ja tarkista tulos ennen ajastetun työn laajaa käyttöönottoa.

Varmista testistä ainakin:

• lähtökieli ja kohdekieli ovat oikein
• kaupan termi ja äänensävy toteutuvat
• brändi, SKU, numerot, yksiköt, hinnat ja mahdollinen HTML säilyvät
• käännös ei sisällä JSON-kehystä tai [CONTINUE]-merkintää
• käyttömittarin merkkimäärä kasvaa odotetusti
• tallennettu teksti näkyy oikeassa käyttöliittymässä tai verkkokaupan näkymässä.

Jos tulos on virheellinen, poista kohdekielen automaattikäännös käytöstä ennen seuraavaa ajastettua ajoa. Tallenna testin sivu, kieli, käännösavain, odotettu ja toteutunut tulos sekä mahdollinen pyyntötunniste vianrajausta varten. Älä lähetä API-avainta virheraporttiin.

Seuraa käyttöönottoa

Seuraa merkkikäyttöä sekä AI Automations > Auto-translation-välilehdeltä että CMS > Käännökset -näkymästä. Tarkista ensimmäisten ajojen jälkeen käännösnäyte jokaisesta käyttöön otetusta kohdekielestä ja sisällön päätyypistä.

Mallin nimi tai hinnoittelu ei ole pysyvä käyttöönottopäätös. Kun mallia, käännösohjetta, sanastoa, kohdekieliä tai budjettia muutetaan, tee uusi rajattu testi ja kirjaa hyväksyjä. Älä päättele laatua, nopeutta tai kustannusta pelkästä mallivertailusta.