Rövid útmutató: Azure Translator SDK-k (szövegfordítás)

Ebben a rövid útmutatóban ismerkedjen meg a Translator használatával a szöveg lefordításához egy tetszőleges programozási nyelv használatával. Ebben a projektben az ingyenes tarifacsomag (F0) használatát javasoljuk, amíg elsajátítja a technológiát, és később egy fizetős szintre frissít termelési célokra.

Előfeltételek

Aktív Azure-előfizetésre van szüksége. Ha nem rendelkezik Azure-előfizetéssel, ingyenesen létrehozhat egyet

• Miután megkapta az Azure-előfizetését, hozzon létre egy Translator-erőforrást az Azure Portalon.

• Az erőforrás üzembe helyezése után válassza az Ugrás az erőforráshoz lehetőséget, és kérje le a kulcsot és a végpontot.

  • Szerezze be a kulcsot, a végpontot és a régiót az erőforrásból, és csatlakoztassa az alkalmazást a Translatorhez. Illessze be ezeket az értékeket a kódba a rövid útmutató későbbi részében. Ezeket az Azure Portal kulcsai és végpontja lapon találja meg:

    

A C#/.NET-környezet beállítása

Ebben a rövid útmutatóban a Visual Studio IDE legújabb verzióját használjuk az alkalmazás létrehozásához és futtatásához.

1. Indítsa el a Visual Studiót.

2. Az Első lépések lapon válassza az Új projekt létrehozása lehetőséget.

   

3. Az Új projekt létrehozása lapon adja meg a konzolt a keresőmezőbe. Válassza ki a konzolalkalmazás-sablont, majd válassza a Tovább gombot.

   

4. Az új projekt konfigurálása párbeszédpanelen írja be text-translation-sdk a Projekt neve mezőbe. Ezután válassza a Tovább gombot.

   

5. A További információ párbeszédpanelen válassza a .NET 6.0 (Hosszú távú támogatás), majd a Létrehozás lehetőséget.

   

Az ügyfélkódtár telepítése a NuGettel

1. Kattintson a jobb gombbal a Translator-text-sdk projektre, és válassza a Manage NuGet Packages...

2. Jelölje be a Browse Tab billentyűt és a jelölőnégyzetet, és írja be az Include prereleaseAzure.AI.Translation.Text szöveget.

   

3. Válassza ki a verziót 1.0.0-beta.1 a legördülő menüből, és telepítse a csomagot a projektbe.

   

Építse fel alkalmazását

Ahhoz, hogy a Translator az ügyfélkódtár használatával működjön együtt, létre kell hoznia egy példányt az TextTranslationClientosztályból. Ehhez hozzon létre egy példányt a AzureKeyCredential adatokkal a key-ból az Azure portálról, valamint egy TextTranslationClient példányt a AzureKeyCredential adatokkal. A hitelesítés kissé eltérő attól függően, hogy az erőforrás a regionális vagy a globális végpontot használja-e. Ebben a projektben a hitelesítés a globális végponttal történik. További információ a regionális végpontok használatáról :Translator text sdks.

Megjegyzés:

• A .NET 6-tól kezdve a console sablont használó új projektek új programstílust hoznak létre, amely eltér a korábbi verzióktól.
• Az új kimenet a legutóbbi C#-funkciókat használja, amelyek leegyszerűsítik az írandó kódot.
• Az újabb verzió használatakor csak a Main metódus törzsét kell írnia. Nem kell felső szintű utasításokat, globális using irányelveket vagy implicit using irányelveket használnia.
• További információért tekintse megúj C#-sablonok által generált legfelső szintű utasításokat.

1. Nyissa meg a Program.cs fájlt.

2. Törölje a meglévő kódot, beleértve a sort Console.WriteLine("Hello World!")is, és írja be a következő kódmintát az alkalmazás Program.cs fájljába:

Kódrészlet

Fontos

