Szybki start: biblioteki klienckie tłumaczenia tekstu w usłudze Azure AI Translator

Artykuł
09/26/2024

W tym przewodniku Szybki start zacznij używać usługi Translator do tłumaczenia tekstu przy użyciu wybranego języka programowania. W tym projekcie zalecamy korzystanie z warstwy cenowej Bezpłatna (F0), podczas nauki technologii, a następnie uaktualniania do warstwy płatnej dla środowiska produkcyjnego.

Wymagania wstępne

Potrzebna jest aktywna subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, możesz go utworzyć bezpłatnie

Po utworzeniu subskrypcji platformy Azure utwórz zasób usługi Translator w witrynie Azure Portal.
Po wdrożeniu zasobu wybierz pozycję Przejdź do zasobu i pobierz klucz i punkt końcowy.
- Pobierz klucz, punkt końcowy i region z zasobu i połącz aplikację z usługą Translator. Wklej te wartości do kodu w dalszej części przewodnika Szybki start. Można je znaleźć na stronie Klucze i punkt końcowy witryny Azure Portal:

Konfigurowanie środowiska C#/.NET

W tym przewodniku Szybki start użyjemy najnowszej wersji środowiska IDE programu Visual Studio do skompilowania i uruchomienia aplikacji.

Uruchom program Visual Studio.
Na stronie Wprowadzenie wybierz pozycję Utwórz nowy projekt.
Na stronie Tworzenie nowego projektu wprowadź konsolę w polu wyszukiwania. Wybierz szablon Aplikacja konsolowa, a następnie wybierz pozycję Dalej.
W oknie dialogowym Konfigurowanie nowego projektu wprowadź text-translation-sdk w polu Nazwa projektu. Następnie wybierz pozycję Dalej.
W oknie dialogowym Dodatkowe informacje wybierz pozycję .NET 6.0 (obsługa długoterminowa), a następnie wybierz pozycję Utwórz.

Instalowanie biblioteki klienta za pomocą narzędzia NuGet

Kliknij prawym przyciskiem myszy projekt translator-text-sdk i wybierz polecenie Zarządzaj pakietami NuGet...
Zaznacz kartę Przeglądaj i pole wyboru Uwzględnij wersję wstępną i wpisz Azure.AI.Translation.Text.
Wybierz wersję 1.0.0-beta.1 z menu rozwijanego i zainstaluj pakiet w projekcie.

Kompilowanie aplikacji

Aby korzystać z usługi Translator przy użyciu biblioteki klienta, należy utworzyć wystąpienie TextTranslationClientklasy. W tym celu utwórz element AzureKeyCredential za pomocą witryny key Azure Portal i TextTranslationClient wystąpienia za pomocą polecenia AzureKeyCredential. Uwierzytelnianie różni się nieznacznie w zależności od tego, czy zasób korzysta z regionalnego lub globalnego punktu końcowego. W tym projekcie uwierzytelnij się przy użyciu globalnego punktu końcowego. Aby uzyskać więcej informacji na temat korzystania z regionalnego punktu końcowego, zobacz Zestawy SDK tekstu w usłudze Translator.

Uwaga

Począwszy od platformy .NET 6, nowe projekty korzystające z console szablonu generują nowy styl programu, który różni się od poprzednich wersji.
Nowe dane wyjściowe korzystają z ostatnich funkcji języka C#, które upraszczają pisanie kodu.
W przypadku korzystania z nowszej wersji wystarczy napisać treść Main metody. Nie trzeba dołączać instrukcji najwyższego poziomu, globalnych dyrektyw using ani niejawnych dyrektyw using.
Aby uzyskać więcej informacji, zobacz Nowe szablony języka C# generują instrukcje najwyższego poziomu.

Otwórz plik Program.cs.
Usuń istniejący kod, w tym wiersz Console.WriteLine("Hello World!"), i wprowadź następujący przykładowy kod do pliku Program.cs aplikacji:

Przykład kodu

Ważne

