Nopeuta monikielisiä työnkulkuja muokattavalla käännösratkaisulla, joka on rakennettu Amazon Translatella

Yritysten on usein kommunikoitava tehokkaasti suurelle määrälle asiakkaita, kumppaneita ja sidosryhmiä useilla eri kielillä. Heidän on käännettävä ja lokalisoitava sisältöjä, kuten markkinointimateriaaleja, tuotesisältöresursseja, käyttöoppaita ja juridisia asiakirjoja. Yrityksen jokaisella liiketoimintayksiköllä on erilaiset käännöstyömäärät, ja ne hallitsevat usein omat käännöstarpeensa ja -toimittajansa. Vaikka tämä hajautettu lähestymistapa saattaa antaa liiketoimintayksiköille käännösten autonomiaa ja joustavuutta, yritysten on vaikea ylläpitää käännösten yhdenmukaisuutta koko yrityksessä.

Amazon Translate on a hermo kone käännös palvelu, joka tarjoaa nopeat, laadukkaat, edulliset ja mukautettavat kielenkäännökset. Nykyään Amazon Translate tukee skaalattavaa kielikäännöstä yli 5,500 XNUMX kieliparille erässä ja reaaliajassa. Sen avulla voidaan rakentaa ratkaisuja, jotka vastaavat haasteisiin, joita yritykset, joilla on useita liiketoimintayksiköitä, kohtaavat etsiessään tapoja nopeuttaa monikielisiä työnkulkuja räätälöintituen avulla.

Esimerkiksi BMW-ryhmä tarvitsi yhtenäisen käännösratkaisun auttaakseen liiketoimintayksiköitä, kuten myyntiä ja tuotantoa, käyttämään käännösteknologiaa laajasti ja poistamaan yleisiä käännösvirheitä koko yrityksessä. Heidän ratkaisunsa kanssa Amazon Käännä vähentää käännösaikaa yli 75 % ja samalla antaa jokaiselle liiketoimintayksikölle mahdollisuuden räätälöidä tuotos vastaamaan erityisiä käännösvaatimuksiaan.

Tässä blogikirjoituksessa näytämme, kuinka luodaan yhtenäinen käännösratkaisu mukauttamisominaisuuksineen Amazon Translaten ja muiden AWS-palveluiden avulla. Näytämme myös, kuinka voit asentaa ja testata ratkaisua ja kuinka voit rakentaa mukautettavan ja skaalautuvan käännösratkaisun käyttäjille heidän osastojen lokalisointitarpeiden mukaan.

Ratkaisun yleiskatsaus

Ratkaisu käyttää Amazon Translaten alkuperäisiä ominaisuuksia, kuten reaaliaikaista käännöstä, automaattista lähdekielen tunnistusta ja mukautettu terminologia. käyttämällä Amazon API -yhdyskäytävä, nämä ominaisuudet näkyvät yhtenä yksinkertaisena /translate API. Mukautetun terminologian avulla voit määrittää tiettyjä mukautettuja käännöspareja. Jotta mukautettu terminologia toimisi, sinun on ladattava terminologiatiedosto Amazon Translateen. Siksi toinen API /customterm altistuu.

Ratkaisu havainnollistaa kahta käännösvaihtoehtoa: vakiokäännös ja mukautettu käännös (käyttäen mukautettua terminologiaominaisuutta). Voit kuitenkin muokata näitä vaihtoehtoja tarpeen mukaan vastaamaan liiketoimintasi vaatimuksia. Kuluttajat voivat käyttää näitä vaihtoehtoja API Gatewayn avulla API-avaimet. Kun API vastaanottaa käännöspyynnön, se vahvistaa pyynnön (käyttäen AWS Lambda valtuutustoiminto), onko annettu API-avain valtuutettu suorittamaan pyydetyn käännöstyypin. Käytämme an Amazon DynamoDB taulukko tallentaaksesi metatietotietoja kuluttajista, käyttöoikeuksista ja API-avaimista.

Tämä ratkaisu sopii kolmelle henkilötyypille:

