Rychlý start: Sady SDK Azure Translator (překlad textu)

V tomto rychlém startu začněte používat 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 překladače v portálu Azure.

• Po nasazení prostředku vyberte možnost Přejít k prostředku a získejte 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 Azure Portal na stránce Klíče a koncový bod

    

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.

   

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

   

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

   

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

   

Instalace klientské knihovny pomocí NuGetu

1. Klikněte pravým tlačítkem myši na váš projekt translator-text-sdk a vyberte Manage NuGet Packages...

2. Vyberte kartu Browse a Include prerelease zaškrtávací políčko a zadejte Azure.AI.Translation.Text.

   

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

   

Sestavení aplikace

Pokud chcete pracovat s Translatorem pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že v Azure portal vytvoříte AzureKeyCredential pomocí key a instanci TextTranslationClient pomocí 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ématuTranslator 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 text metody Main. Nemusíte zahrnovat příkazy na nejvyšší úrovni, globální směrnice using ani implicitní směrnice using.
• Další informace najdete v tématuNové š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 naleznete v tématuZabezpečení foundry Tools.

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

Spuštění aplikace

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

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

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). Podívejte se naJava v editoru Visual Studio Code.

  Návod

  • 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 pro Javu .

• Pokud visual Studio Code nepoužíváte, ujistěte se, že máte ve vývojovém prostředí nainstalované následující:

  • Sada Java Development Kit (OpenJDK) verze 8 nebo novější.

  • Gradle verze 6.8 nebo novější

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:

   

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

   Návod

   • 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 IDE můžete také vytvořit nový soubor pojmenovaný Translate.java a uložit ho do adresáře java.

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

   • Aktualizujte "<your-key>", "<your-endpoint>" a "<region>" pomocí hodnot z vaší instance Překladače na portálu Azure.

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 naleznete v tématuZabezpečení foundry Tools.

Pokud chcete pracovat s Translatorem pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že v Azure portal vytvoříte AzureKeyCredential pomocí key a instanci TextTranslationClient pomocí 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ématuTranslator 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:

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. Ujistěte se, že máte nejnovější verzi Node.js. Uzel Správce balíčků (npm) je součástí instalace Node.js.

   Návod

   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 vyplnění pokynů se v adresáři aplikace pro překlad textu vytvoří soubor package.json.

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 s Translatorem pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Provedete to vytvořením TranslateCredential s vaším key a <region> z Azure portálu a instance TextTranslationClient. Další informace naleznete v tématuTranslator text sdks.

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

   Návod

   • 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> a <your-key> hodnotami z instance Překladače na portálu Azure.

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 naleznete v tématu: zabezpečení Foundry Tools.

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 pro překlad 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 };

Spuštění aplikace

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:

Nastavení projektu Pythonu

1. Ujistěte se, že máte nejnovější verzi Pythonu 3.x. Instalační balíček Pythonu (pip) je součástí instalace Pythonu.

   Návod

   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 s Translatorem pomocí klientské knihovny, musíte vytvořit instanci TextTranslationClienttřídy. Uděláte to tak, že vytvoříte TranslatorCredential s vaším key z Azure portalu a TextTranslationClient instance. Další informace naleznete v tématuTranslator text sdks.

1. V preferovaném editoru nebo integrovaném vývojovém prostředí 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 naleznete v tématuZabezpečení foundry Tools.

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 pro překlad 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 soubor text-translation-app.py .

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

python text-translation-app.py

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

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:

Přehled

Referenční informace k překladu textu v3