Pamiętaj, aby usunąć klucz z kodu po zakończeniu i nigdy nie publikować go publicznie. W przypadku środowiska produkcyjnego użyj bezpiecznego sposobu przechowywania i uzyskiwania dostępu do poświadczeń, takich jak usługa Azure Key Vault. Aby uzyskać więcej informacji, zobacz Zabezpieczenia usług Azure AI.

Tłumaczenie tekstu

Uwaga

W tym przykładzie używamy globalnego punktu końcowego. Jeśli używasz regionalnego punktu końcowego, zobacz Tworzenie klienta tłumaczenia tekstu.


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

Uruchamianie aplikacji

Po dodaniu przykładowego kodu do aplikacji wybierz zielony przycisk Start obok formRecognizer_quickstart, aby skompilować i uruchomić program, lub naciśnij F5.

Zrzut ekranu: uruchom program Visual Studio.

Oto fragment oczekiwanego danych wyjściowych:

Zrzut ekranu przedstawiający dane wyjściowe programu Visual Studio Code w oknie terminalu.

Konfigurowanie środowiska Java

Uwaga

Zestaw SDK tłumaczenia tekstu platformy Azure dla języka Java jest testowany i obsługiwany na platformach Windows, Linux i macOS. Nie jest testowany na innych platformach i nie obsługuje wdrożeń systemu Android.

W tym przewodniku Szybki start użyjemy narzędzia automatyzacji kompilacji narzędzia Gradle do tworzenia i uruchamiania aplikacji.

Musisz mieć najnowszą wersję programu Visual Studio Code lub preferowanego środowiska IDE. Zobacz Java w programie Visual Studio Code.
Napiwek
- Program Visual Studio Code oferuje pakiet kodowania dla języka Java dla systemów Windows i macOS. Pakiet kodowania jest pakietem programu VS Code, zestawem Java Development Kit (JDK) i kolekcją sugerowanych rozszerzeń firmy Microsoft. Pakiet kodowania może również służyć do naprawiania istniejącego środowiska programistycznego.
- Jeśli używasz programu VS Code i pakietu programistycznego dla języka Java, zainstaluj rozszerzenie Gradle for Java .
Jeśli nie używasz programu Visual Studio Code, upewnij się, że w środowisku projektowym zainstalowano następujące elementy:
- Zestaw Java Development Kit (OpenJDK) w wersji 8 lub nowszej.
- Gradle, wersja 6.8 lub nowsza.

Tworzenie nowego projektu narzędzia Gradle