• Normaali käännöspersoona – Liiketoimintayksikön käyttäjät, joilla ei ole räätälöintivaatimuksia. Tämä sisältää vakiokäännösvaihtoehdot ja -ominaisuudet, kuten Amazon Translaten automaattisen kielentunnistuksen.
• Räätälöity käännöshenkilö – Liiketoimintayksikön käyttäjät, joilla on räätälöintivaatimuksia. Tämä sisältää kaikki vakiokäännöksen ominaisuudet sekä mahdollisuuden mukauttaa käännöksiä mukautetun terminologiatiedoston avulla.
• Admin persoona – Tukee mukautettua käännösvaihtoehtoa hallitsemalla mukautettujen terminologiatiedostojen lataamista, mutta ei pysty tekemään muita käännössovellusliittymäkutsuja.

Seuraava kaavio havainnollistaa keskitettyä käännösratkaisua mukauttamisarkkitehtuurilla.

Käyttäjän käännöshenkilölle prosessi sisältää seuraavat toiminnot (sininen polku edellisessä kaaviossa):

1a. Soita /translate API ja välitä API-avain API-otsikkoon. Valinnaisesti käyttäjä voi ottaa mukautetun käännöksen käyttöön räätälöidylle käännöshenkilölle antamalla valinnaisen kyselymerkkijonoparametrin (useCustomTerm).

2. API-yhdyskäytävä vahvistaa API-avaimen.

3. Lambda-mukautettua valtuutusta kutsutaan vahvistamaan toimitettu API-avain sallittu. Esimerkiksi tavallinen käännöshenkilö ei voi pyytää mukautettua käännöstä tai järjestelmänvalvoja ei voi tehdä tekstinkäännöstä.

4. Lambda-valtuutettu saa käyttäjätiedot DynamoDB-taulukosta ja varmentaa annettua API-avainta vastaan.

5a. Validoinnin jälkeen toinen Lambda-toiminto (Kääntäjä) kutsutaan kutsumaan Amazon Translate API translate_text.

6a. Käännetty teksti palautetaan API-vastauksessa.

Järjestelmänvalvoja voi ladata mukautetun terminologiatiedoston, jota räätälöity käännöshenkilö voi käyttää, soittamalla numeroon /customterm API. Työnkulun vaiheet ovat seuraavat (vihreä polku edellisessä kaaviossa):

1b. Soita /customterm API ja välitä API-avain API-otsikkoon.

2. API-yhdyskäytävä vahvistaa API-avaimen.

3. Lambda-mukautettua valtuutusta kutsutaan vahvistamaan toimitettu API-avain sallittu. Esimerkiksi vain järjestelmänvalvoja voi ladata mukautettuja terminologiatiedostoja.

4. Lambda-valtuutettu saa käyttäjätiedot DynamoDB-taulukosta ja varmentaa annettua API-avainta vastaan.

5b. Kun API-avain on vahvistettu, toinen Lambda-toiminto (Upload) kutsutaan kutsumaan Amazon Translate API import_terminology.

6b. Mukautettu terminologiatiedosto ladataan Amazon Translateen ainutlaatuisella nimellä, jonka Lambda-toiminto on luonut.

Seuraavissa osioissa käymme läpi vaiheet ratkaisun käyttöönottamiseksi ja testaamiseksi.

Edellytykset

Tarvitset AWS-tilin ottaaksesi käyttöön ratkaisun. Jos sinulla ei vielä ole AWS-tiliä, voit luoda yksi. Sinulla on oltava pääsy AWS-tiliin AWS-henkilöllisyyden ja käyttöoikeuksien hallinta (IAM) käynnistysoikeudet AWS-pilven muodostuminen malleja, jotka luovat IAM-rooleja.

Huomaa, että olet vastuussa tämän esimerkkiasennuksen aikana käytettyjen AWS-palvelujen kustannuksista. Monet näistä palveluista (kuten Amazon Translate, API Gateway ja Lambda) sisältävät Free Tier -tason, jotta pääset alkuun. Katso tarkemmat tiedot kunkin tässä viestissä käyttämäsi AWS-palvelun hintasivuilta.

Ota ratkaisu käyttöön AWS CloudFormation -sovelluksella

Käynnistä toimitettu CloudFormation-malli ottaaksesi ratkaisun käyttöön AWS-tililläsi. Tämä pino toimii vain us-east-1 or eu-west-1 Alueet. Jos haluat ottaa tämän ratkaisun käyttöön muilla alueilla, katso GitHub repo ja ota CloudFormation käyttöön valitsemallasi alueella.