Ne felejtse el eltávolítani a kulcsot a kódból, amikor elkészült, és soha ne tegye közzé nyilvánosan. A termelési környezetben használjon biztonságos módszert a hitelesítő adatok tárolására és elérésére, például az Azure Key Vaultot. További információ : Foundry Tools security.

Szöveg lefordítása

Megjegyzés:

Ebben a példában a globális végpontot használjuk. Ha regionális végpontot használ, olvassa el a Szövegfordítási ügyfél létrehozása című témakört.

using Azure;
using Azure.AI.Translation.Text;


string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

try
{
    string targetLanguage = "fr";
    string inputText = "This is a test.";

    Response<IReadOnlyList<TranslatedTextItem>> response = await client.TranslateAsync(targetLanguage, inputText).ConfigureAwait(false);
    IReadOnlyList<TranslatedTextItem> translations = response.Value;
    TranslatedTextItem translation = translations.FirstOrDefault();

    Console.WriteLine($"Detected languages of the input text: {translation?.DetectedLanguage?.Language} with score: {translation?.DetectedLanguage?.Score}.");
    Console.WriteLine($"Text was translated to: '{translation?.Translations?.FirstOrDefault().To}' and the result is: '{translation?.Translations?.FirstOrDefault()?.Text}'.");
}
catch (RequestFailedException exception)
{
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
}

Az alkalmazás futtatása

Miután hozzáadta a kódmintát az alkalmazáshoz, válassza a zöld Start gombot a formRecognizer_quickstart mellett a program létrehozásához és futtatásához, vagy nyomja le az F5 billentyűt.

Íme egy kódrészlet a várt kimenetről:

A Java-környezet beállítása

Megjegyzés:

A Java-hoz készült Azure Text fordítási SDK-t Windows, Linux és macOS platformokon teszteljük és támogatjuk. Más platformokon nem tesztelik, és nem támogatja az Android-telepítéseket.

Ebben a rövid útmutatóban a Gradle buildautomatizálási eszközt használjuk az alkalmazás létrehozásához és futtatásához.

• A Visual Studio Code vagy az előnyben részesített IDE legújabb verziójával kell rendelkeznie. Lásd aJava-t a Visual Studio Code-ban.

  Jótanács

  • A Visual Studio Code a Java kódolási csomagját kínálja Windowshoz és macOS-hez. A kódolási csomag a VS Code, a Java Fejlesztői Készlet (JDK) és a Microsoft által javasolt bővítmények gyűjteménye. A kódolási csomag egy meglévő fejlesztési környezet javításához is használható.
  • Ha VS Code-ot és Java kódolási csomagot használ, telepítse a Gradle for Java bővítményt.

• Ha nem a Visual Studio Code-ot használja, győződjön meg arról, hogy telepítve van a következő a fejlesztői környezetben:

  • A Java Development Kit (OpenJDK) 8-es vagy újabb verziója.

  • Gradle, 6.8-es vagy újabb verzió.

Új Gradle-projekt létrehozása

1. A konzolablakban (például a parancsmag, a PowerShell vagy a Bash) hozzon létre egy új könyvtárat az alkalmazáshoz szövegfordítási alkalmazás néven, és navigáljon hozzá.

   mkdir text-translation-app && text-translation-app
   

   mkdir text-translation-app; cd text-translation-app
   

2. Futtassa a gradle init parancsot a text-translation-app könyvtárból. Ez a parancs alapvető buildfájlokat hoz létre a Gradle számára, beleértve a build.gradle.kts fájlt is, amelyet futásidőben használnak az alkalmazás létrehozásához és konfigurálásához.

   gradle init --type basic
   

3. Amikor a rendszer kéri, hogy válasszon egy DSL-t, válassza a Kotlin lehetőséget.

