Rövid útmutató: Az Azure AI Translator szöveges ügyfélkódtárai

Ebben a rövid útmutatóban ismerkedjen meg a Translator szolgáltatással 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, miközben elsajátítja a technológiát, és később egy fizetős szintre frissít éles környezetben.

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 Translator szolgáltatáshoz. 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 NuGet-csomagok kezelése...

2. Jelölje be a Tallózás lap és a Belefoglalás előzetes verzió jelölőnégyzetet, és írja be az Azure.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.

   

Az alkalmazás összeállítása

Ahhoz, hogy a Translator szolgáltatást az ügyfélkódtár használatával használhassa, létre kell hoznia az osztály egy példányát TextTranslationClient. Ehhez hozzon létre egy példányt AzureKeyCredential key az Azure Portalról és egy TextTranslationClient példányt a AzureKeyCredential. 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.

Feljegyzé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 metódus törzsét Main kell megírnia. Nem kell felső szintű utasításokat, globális irányelveket vagy implicit irányelveket használnia.
• További információ: Új C#-sablonok legfelső szintű utasítások létrehozása.

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

2. Törölje a már 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ódminta

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. Éles környezetben biztonságos módon tárolhatja és érheti el a hitelesítő adatait, például az Azure Key Vaultot. További információ: Azure AI-szolgáltatások biztonsága.

Szöveg lefordítása

Feljegyzé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

Feljegyzés

A Java-hoz készült Azure Text Translation SDK tesztelése és támogatása Windows, Linux és macOS platformokon történik. 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 a Java-t a Visual Studio Code-ban.

  Tipp.

  • 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 a VS Code-ot és a Java kódolási csomagját használja, 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.

   Feljegyzé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

   Tipp.

   • Ú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ő parancsot : New-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 "<your-key>"az "<your-endpoint>" "<region>" Azure Portal Translator-példány értékeit.

Kódminta

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. Éles környezetben biztonságos módon tárolhatja és érheti el a hitelesítő adatait, például az Azure Key Vaultot. További információ: Azure AI-szolgáltatások biztonsága.

Ahhoz, hogy a Translator szolgáltatást az ügyfélkódtár használatával használhassa, létre kell hoznia az osztály egy példányát TextTranslationClient. Ehhez hozzon létre egy példányt AzureKeyCredential key az Azure Portalról és egy TextTranslationClient példányt a AzureKeyCredential. 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.

Feljegyzé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. Ha még nem tette meg, telepítse a Node.js legújabb verzióját. A csomópont Csomagkezelő (npm) része a Node.js telepítésének.

   Tipp.

   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 zárójelben a Return vagy az Enter billentyűkombinációval.
   • Miután befejezte az utasításokat, létrejön egy package.json fájl a szövegfordítási-alkalmazás könyvtárában.

Telepítse az ügyfélkódtá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

Az alkalmazás összeállítása

Ahhoz, hogy a Translator szolgáltatást az ügyfélkódtár használatával használhassa, létre kell hoznia az osztály egy példányát TextTranslationClient. Ehhez hozzon létre egy TranslateCredential key saját és <region> az Azure Portalról származó példányt TextTranslationClient . További információ: Translator text sdks.

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

   Tipp.

   • Ú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ő parancsot : New-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 <your-endpoint> és <your-key> használja az Azure Portal Translator-példány értékeit.

Kódminta

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. Éles környezetben biztonságos módon tárolhatja és érheti el a hitelesítő adatait, például az Azure Key Vaultot. További információ: Azure AI-szolgáltatások biztonsága.

Szöveg lefordítása

Feljegyzé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. Ha még nem tette meg, telepítse a Python 3.x legújabb verzióját. A Python telepítőcsomag (pip) része a Python-telepítésnek.

   Tipp.

   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
   

Az alkalmazás összeállítása

Ahhoz, hogy a Translator szolgáltatást az ügyfélkódtár használatával használhassa, létre kell hoznia az osztály egy példányát TextTranslationClient. Ehhez hozzon létre egy példányt TranslatorCredential key az Azure Portalról és egy TextTranslationClient példányból. 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 <your-key>és <your-endpoint><region> használja az Azure Portal Translator-példány értékeit.

Kódminta

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. Éles környezetben biztonságos módon tárolhatja és érheti el a hitelesítő adatait, például az Azure Key Vaultot. További információ: Azure AI-szolgáltatások biztonsága.

Szöveg lefordítása

Feljegyzé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:

Text Translation SDK – áttekintés

Szövegfordítás V3-referencia