1. Ota uusin CloudFormation-malli käyttöön seuraamalla haluamasi alueen linkkiä:

Alue	CloudFormation-pino
N. Virginia (us-east-1)
Irlanti (eu-west-1)

2. Kirjaudu pyydettäessä sisään AWS-tilisi tunnistetiedoilla.
3. Jätä kentät päälle Luo pino sivu valmiiksi täytetyineen oletusasetuksineen.
4. Valita seuraava.
5. varten Pino nimi, kirjoita CloudFormation-pinon nimi (tätä viestiä varten, EnterpriseTranslate).
6. varten DDBT-taulukon nimi¸ syötä DynamoDB-taulukon nimi (EnterpriseTranslateTable).
7. varten apiGatewayName, anna pinon luoma API-yhdyskäytävä (EnterpriseTranslateAPI).
8. varten apiGatewayStageName, anna API-yhdyskäytävän (tuote) ympäristön nimi.
9. Valita seuraava.
10. Vahvista IAM-resurssien luominen valitsemalla tarkistussivulla valintaruudut. Tämä vaaditaan, jotta CloudFormation voi luoda roolin, joka antaa pääsyn pinon tarvitsemiin resursseihin ja nimeää resurssit dynaamisella tavalla.
11. Valita Luo pino.

Voit seurata pinon luomisen edistymistä Tapahtumat -välilehti. Pino on valmis, kun pinon tila näkyy muodossa CREATE_COMPLETE.

Käyttöönotto luo seuraavat resurssit (kaikkien etuliitteenä on EntTranslate):

• API Gateway API, jossa on kaksi resurssia nimeltä /customterm ja /translate, jossa on kolme API-avainta, jotka edustavat kahta käännöspersoonaa ja järjestelmänvalvojan persoonaa
• DynamoDB-taulukko, jossa on kolme kohdetta, jotka kuvastavat yhtä kuluttajaa kolmella eri roolilla (kolme API-avainta)
• Useita Lambda-toimintoja (käyttäen Python 3.9:ää) arkkitehtuurikaavion mukaan

Kun resurssit on otettu käyttöön tilillesi AWS Cloudissa, voit testata ratkaisua.

Kerää API-avaimet

Suorita seuraavat vaiheet kerätäksesi API-avaimet:

1. Siirry Lähdöt CloudFormation-pinon välilehti ja kopioi avaimen arvo apiGatewayInvokeURL.Löydäksesi ratkaisun luomat API-avaimet, katso juuri luomaasi DynamoDB-taulukkoa tai siirry API-avaimet -sivulle API Gateway -konsolissa. Tämä viesti käyttää jälkimmäistä lähestymistapaa.
2. On Esittelymateriaalit CloudFormation-pinon välilehti, etsi looginen tunnus EntTranslateApi API-yhdyskäytävälle ja avaa linkki Fyysinen henkilötodistus sarake uuteen välilehteen.
3. Valitse API-yhdyskäytävän konsolissa API-avaimet navigointipaneelissa.
4. Huomaa ratkaisun luomat kolme API-avainta (vakio, mukautettu, järjestelmänvalvoja). Valitse esimerkiksi vakionäppäin EntTranslateCus1StandardTierKey Ja valitse Näytä linkki API-avaimen ominaisuutta vastaan.

Nyt voit testata sovellusliittymiä millä tahansa valitsemillasi avoimen lähdekoodin työkaluilla. Tässä viestissä käytämme Postinkantaja API-testaustyökalu vain havainnollistamistarkoituksiin. Katso lisätietoja API-testauksesta Postmanilla API-kehityksen yleiskatsaus.

Testi 1: Vakiokäännös

Standardin käännössovellusliittymän testaamiseksi sinun on ensin luotava POST-pyyntö Postmanissa.