4. Fogadja el az alapértelmezett projektnevet (text-translation-app) a Return vagy az Enter billentyűkombinációval.

   Megjegyzés:

   A teljes alkalmazás létrehozása eltarthat néhány percig, de hamarosan több mappát és fájlt is látnia kell, köztük.build-gradle.kts

5. Frissítsen build.gradle.kts az alábbi kóddal. A fő osztály a Fordítás:

     plugins {
     java
     application
   }
   application {
     mainClass.set("Translate")
   }
   repositories {
     mavenCentral()
   }
   dependencies {
     implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")
   }
   

A Java-alkalmazás létrehozása

1. A text-translation-app könyvtárban futtassa a következő parancsot:

   mkdir -p src/main/java
   

   A parancs a következő könyvtárstruktúrát hozza létre:

   

2. Lépjen a java könyvtárra, és hozzon létre egy fájlt.Translate.java

   Jótanács

   • Új fájlt a PowerShell használatával hozhat létre.

   • Nyisson meg egy PowerShell-ablakot a projektkönyvtárban a Shift billentyűt lenyomva tartva kattintson a jobb gombbal a mappára.

   • Írja be a következő parancsotNew-Item Translate.java.

   • Létrehozhat egy új fájlt is a névvel ellátott Translate.java IDE-ben, és mentheti azt a java könyvtárba.

3. Másolja és illessze be a következő szövegfordítási kódmintát a Translate.java fájlba.

   • Frissítse a "<your-key>", "<your-endpoint>" és "<region>" elemeket az Azure Portal Translator-példányából származó értékekkel.

Kódrészlet

Szöveg lefordítása

Fontos

Ne felejtse el eltávolítani a kulcsot a kódból, amikor elkészült, és soha ne tegye közzé nyilvánosan. A termelési környezetben használjon biztonságos módszert a hitelesítő adatok tárolására és elérésére, például az Azure Key Vaultot. További információ : Foundry Tools security.

Ahhoz, hogy a Translator az ügyfélkódtár használatával működjön együtt, létre kell hoznia egy példányt az TextTranslationClientosztályból. Ehhez hozzon létre egy példányt a AzureKeyCredential adatokkal a key-ból az Azure portálról, valamint egy TextTranslationClient példányt a AzureKeyCredential adatokkal. A hitelesítés kissé eltérő attól függően, hogy az erőforrás a regionális vagy a globális végpontot használja-e. Ebben a projektben a hitelesítés a globális végponttal történik. További információ a regionális végpontok használatáról :Translator text sdks.

Megjegyzés:

Ebben a példában a globális végpontot használjuk. Ha regionális végpontot használ, olvassa el a Szövegfordítási ügyfél létrehozása című témakört.

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;
/**
 * Translate text from known source language to target language.
 */
public class Translate {

    public static void main(String[] args) {
        String apiKey = "<your-key>";
        AzureKeyCredential credential = new AzureKeyCredential(apiKey);

        TextTranslationClient client = new TextTranslationClientBuilder()
                .credential(credential)
                .buildClient();

        String from = "en";
        List<String> targetLanguages = new ArrayList<>();
        targetLanguages.add("es");
        List<InputTextItem> content = new ArrayList<>();
        content.add(new InputTextItem("This is a test."));

        List<TranslatedTextItem> translations = client.translate(targetLanguages, content, null, from, TextType.PLAIN, null, null, null, false, false, null, null, null, false);

        for (TranslatedTextItem translation : translations) {
            for (Translation textTranslation : translation.getTranslations()) {
                System.out.println("Text was translated to: '" + textTranslation.getTo() + "' and the result is: '" + textTranslation.getText() + "'.");
            }
        }
    }
}

Az alkalmazás létrehozása és futtatása**

Miután hozzáadta a kódmintát az alkalmazáshoz, lépjen vissza a fő projektkönyvtárhoz ( text-translation-app).

1. Hozza létre az alkalmazást a build paranccsal (a BUILD SIKERES üzenetnek kell érkeznie):

   gradle build
   

