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

Artykuł
2025-04-03

W tym wprowadzeniu do szybkiego startu zacznij korzystać z usługi Translator, aby tłumaczyć tekst przy użyciu wybranego przez siebie języka programowania. W tym projekcie zalecamy korzystanie z darmowego planu cenowego (F0) na czas nauki tej technologii, a następnie przejście na płatny plan 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 szybkim starcie używamy najnowszej wersji środowiska Visual Studio IDE do budowania i uruchamiania 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.
. 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 oraz pole wyboru Uwzględnij wersję wstępną; 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 AzureKeyCredential za pomocą portalu key Azure i instancję TextTranslationClient za pomocą 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, zobaczZestawy SDK usługi Translator do tekstu.

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ść metody Main. Nie ma potrzeby dołączania 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ładowy kod

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 wyniku.

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. ZobaczJava w programie Visual Studio Code.
Wskazówka
- 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
```
Uruchom polecenie gradle init 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 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.
Wskazówka
- 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 elementy "<your-key>", "<your-endpoint>" i "<region>" korzystając z wartości wystąpienia usługi Translator w Azure Portal.

Przykładowy kod

Tłumaczenie tekstu

Ważne

Aby używać usługi Translator za pomocą biblioteki klienta, należy utworzyć instancję klasy TextTranslationClient. W tym celu utwórz element AzureKeyCredential za pomocą portalu key Azure i instancję TextTranslationClient za pomocą 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, zobaczzestawy SDK tłumacza tekstów.

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 wyniku.

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

Konfigurowanie środowiska Node.js

W tym przewodniku szybkiego startu używamy środowiska uruchomieniowego Node.js JavaScript, aby utworzyć i uruchomić aplikację.

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.

Wskazówka

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 nazwy index.js dla 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, plik package.json 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 klasy TextTranslationClient. W tym celu utwórz element TranslateCredential z użyciem key i <region> z portalu Azure oraz wystąpienia TextTranslationClient. Aby uzyskać więcej informacji, zobaczZestawy SDK tekstu Translator.

index.js Utwórz plik w katalogu aplikacji.
Wskazówka
- 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> i <your-key> za pomocą wartości z wystąpienia usługi Translator w portalu Azure.

Przykładowy kod

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 wyniku.

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.

Wskazówka

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 Translatora za pomocą biblioteki klienta, należy utworzyć wystąpienie TextTranslationClientklasy. W tym celu utwórz element TranslatorCredential z pomocą Portalu Azure oraz instancję TextTranslationClient. Aby uzyskać więcej informacji, zobaczZestawy SDK usługi Translator tekstu.

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>, <your-endpoint> i <region> wartościami z Twojego wystąpienia usługi Translator w portalu Azure.

Przykładowy kod

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 wyjścia:

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

To wszystko, gratulacje! W tym przewodniku szybkiego startu użyto SDK 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 tłumaczenia tekstu wersja 3

Udostępnij za pośrednictwem

Szybki start: biblioteki klienckie do 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ładowy kod

Uruchamianie aplikacji

Konfigurowanie środowiska Java

Tworzenie nowego projektu narzędzia Gradle

Tworzenie aplikacji Java

Przykładowy kod

Kompilowanie i uruchamianie aplikacji**

Konfigurowanie środowiska Node.js

Instalowanie biblioteki klienta

Kompilowanie aplikacji

Przykładowy kod

Uruchamianie aplikacji

Konfigurowanie projektu w języku Python

Kompilowanie aplikacji

Przykładowy kod

Uruchamianie aplikacji

Następne kroki

Opinia

Dodatkowe zasoby