1. Valita Lisää pyyntö Postissa.
2. Aseta menetelmän tyypiksi POST.
3. Anna API-yhdyskäytävän kutsu-URL käyttöönotetun CloudFormation-pinon Output-välilehdeltä.
4. Lisää /translate URL-päätepisteeseen.
5. On Otsikot -välilehti, lisää uusi otsikkoavain nimeltä x-api-key.
6. Anna standardi API-avaimen arvo (kopioitu API-avaimien kerääminen -vaiheessa).
7. On elin välilehti, valitse raaka ja kirjoita JSON-runko seuraavasti:

   {   "sourceText": "some text to translate",   "targetLanguage": "fr",   "sourceLanguage":"en"}

   sourceLanguage on valinnainen parametri. Jos et anna sitä, järjestelmä asettaa sen muotoon auto lähdekielen automaattiseen tunnistamiseen.

8. Kutsu API valitsemalla Lähetä ja tarkista tulos.
   

API:n pitäisi toimia onnistuneesti ja palauttaa käännetyn tekstin elin vastausobjektin osa.

Testi 2: Räätälöity käännös mukautetulla terminologialla

Mukautetun termin lataustoiminnon testaamiseksi luomme ensin PUT-pyynnön Postmanissa.

1. Valita Lisää pyyntö Postissa.
2. Aseta menetelmän tyypiksi PUT.
3. Anna API-yhdyskäytävän kutsu-URL-osoite.
4. Lisää /customterm URL-osoitteen loppuun.
5. On Otsikot -välilehti, lisää uusi otsikkoavain nimeltä x-api-key.
6. Anna järjestelmänvalvojan API-avaimen arvo (kopioitu API-avaimien kerääminen -vaiheessa).
7. On elin -välilehti, muuta muotoa muotoon binaarinen ja lataa mukautetun termin CSV-tiedosto. Malli-CSV-tiedosto on alla /Resources kansio GitHub repossa.
8. Kutsu API valitsemalla Lähetä ja tarkista tulos.
   
   API:n pitäisi toimia onnistuneesti, ja vastausobjektin tekstiosassa tulee viesti "Muokattu termi lähetetty onnistuneesti".
9. Valitse Amazon Translate -konsolista Mukautettu terminologia navigointipaneelissa.
   Mukautettu terminologiatiedosto olisi pitänyt ladata, ja se näkyy terminologialuettelossa. Tiedostonimen syntaksi on DynamoDB-taulukon asiakastunnus valitulle API-avaimelle, jota seuraa merkkijono _customterm_1.
   Huomaa, että jos et käyttänyt järjestelmänvalvojan API-avainta, järjestelmä ei pysty lataamaan mukautettua termitiedostoa. Nyt olet valmis suorittamaan mukautetun käännöksen.
10. Valita Lisää pyyntö Postissa.
11. Aseta menetelmän tyypiksi POST.
12. Anna API-yhdyskäytävän kutsu-URL-osoite.
13. Lisää /translate URL-päätepisteeseen.
14. On Otsikot -välilehti, lisää uusi otsikkoavain nimeltä x-api-key.
15. Anna standardi API-avaimen arvo.
16. On elin -välilehti, kirjoita JSON-teksti seuraavasti:

    {   "sourceText": "some text to translate",   "targetLanguage": "fr",   "sourceLanguage":"en"}

17. On Parametrit -välilehti, lisää uusi kyselymerkkijonoparametri nimeltä useCustomTerm arvolla 1.
18. Kutsu API valitsemalla Lähetä ja tarkista tulos. API:n pitäisi epäonnistua viestillä "Unauthorized". Tämä johtuu siitä, että yrität kutsua mukautettua käännösominaisuutta käyttämällä tavallista persona API-avainta.
19. On Otsikot -välilehti, anna mukautettu API-avaimen arvo.
20. Suorita testi uudelleen, ja sen pitäisi pystyä kääntämään mukautetun terminologiatiedoston avulla.

Huomaat myös, että tällä kertaa käännetty teksti säilyttää sanan "käännä" kääntämättä sitä (jos käytit toimitettua esimerkkitiedostoa). Tämä johtuu siitä, että aiemmin ladatussa mukautetussa terminologiatiedostossa on sana "käännä", mikä viittaa siihen, että mukautettu terminologia muutti Amazon Translate -sovelluksen perustulostetta.

Testi 3: Lisää kuluttajia ja liiketoimintayksiköitä