W oknie konsoli (takim jak cmd, PowerShell lub Bash) utwórz nowy katalog dla aplikacji o nazwie text-translation-app i przejdź do niego.
```
mkdir text-translation-app && text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
gradle init Uruchom polecenie z katalogu text-translation-app. To polecenie tworzy podstawowe pliki kompilacji dla narzędzia Gradle, w tym build.gradle.kts, które są używane w czasie wykonywania do tworzenia i konfigurowania aplikacji.
```
gradle init --type basic
```
Po wyświetleniu monitu wybierz pozycję Język DSL, a następnie Kotlin.
Zaakceptuj domyślną nazwę projektu (text-translation-app), wybierając pozycję Return lub Enter.

Uwaga

Utworzenie całej aplikacji może potrwać kilka minut, ale wkrótce powinno zostać wyświetlonych kilka folderów i plików, w tym build-gradle.kts.

Zaktualizuj build.gradle.kts za pomocą następującego kodu. Klasa główna to Translate:

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

Tworzenie aplikacji Java

W katalogu text-translation-app uruchom następujące polecenie:
```
mkdir -p src/main/java
```
Polecenie tworzy następującą strukturę katalogów:
Przejdź do java katalogu i utwórz plik o nazwie Translate.java.
Napiwek
- Nowy plik można utworzyć przy użyciu programu PowerShell.
- Otwórz okno programu PowerShell w katalogu projektu, trzymając wciśnięty Shift i klikając folder prawym przyciskiem myszy.
- Wprowadź następujące polecenie New-Item Translate.java.
- Możesz również utworzyć nowy plik w środowisku IDE o nazwie Translate.java i zapisać go w java katalogu.
Skopiuj i wklej następujący przykładowy kod tłumaczenia tekstu do pliku Translate.java .
- Zaktualizuj "<your-key>"element i "<region>" przy użyciu wartości z wystąpienia usługi Translator w witrynie Azure "<your-endpoint>" Portal.

Przykład kodu

Tłumaczenie tekstu

Ważne

Uwaga

W tym przykładzie używamy globalnego punktu końcowego. Jeśli używasz regionalnego punktu końcowego, zobacz Tworzenie klienta tłumaczenia tekstu.

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

Kompilowanie i uruchamianie aplikacji**

Po dodaniu przykładowego kodu do aplikacji przejdź z powrotem do głównego katalogu projektu — text-translation-app.

Skompiluj aplikację za build pomocą polecenia (powinien zostać wyświetlony komunikat BUILD SUCCESSFUL ):
```
gradle build
```
Uruchom aplikację za run pomocą polecenia (powinien zostać wyświetlony komunikat BUILD SUCCESSFUL ):
```
gradle run
```

Oto fragment oczekiwanego danych wyjściowych:

Zrzut ekranu przedstawiający dane wyjściowe języka Java w oknie terminalu.

Konfigurowanie środowiska Node.js

W tym przewodniku Szybki start użyjemy środowiska uruchomieniowego Node.js JavaScript do utworzenia i uruchomienia aplikacji.

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję Node.js. Program Node Menedżer pakietów (npm) jest dołączony do instalacji Node.js.

Napiwek

Jeśli dopiero zaczynasz Node.js, wypróbuj moduł Wprowadzenie do Node.js Learn.
W oknie konsoli (takim jak cmd, PowerShell lub Bash) utwórz i przejdź do nowego katalogu aplikacji o nazwie text-translation-app.
```
mkdir text-translation-app && cd text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
Uruchom polecenie npm init, aby zainicjować aplikację i szkielet projektu.
```
npm init
```
Określ atrybuty projektu, akceptując monity wyświetlane w terminalu.
- Najważniejsze atrybuty to nazwa, numer wersji i punkt wejścia.
- Zalecamy zachowanie index.js nazwy punktu wejścia. Opis, polecenie testowe, repozytorium GitHub, słowa kluczowe, autor i informacje o licencji są atrybutami opcjonalnymi — można je pominąć dla tego projektu.
- Zaakceptuj sugestie w nawiasach, wybierając pozycję Return lub Enter.
- Po zakończeniu monitów package.json plik zostanie utworzony w katalogu text-translation-app.

Instalowanie biblioteki klienta

Otwórz okno terminalu i zainstaluj bibliotekę Azure Text Translation klienta dla języka JavaScript za pomocą polecenia npm:

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

Kompilowanie aplikacji

Aby korzystać z usługi Translator przy użyciu biblioteki klienta, należy utworzyć wystąpienie TextTranslationClientklasy. W tym celu utwórz element TranslateCredential za pomocą polecenia key i <region> z witryny Azure Portal i TextTranslationClient wystąpienia. Aby uzyskać więcej informacji, zobacz Zestawy SDK tekstu w usłudze Translator.

index.js Utwórz plik w katalogu aplikacji.
Napiwek
- Nowy plik można utworzyć przy użyciu programu PowerShell.
- Otwórz okno programu PowerShell w katalogu projektu, trzymając wciśnięty Shift i klikając folder prawym przyciskiem myszy.
- Wprowadź następujące polecenie New-Item index.js.
- Możesz również utworzyć nowy plik o nazwie index.js w środowisku IDE i zapisać go w text-translation-app katalogu.
Skopiuj i wklej następujący przykładowy kod tłumaczenia tekstu do pliku index.js . Zaktualizuj <your-endpoint> wartości i <your-key> za pomocą wartości z wystąpienia usługi Translator w witrynie Azure Portal.

