Snabbstart: Azure AI Translator-klientbibliotek för text

Konfigurera din C#/.NET-miljö

I den här snabbstarten använder vi den senaste versionen av Visual Studio IDE för att skapa och köra programmet.

1. Starta Visual Studio.

2. På sidan Kom igång väljer du Skapa ett nytt projekt.

   

3. På sidan Skapa ett nytt projekt anger du konsolen i sökrutan. Välj mallen Konsolprogram och välj sedan Nästa.

   

4. I dialogrutan Konfigurera det nya projektet anger du text-translation-sdk i rutan Projektnamn. Välj sedan Nästa.

   

5. I dialogrutan Ytterligare information väljer du .NET 6.0 (långsiktigt stöd)och väljer sedan Skapa.

   

Installera klientbiblioteket med NuGet

1. Högerklicka på ditt Translator-text-sdk-projekt och välj Manage NuGet Packages...

2. Markera fliken Browse och kryssrutan Include prerelease och skriv Azure.AI.Translation.Text.

   Skärmbild av det valda `prerelease` NuGet-paketet i Visual Studio.

3. Välj version 1.0.0-beta.1 från den nedrullningsbara menyn och installera paketet i projektet.

   

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. Det gör du genom att skapa en AzureKeyCredential med din key från Azure-portalen och en TextTranslationClient instans med AzureKeyCredential. Autentiseringen varierar något beroende på om resursen använder den regionala eller globala slutpunkten. För det här projektet autentiserar du med hjälp av den globala slutpunkten. Mer information om hur du använder en regional slutpunkt finns iTranslator text sdks.

1. Öppna filen Program.cs .

2. Ta bort den befintliga koden, inklusive raden Console.WriteLine("Hello World!"), och ange följande kodexempel i programmets Program.cs-fil:

Kodexempel

Översätta text

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}");
}

Kör ditt program

När du har lagt till kodexemplet i programmet väljer du den gröna Start-knappen bredvid formRecognizer_quickstart för att skapa och köra programmet, eller tryck på F5.

Här är ett kodfragment av förväntade utdata:

Konfigurera din Java-miljö

I den här snabbstarten använder vi verktyget Gradle build automation för att skapa och köra programmet.

• Du bör ha den senaste versionen av Visual Studio Code eller önskad IDE. SeJava i Visual Studio Code.

  Tips/Råd

  • Visual Studio Code erbjuder ett kodningspaket för Java för Windows och macOS. Kodningspaketet är ett paket med VS Code, Java Development Kit (JDK) och en samling föreslagna tillägg från Microsoft. Kodningspaketet kan också användas för att åtgärda en befintlig utvecklingsmiljö.
  • Om du använder VS Code och kodningspaketet för Java installerar du tillägget Gradle for Java .

• Om du inte använder Visual Studio Code kontrollerar du att följande är installerat i utvecklingsmiljön:

  • En Java Development Kit (OpenJDK) version 8 eller senare.

  • Gradle, version 6.8 eller senare.

Skapa ett nytt Gradle-projekt

1. I konsolfönstret (till exempel cmd, PowerShell eller Bash) skapar du en ny katalog för din app med namnet textöversättningsapp och navigerar till den.

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

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

2. gradle init Kör kommandot från katalogen text-translation-app. Det här kommandot skapar viktiga byggfiler för Gradle, inklusive build.gradle.kts, som används vid körning för att skapa och konfigurera ditt program.

   gradle init --type basic
   

3. När du uppmanas att välja en DSL väljer du Kotlin.

4. Acceptera standardprojektets namn (textöversättningsapp) genom att välja Retur eller Retur.

   Anmärkning

   Det kan ta några minuter innan hela programmet skapas, men snart bör du se flera mappar och filer, inklusive build-gradle.kts.

5. Uppdatera build.gradle.kts med följande kod. Huvudklassen är Translate:

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

Skapa ditt Java-program

1. Kör följande kommando från katalogen textöversättningsapp:

   mkdir -p src/main/java
   

   Kommandot skapar följande katalogstruktur:

   

2. Navigera till java katalogen och skapa en fil med namnet Translate.java.

   Tips/Råd

   • Du kan skapa en ny fil med hjälp av PowerShell.

   • Öppna ett PowerShell-fönster i projektkatalogen genom att hålla ned Skift-tangenten och högerklicka på mappen.

   • Ange följande kommando New-Item Translate.java.

   • Du kan också skapa en ny fil i din IDE med namnet Translate.java och spara den i java katalogen.

3. Kopiera och klistra in följande textöversättningskodexempel i din Translate.java-fil .

   • Uppdatera "<your-key>", "<your-endpoint>" och "<region>" med värden från din Azure-portalöversättningsinstans.