Tämä ratkaisu otti käyttöön yhden kuluttajan (customerA) kolmella eri API-avaimella osana CloudFormation-pinon käyttöönottoa. Voit lisätä kuluttajia luomalla uuden käyttösuunnitelman API Gatewayssa ja liittämällä uusia API-avaimia tähän käyttösuunnitelmaan. Lisätietoja käyttösuunnitelmien ja API-avaimien luomisesta on kohdassa Käyttösuunnitelmien luominen ja käyttäminen API-avaimilla. Voit sitten lisätä nämä API-avaimet lisätietoina DynamoDB-taulukkoon.

Puhdistaa

Vältä tulevia maksuja puhdistamalla resurssit, jotka loit osana CloudFormation-pinoa:

1. Siirry AWS CloudFormation -konsolissa luomaasi pinoon.
2. Valitse pino ja valitse Poista pino.

Pinon poistaminen voi kestää jonkin aikaa. Voit seurata sen etenemistä osoitteessa Tapahtumat -välilehti. Kun poisto on valmis, pinon tila vaihtuu DELETE_IN_PROGRESS että DELETE_COMPLETE. Sitten se katoaa luettelosta.

Huomioita

Ota huomioon seuraavat seikat, kun käytät tätä ratkaisua:

• Tämän ratkaisun API-kutsut ovat hitaampia kuin suora kutsuminen Amazon Translate API:lle. Tämä johtuu siitä, että ratkaisu toteuttaa lisäliiketoimintalogiikkaa ja käyttää lisäpalveluita (API Gateway ja Lambda).
• Huomaa Amazon Translate palvelurajat Synkroniseen reaaliaikaiseen käännökseen ja mukautettuihin terminologiatiedostoihin.
• Tämä ratkaisu keskittyy sovellusliittymän paljastamiseen API-avaimen avulla. Jos aiot viedä tämän tuotantoympäristöihin, harkitse todennusmekanismia käyttämällä avoimia alan standardeja (kuten OIDC) pyynnön todentamiseksi. Lisätietoja on kohdassa Usean vuokraajan sovellusliittymien hallinta Amazon API Gatewayn avulla.

Yhteenveto

Tässä viestissä osoitimme, kuinka helppoa on tehdä reaaliaikainen käännös, ladata mukautettuja terminologiatiedostoja ja tehdä mukautettuja käännöksiä Amazon Translatessa käyttämällä sen alkuperäisiä API-liittymiä, ja loimme ratkaisun, joka tukee mukauttamista API Gatewayn avulla.

Voit laajentaa ratkaisua räätälöinnillä, jotka vastaavat liiketoimintasi vaatimuksia. Voit tarjota esimerkiksi lisätoimintoja, kuten Aktiivinen mukautettu käännös käyttämällä rinnakkaista dataa toisen API-avaimen kautta tai luomalla välimuistikerroksen tämän ratkaisun kanssa alentamaan käännöskustannuksia entisestään ja palvelemaan usein käytettyjä käännöksiä välimuistista. Voit ottaa käyttöön API-rajoituksen ja nopeuden rajoittamisen hyödyntämällä API-yhdyskäytävän ominaisuudet. Mahdollisuudet ovat rajattomat, ja haluaisimme kuulla, kuinka saat tämän ratkaisun organisaatiosi uudelle tasolle lähettämällä AWS Ota yhteyttä pyyntö. Voit aloittaa tämän ratkaisun mukauttamisen siirtymällä kohtaan GitHub repo tälle blogille.

Lisätietoja Amazon Translatesta on osoitteessa Amazon Translate -resurssit löytääksesi videoresursseja ja blogikirjoituksia sekä viitata myös Amazon Translate UKK. Jos olet uusi Amazon Translatessa, kokeile sitä käyttämällä Ilmainen taso, joka tarjoaa jopa 2 miljoonaa merkkiä kuukaudessa ilmaiseksi ensimmäisten 12 kuukauden ajan ensimmäisestä käännöspyynnöstäsi alkaen.

---

Kirjailijasta

Fahad Ahmed on Amazon Web Services (AWS) -ratkaisuarkkitehti ja huolehtii digitaalisista alkuperäisyrityksistä Isossa-Britanniassa. Hänellä on yli 17 vuoden kokemus ohjelmistosovellusten rakentamisesta ja suunnittelusta. Hän löysi äskettäin uuden intohimon tehdä tekoälypalveluita massojen saataville.