Przykład kodu

Ważne

Tłumaczenie tekstu

Uwaga

W tym przykładzie używamy regionalnego punktu końcowego. Jeśli używasz globalnego punktu końcowego, zobacz Tworzenie klienta tłumaczenia tekstu.

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

Uruchamianie aplikacji

Po dodaniu przykładowego kodu do aplikacji uruchom program:

Przejdź do folderu, w którym masz aplikację tłumaczenia tekstu (text-translation-app).
Wpisz następujące polecenie w terminalu:
```
node index.js
```

Oto fragment oczekiwanego danych wyjściowych:

Zrzut ekranu przedstawiający dane wyjściowe języka JavaScript w oknie terminalu.

Konfigurowanie projektu w języku Python

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję środowiska Python 3.x. Pakiet instalatora języka Python () jest dołączony do instalacji języka Python.

Napiwek

Jeśli dopiero zaczynasz korzystać z języka Python, wypróbuj moduł Wprowadzenie do języka Python Learn.
Otwórz okno terminalu i zainstaluj bibliotekę Azure Text Translation klienta dla języka Python za pomocą polecenia pip:
```
pip install azure-ai-translation-text==1.0.0b1
```

Kompilowanie aplikacji

Aby korzystać z usługi Translator przy użyciu biblioteki klienta, należy utworzyć wystąpienie TextTranslationClientklasy. W tym celu utwórz element TranslatorCredential za pomocą witryny key Azure Portal i TextTranslationClient wystąpienia. Aby uzyskać więcej informacji, zobacz Zestawy SDK tekstu w usłudze Translator.

Utwórz nowy plik języka Python o nazwie text-translation-app.py w preferowanym edytorze lub środowisku IDE.
Skopiuj i wklej następujący przykładowy kod tłumaczenia tekstu do pliku text-translation-app.py . Zaktualizuj <your-key>wartości , <your-endpoint>i <region> przy użyciu wartości z wystąpienia usługi Translator w witrynie Azure Portal.

Przykład kodu

Ważne

Tłumaczenie tekstu

Uwaga

W tym przykładzie używamy regionalnego punktu końcowego. Jeśli używasz globalnego punktu końcowego, zobacz Tworzenie klienta tłumaczenia tekstu.

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

Uruchamianie aplikacji

Po dodaniu przykładowego kodu do aplikacji skompiluj i uruchom program:

Przejdź do folderu, w którym masz plik text-translation-app.py .

Wpisz następujące polecenie w terminalu:

python text-translation-app.py

Oto fragment oczekiwanego danych wyjściowych:

Zrzut ekranu przedstawiający dane wyjściowe języka JavaScript w oknie terminalu.

To wszystko, gratulacje! W tym przewodniku Szybki start użyto zestawu SDK tłumaczenia tekstu do tłumaczenia tekstu.

Następne kroki

Dowiedz się więcej o opcjach programowania tłumaczenia tekstu:

Omówienie

zestawu SDK tłumaczenia tekstu — dokumentacja dotycząca tłumaczenia tekstu w wersji 3

Udostępnij za pośrednictwem

Szybki start: biblioteki klienckie tłumaczenia tekstu w usłudze Azure AI Translator

Wymagania wstępne

Konfigurowanie środowiska C#/.NET

Instalowanie biblioteki klienta za pomocą narzędzia NuGet

Kompilowanie aplikacji

Przykład kodu

Uruchamianie aplikacji

Konfigurowanie środowiska Java

Tworzenie nowego projektu narzędzia Gradle

Tworzenie aplikacji Java

Przykład kodu

Kompilowanie i uruchamianie aplikacji**

Konfigurowanie środowiska Node.js

Instalowanie biblioteki klienta

Kompilowanie aplikacji

Przykład kodu

Uruchamianie aplikacji

Konfigurowanie projektu w języku Python

Kompilowanie aplikacji

Przykład kodu

Uruchamianie aplikacji

Następne kroki

Opinia

Dodatkowe zasoby