2. Futtassa az alkalmazást a run paranccsal (sikeres BUILD üzenetet kell kapnia):

   gradle run
   

Íme egy kódrészlet a várt kimenetről:

A Node.js környezet beállítása

Ebben a rövid útmutatóban a Node.js JavaScript futtatókörnyezetet használjuk az alkalmazás létrehozásához és futtatásához.

1. Győződjön meg arról, hogy a Node.jslegújabb verziójával rendelkezik. A Node Package Manager (npm) a Node.js telepítés részeként van mellékelve.

   Jótanács

   Ha még nem ismerkedik a Node.js, próbálja ki a Bevezetés a Node.js Learn modulba.

2. Egy konzolablakban (például parancsmag, PowerShell vagy Bash) hozzon létre és keresse meg az alkalmazás text-translation-appúj könyvtárát.

   mkdir text-translation-app && cd text-translation-app
   

   mkdir text-translation-app; cd text-translation-app
   

3. Futtassa az npm init parancsot az alkalmazás inicializálásához és a projekt létrehozásához.

   npm init
   

4. Adja meg a projekt attribútumait a terminálban megjelenő kérések elfogadásával.

   • A legfontosabb attribútumok a név, a verziószám és a belépési pont.
   • Javasoljuk, hogy tartsa meg index.js a belépési pont nevét. A leírás, a tesztparancs, a GitHub-adattár, a kulcsszavak, a szerző és a licencadatok opcionális attribútumok– ezek kihagyhatók ehhez a projekthez.
   • Fogadja el a javaslatokat a Return vagy az Enter billentyű megnyomásával.
   • A kérések elvégzése után létrejön egy package.json fájl a szövegfordítási-alkalmazás könyvtárában.

Telepítse a klienskönyvtárat

Nyisson meg egy terminálablakot, és telepítse a Azure Text translation JavaScript ügyfélkódtárát a következővel npm:

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

Építse fel alkalmazását

Ahhoz, hogy a Translator az ügyfélkódtár használatával működjön együtt, létre kell hoznia egy példányt az TextTranslationClientosztályból. Ehhez hozzon létre egy TranslateCredential a saját key és <region> az Azure portálon, valamint egy TextTranslationClient példányt. További információ :Translator text sdks.

1. Hozza létre a index.js fájlt az alkalmazáskönyvtárban.

   Jótanács

   • Új fájlt a PowerShell használatával hozhat létre.

   • Nyisson meg egy PowerShell-ablakot a projektkönyvtárban a Shift billentyűt lenyomva tartva kattintson a jobb gombbal a mappára.

   • Adja meg a következő parancsotNew-Item index.js.

   • Létrehozhat egy új fájlt is az IDE-ben, index.js és mentheti a text-translation-app könyvtárba.

2. Másolja és illessze be a következő szövegfordítási kódmintát a index.js fájlba. Frissítse a <your-endpoint> és <your-key> értékeit az Azure portál Fordító példányából.

Kódrészlet

Fontos

Ne felejtse el eltávolítani a kulcsot a kódból, amikor elkészült, és soha ne tegye közzé nyilvánosan. A termelési környezetben használjon biztonságos módszert a hitelesítő adatok tárolására és elérésére, például az Azure Key Vaultot. További információ: Foundry Tools security.

Szöveg lefordítása

Megjegyzés:

Ebben a példában egy regionális végpontot használunk. Ha a globális végpontot használja, olvassa el a Szövegfordítási ügyfél létrehozása című témakört.

const TextTranslationClient = require("@azure-rest/ai-translation-text").default

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";

async function main() {

  console.log("== Text translation sample ==");

  const translateCredential = {
    key: apiKey,
    region,
  };
  const translationClient = new TextTranslationClient(endpoint,translateCredential);

  const inputText = [{ text: "This is a test." }];
  const translateResponse = await translationClient.path("/translate").post({
    body: inputText,
    queryParameters: {
      to: "fr",
      from: "en",
    },
  });

  const translations = translateResponse.body;
  for (const translation of translations) {
    console.log(
      `Text was translated to: '${translation?.translations[0]?.to}' and the result is: '${translation?.translations[0]?.text}'.`
    );
  }
}

main().catch((err) => {
    console.error("An error occurred:", err);
    process.exit(1);
  });

  module.exports = { main };

Az alkalmazás futtatása

Miután hozzáadta a kódmintát az alkalmazáshoz, futtassa a programot:

1. Lépjen arra a mappára, ahol a szövegfordítási alkalmazás (text-translation-app) található.

2. Írja be a következő parancsot a terminálba:

   node index.js
   

Íme egy kódrészlet a várt kimenetről:

A Python-projekt beállítása

1. Győződjön meg arról, hogy a Python 3.x legújabb verziójával rendelkezik. A Python telepítőcsomag (pip) része a Python-telepítésnek.

   Jótanács

   Ha még nem ismerkedik a Pythonnal, próbálja ki a Python Learn bevezetési modulját.

2. Nyisson meg egy terminálablakot, és telepítse a Azure Text translation Python ügyfélkódtárát a következővel pip:

   pip install azure-ai-translation-text==1.0.0b1
   

Építse fel alkalmazását

Ahhoz, hogy a Translator az ügyfélkódtár használatával működjön együtt, létre kell hoznia egy példányt az TextTranslationClientosztályból. Ehhez hozzon létre egy TranslatorCredential-t az Azure portálról a key segítségével, és hozzon létre egy TextTranslationClient példányt. További információ :Translator text sdks.

1. Hozzon létre egy text-translation-app.py nevű új Python-fájlt az előnyben részesített szerkesztőben vagy IDE-ben.

2. Másolja és illessze be a következő szövegfordítási kódmintát a text-translation-app.py fájlba. Frissítse a <your-key>, <your-endpoint>, és <region> elemeket az Azure-portálon lévő Translator-példány értékeivel.

Kódrészlet

Fontos

Ne felejtse el eltávolítani a kulcsot a kódból, amikor elkészült, és soha ne tegye közzé nyilvánosan. A termelési környezetben használjon biztonságos módszert a hitelesítő adatok tárolására és elérésére, például az Azure Key Vaultot. További információ : Foundry Tools security.

Szöveg lefordítása

Megjegyzés:

Ebben a példában egy regionális végpontot használunk. Ha a globális végpontot használja, olvassa el a Szövegfordítási ügyfél létrehozása című témakört.

from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

# set `<your-key>`, `<your-endpoint>`, and  `<region>` variables with the values from the Azure portal
key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"

credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

try:
    source_language = "en"
    target_languages = ["es", "it"]
    input_text_elements = [ InputTextItem(text = "This is a test") ]

    response = text_translator.translate(content = input_text_elements, to = target_languages, from_parameter = source_language)
    translation = response[0] if response else None

    if translation:
        for translated_text in translation.translations:
            print(f"Text was translated to: '{translated_text.to}' and the result is: '{translated_text.text}'.")

except HttpResponseError as exception:
    print(f"Error Code: {exception.error.code}")
    print(f"Message: {exception.error.message}")

Az alkalmazás futtatása

Miután hozzáadta a kódmintát az alkalmazáshoz, hozza létre és futtassa a programot:

Lépjen arra a mappára, ahol a text-translation-app.py fájl található.

Írja be a következő parancsot a terminálba:

python text-translation-app.py

Íme egy kódrészlet a várt kimenetről:

Ennyi, gratulálok! Ebben a rövid útmutatóban szövegfordítási SDK-val fordította le a szöveget.

Következő lépések

További információ a szövegfordítás fejlesztési lehetőségeiről:

A szövegfordításIDK áttekintése

Szövegfordítás V3-referencia