Kodexempel

Översätta text

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. Det gör du genom att skapa en AzureKeyCredential med din key från Azure-portalen och en TextTranslationClient instans med AzureKeyCredential. Autentiseringen varierar något beroende på om resursen använder den regionala eller globala slutpunkten. För det här projektet autentiserar du med hjälp av den globala slutpunkten. Mer information om hur du använder en regional slutpunkt finns iTranslator text sdks.

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() + "'.");
            }
        }
    }
}

Skapa och kör programmet**

När du har lagt till kodexemplet i programmet går du tillbaka till huvudprojektkatalogen – textöversättningsapp.

1. Skapa ditt program med build kommandot (du bör få ett BUILD SUCCESSFUL-meddelande ):

   gradle build
   

2. Kör programmet med run kommandot (du bör få ett BUILD SUCCESSFUL-meddelande ):

   gradle run
   

Här är ett kodfragment av förväntade utdata:

Konfigurera din Node.js miljö

I den här snabbstarten använder vi Node.js JavaScript-körningsmiljön för att skapa och köra programmet.

1. Kontrollera att du har den senaste versionen av Node.js. Node Package Manager (npm) ingår i installationen av Node.js.

   Tips/Råd

   Om du inte har Node.js kan du prova modulen Introduktion till Node.js Learn.

2. I ett konsolfönster (till exempel cmd, PowerShell eller Bash) skapar och navigerar du till en ny katalog för din app med namnet text-translation-app.

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

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

3. Kör kommandot npm init för att initiera applikationen och skapa stommen för ditt projekt.

   npm init
   

4. Ange projektets attribut genom att acceptera de prompter som visas i terminalen.

   • De viktigaste attributen är namn, versionsnummer och startpunkt.
   • Vi rekommenderar att du behåller namnet index.js för startpunkten. Beskrivningen, testkommandot, GitHub-lagringsplatsen, nyckelord, författare och licensinformation är valfria attribut – de kan hoppas över för det här projektet.
   • Acceptera förslagen inom parenteser genom att välja Retur eller Retur.
   • När du har slutfört anvisningarna skapas en package.json fil i katalogen textöversättningsapp.

Installera klientbiblioteket

Öppna ett terminalfönster och installera Azure Text translation klientbiblioteket för JavaScript med npm:

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

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. För att göra det skapar du en TranslateCredential med din key och <region> från Azure-portalen och en TextTranslationClient instans. Mer information finns iTranslator text sdks.

1. index.js Skapa filen i appkatalogen.

   Tips/Råd

   • Du kan skapa en ny fil med hjälp av PowerShell.

   • Öppna ett PowerShell-fönster i projektkatalogen genom att hålla ned Skift-tangenten och högerklicka på mappen.

   • Ange följande kommando New-Item index.js.

   • Du kan också skapa en ny fil med namnet index.js i din IDE och spara den i text-translation-app katalogen.

2. Kopiera och klistra in följande textöversättningskodexempel i index.js filen. Uppdatera <your-endpoint> och <your-key> med värden från Azure Portal Translator-instansen.

Kodexempel

Översätta text

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 };

Kör ditt program

När du har lagt till kodexemplet i programmet kör du programmet:

1. Navigera till mappen där du har ditt textöversättningsprogram (textöversättningsapp).

2. Skriv följande kommando i terminalen:

   node index.js
   

Här är ett kodfragment av förväntade utdata:

Konfigurera ditt Python-projekt

1. Kontrollera att du har den senaste versionen av Python 3.x. Python Installer-paketet (pip) ingår i Python-installationen.

   Tips/Råd

   Om du inte har använt Python tidigare kan du prova modulen Introduktion till Python Learn.

2. Öppna ett terminalfönster och installera Azure Text translation klientbiblioteket för Python med pip:

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

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. Det gör du genom att skapa en TranslatorCredential med din key från Azure-portalen och en TextTranslationClient instans. Mer information finns iTranslator text sdks.

1. Skapa en ny Python-fil med namnet text-translation-app.py i önskad redigerare eller IDE.

2. Kopiera och klistra in följande kodexempel för textöversättning i text-translation-app.py-filen . Uppdatera <your-key>, <your-endpoint>, och <region> med värden från din Azure portal Translator-instans.

Kodexempel

Översätta text

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}")

Starta programmet

När du har lagt till kodexemplet i ditt program skapar och kör du programmet:

Gå till den mapp där du har din text-translation-app.py-fil .

Skriv följande kommando i terminalen:

python text-translation-app.py

Här är ett kodfragment av förväntade utdata: