Sdílet prostřednictvím


Rychlý start: Klientské knihovny azure AI Translator text

V tomto rychlém startu začněte používat službu Translator k překladu textu pomocí programovacího jazyka podle vašeho výběru. Pro tento projekt doporučujeme použít cenovou úroveň Free (F0), zatímco se učíte technologii a později upgradujete na placenou úroveň pro produkční prostředí.

Požadavky

Potřebujete aktivní předplatné Azure. Pokud nemáte předplatné Azure, můžete si ho zdarma vytvořit.

  • Jakmile budete mít předplatné Azure, vytvořte prostředek Translatoru na webu Azure Portal.

  • Po nasazení prostředku vyberte Přejít k prostředku a načtěte svůj klíč a koncový bod.

    • Získejte klíč, koncový bod a oblast z prostředku a připojte aplikaci ke službě Translator. Tyto hodnoty vložte do kódu později v rychlém startu. Najdete je na stránce Klíče webu Azure Portal a koncový bod :

      Snímek obrazovky: Klíče webu Azure Portal a stránka koncového bodu

Nastavení prostředí C#/.NET

Pro účely tohoto rychlého startu používáme nejnovější verzi integrovaného vývojového prostředí sady Visual Studio k sestavení a spuštění aplikace.

  1. Spusťte Visual Studio.

  2. Na stránce Začínáme zvolte Vytvořit nový projekt.

    Snímek obrazovky s oknem Začínáme sady Visual Studio 2022

  3. Na stránce Vytvořit nový projekt zadejte konzolu do vyhledávacího pole. Zvolte šablonu konzolové aplikace a pak zvolte Další.

    Snímek obrazovky se stránkou vytvoření nového projektu v sadě Visual Studio 2022

  4. V dialogovém okně Konfigurovat nový projekt zadejte text-translation-sdk do pole Název projektu. Pak zvolte Další.

    Snímek obrazovky sady Visual Studio 2022 s oknem konfigurace nového nastavení projektu

  5. V dialogovém okně Další informace vyberte .NET 6.0 (dlouhodobá podpora) a pak vyberte Vytvořit.

    Snímek obrazovky s oknem nastavení dalších informací sady Visual Studio 2022

Instalace klientské knihovny pomocí NuGetu

  1. Klikněte pravým tlačítkem na projekt translator-text-sdk a vyberte Spravovat balíčky NuGet...Snímek obrazovky s oknem vybraného balíčku NuGet v sadě Visual Studio

  2. Vyberte kartu Procházet a zaškrtněte políčko Zahrnout předběžné verze a zadejte Azure.AI.Translation.Text.

    Snímek obrazovky s výběrem předběžné verze balíčku NuGet v sadě Visual Studio

  3. V rozevírací nabídce vyberte verzi 1.0.0-beta.1 a nainstalujte balíček do projektu.

    Snímek obrazovky s instalací předběžné verze balíčku NuGet v sadě Visual Studio

Sestavení aplikace

Pokud chcete pracovat se službou Translator pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že vytvoříte pomocí AzureKeyCredential key webu Azure Portal a TextTranslationClient instance s nástrojem AzureKeyCredential. Ověřování se mírně liší v závislosti na tom, jestli váš prostředek používá regionální nebo globální koncový bod. Pro tento projekt se ověřte pomocí globálního koncového bodu. Další informace o použití regionálního koncového bodu najdete v tématu Translator Text SDK.

Poznámka:

  • Od .NET 6 vygenerují nové projekty používající console šablonu nový styl programu, který se liší od předchozích verzí.
  • Nový výstup používá nedávné funkce jazyka C#, které zjednodušují psaní kódu.
  • Pokud používáte novější verzi, stačí napsat pouze tělo Main metody. Nemusíte zahrnovat příkazy nejvyšší úrovně, globální direktivy using ani implicitní direktivy using.
  • Další informace najdete v tématu Nové šablony jazyka C#, které generují příkazy nejvyšší úrovně.
  1. Otevřete soubor Program.cs.

  2. Odstraňte existující kód, včetně řádku Console.WriteLine("Hello World!"), a do souboru Program.cs vaší aplikace zadejte následující vzorový kód:

Ukázka kódu

Důležité

Nezapomeňte klíč z kódu odebrat, až to budete hotovi, a nikdy ho veřejně neposílejte. V produkčním prostředí použijte bezpečný způsob ukládání přihlašovacích údajů a přístupu k vašim přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v tématu Zabezpečení služeb Azure AI.

Překlad textu

Poznámka:

V tomto příkladu používáme globální koncový bod. Pokud používáte regionální koncový bod, přečtěte si téma Vytvoření klienta překladu textu.


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

Spusťte aplikaci

Po přidání ukázky kódu do aplikace zvolte zelené tlačítko Start vedle formRecognizer_quickstart a sestavte a spusťte program, nebo stiskněte klávesu F5.

Snímek obrazovky: Spusťte program sady Visual Studio.

Tady je fragment očekávaného výstupu:

Snímek obrazovky s výstupem editoru Visual Studio Code v okně terminálu

Nastavení prostředí Java

Poznámka:

Sada Azure Text Translation SDK pro Javu se testuje a podporuje na platformách Windows, Linux a macOS. Není testován na jiných platformách a nepodporuje nasazení Androidu.

Pro účely tohoto rychlého startu použijeme nástroj pro automatizaci sestavení Gradle k vytvoření a spuštění aplikace.

  • Měli byste mít nejnovější verzi editoru Visual Studio Code nebo preferované integrované vývojové prostředí (IDE). Viz Java v editoru Visual Studio Code.

    Tip

    • Visual Studio Code nabízí balíček kódování pro Javu pro Windows a macOS.Balíček kódování je sada VS Code, sady Java Development Kit (JDK) a kolekce navrhovaných rozšíření od Microsoftu. Kódovací balíček lze také použít k opravě existujícího vývojového prostředí.
    • Pokud používáte VS Code a kódovací balíček pro Javu, nainstalujte rozšíření Gradle for Java .
  • Pokud visual Studio Code nepoužíváte, ujistěte se, že máte ve vývojovém prostředí nainstalované následující:

Vytvoření nového projektu Gradle

  1. V okně konzoly (například cmd, PowerShell nebo Bash) vytvořte pro aplikaci nový adresář s názvem text-translation-app a přejděte na něj.

    mkdir text-translation-app && text-translation-app
    
    mkdir text-translation-app; cd text-translation-app
    
  2. gradle init Spusťte příkaz z adresáře text-translation-app. Tento příkaz vytvoří základní soubory sestavení pro Gradle, včetně build.gradle.kts, které se používají za běhu k vytvoření a konfiguraci aplikace.

    gradle init --type basic
    
  3. Po zobrazení výzvy k výběru DSL vyberte Kotlin.

  4. Výběrem možnosti Return nebo Enter přijměte výchozí název projektu (text-translation-app).

    Poznámka:

    Vytvoření celé aplikace může trvat několik minut, ale brzy byste měli vidět několik složek a souborů včetně build-gradle.kts.

  5. Aktualizujte build.gradle.kts následujícím kódem. Hlavní třída je Translate:

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

Vytvoření aplikace v Javě

  1. V adresáři text-translation-app spusťte následující příkaz:

    mkdir -p src/main/java
    

    Příkaz vytvoří následující adresářovou strukturu:

    Snímek obrazovky: Adresářová struktura Java

  2. Přejděte do java adresáře a vytvořte soubor s názvem Translate.java.

    Tip

    • Nový soubor můžete vytvořit pomocí PowerShellu.

    • Otevřete okno PowerShellu v adresáři projektu tak, že podržíte klávesu Shift a kliknete pravým tlačítkem na složku.

    • Zadejte následující příkaz New-Item Translate.java.

    • V integrovaném Translate.java vývojovém prostředí (IDE) můžete také vytvořit nový soubor a uložit ho java do adresáře.

  3. Zkopírujte následující vzorový kód pro překlad textu a vložte ho do souboru Translate.java .

    • "<your-endpoint>" Aktualizujte "<your-key>"a "<region>" pomocí hodnot z vaší instance služby Translator na webu Azure Portal.

Ukázka kódu

Překlad textu

Důležité

Nezapomeňte klíč z kódu odebrat, až to budete hotovi, a nikdy ho veřejně neposílejte. V produkčním prostředí použijte bezpečný způsob ukládání přihlašovacích údajů a přístupu k vašim přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v tématu Zabezpečení služeb Azure AI.

Pokud chcete pracovat se službou Translator pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že vytvoříte pomocí AzureKeyCredential key webu Azure Portal a TextTranslationClient instance s nástrojem AzureKeyCredential. Ověřování se mírně liší v závislosti na tom, jestli váš prostředek používá regionální nebo globální koncový bod. Pro tento projekt se ověřte pomocí globálního koncového bodu. Další informace o použití regionálního koncového bodu najdete v tématu Translator Text SDK.

Poznámka:

V tomto příkladu používáme globální koncový bod. Pokud používáte regionální koncový bod, přečtěte si téma Vytvoření klienta překladu textu.

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

Sestavení a spuštění aplikace**

Po přidání ukázky kódu do aplikace přejděte zpět do hlavního adresáře projektu – text-translation-app.

  1. Sestavte aplikaci pomocí build příkazu (měli byste obdržet zprávu O ÚSPĚŠNÉM SESTAVENÍ):

    gradle build
    
  2. Spusťte aplikaci pomocí run příkazu (měli byste obdržet zprávu BUILD SUCCESSFUL ):

    gradle run
    

Tady je fragment očekávaného výstupu:

Snímek obrazovky s výstupem Javy v okně terminálu

Nastavení prostředí Node.js

Pro účely tohoto rychlého startu používáme prostředí modulu runtime Node.js JavaScript k vytvoření a spuštění aplikace.

  1. Pokud jste to ještě neudělali, nainstalujte si nejnovější verzi Node.js. Uzel Správce balíčků (npm) je součástí instalace Node.js.

    Tip

    Pokud s Node.js začínáte, vyzkoušejte modul Úvod do Node.js Learn.

  2. V okně konzoly (například cmd, PowerShell nebo Bash) vytvořte a přejděte do nového adresáře aplikace s názvem text-translation-app.

    mkdir text-translation-app && cd text-translation-app
    
    mkdir text-translation-app; cd text-translation-app
    
  3. Spuštěním příkazu npm init inicializujete aplikaci a vygenerujte svůj projekt.

    npm init
    
  4. Zadáním výzev zobrazených v terminálu určete atributy projektu.

    • Nejdůležitějšími atributy jsou název, číslo verze a vstupní bod.
    • Doporučujeme zachovat index.js název vstupního bodu. Popis, testovací příkaz, úložiště GitHub, klíčová slova, autor a informace o licencích jsou volitelné atributy – je možné je přeskočit pro tento projekt.
    • Návrhy v závorkách přijměte tak, že vyberete Return nebo Enter.
    • Po dokončení výzev package.json se v adresáři aplikace pro překlad textu vytvoří soubor.

Instalace klientské knihovny

Otevřete okno terminálu a nainstalujte klientskou knihovnu Azure Text Translation pro JavaScript pomocí npm:

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

Sestavení aplikace

Pokud chcete pracovat se službou Translator pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že vytvoříte aplikaci s vaším key webem TranslateCredential Azure Portal a <region> TextTranslationClient instancí. Další informace naleznete v tématu Translator text sdks.

  1. index.js Vytvořte soubor v adresáři aplikace.

    Tip

    • Nový soubor můžete vytvořit pomocí PowerShellu.

    • Otevřete okno PowerShellu v adresáři projektu tak, že podržíte klávesu Shift a kliknete pravým tlačítkem na složku.

    • Zadejte následující příkaz New-Item index.js.

    • Můžete také vytvořit nový soubor s názvem index.js v integrovaném vývojovém prostředí a uložit ho text-translation-app do adresáře.

  2. Zkopírujte a vložte index.js do souboru následující vzorový kód pro překlad textu. Aktualizujte <your-endpoint> hodnoty <your-key> z instance Služby Translator na webu Azure Portal.

Ukázka kódu

Důležité

Nezapomeňte klíč z kódu odebrat, až to budete hotovi, a nikdy ho veřejně neposílejte. V produkčním prostředí použijte bezpečný způsob ukládání přihlašovacích údajů a přístupu k vašim přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v tématu Zabezpečení služeb Azure AI.

Překlad textu

Poznámka:

V tomto příkladu používáme regionální koncový bod. Pokud používáte globální koncový bod, přečtěte si téma Vytvoření klienta překladu textu.

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

Spusťte aplikaci

Po přidání ukázky kódu do aplikace spusťte program:

  1. Přejděte do složky, ve které máte aplikaci pro překlad textu (text-translation-app).

  2. Do terminálu zadejte následující příkaz:

    node index.js
    

Tady je fragment očekávaného výstupu:

Snímek obrazovky s výstupem JavaScriptu v okně terminálu

Nastavení projektu Pythonu

  1. Pokud jste to ještě neudělali, nainstalujte si nejnovější verzi Pythonu 3.x. Instalační balíček Pythonu (pip) je součástí instalace Pythonu.

    Tip

    Pokud s Pythonem začínáte, vyzkoušejte modul Úvod do Pythonu Learn.

  2. Otevřete okno terminálu a nainstalujte klientskou knihovnu Azure Text Translation pro Python pomocí pip:

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

Sestavení aplikace

Pokud chcete pracovat se službou Translator pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že vytvoříte pomocí TranslatorCredential key webu Azure Portal a TextTranslationClient instance. Další informace naleznete v tématu Translator text sdks.

  1. V preferovaném editoru nebo integrovaném vývojovém prostředí (IDE) vytvořte nový soubor Pythonu s názvem text-translation-app.py.

  2. Zkopírujte následující vzorový kód pro překlad textu a vložte ho do souboru text-translation-app.py . Aktualizujte <your-key>, <your-endpoint>a <region> s hodnotami z vaší instance služby Translator na webu Azure Portal.

Ukázka kódu

Důležité

Nezapomeňte klíč z kódu odebrat, až to budete hotovi, a nikdy ho veřejně neposílejte. V produkčním prostředí použijte bezpečný způsob ukládání přihlašovacích údajů a přístupu k vašim přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v tématu Zabezpečení služeb Azure AI.

Překlad textu

Poznámka:

V tomto příkladu používáme regionální koncový bod. Pokud používáte globální koncový bod, přečtěte si téma Vytvoření klienta překladu textu.

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

Spuštění aplikace

Po přidání ukázky kódu do aplikace sestavte a spusťte program:

Přejděte do složky, ve které máte text-translation-app.py soubor.

Do terminálu zadejte následující příkaz:

python text-translation-app.py

Tady je fragment očekávaného výstupu:

Snímek obrazovky s výstupem JavaScriptu v okně terminálu

To je to, blahopřejeme! V tomto rychlém startu jste k překladu textu použili sadu SDK pro překlad textu.

Další kroky

Další informace o možnostech vývoje překladu textu: