Guia de início rápido: bibliotecas de cliente de texto do Azure AI Translator

Configurar seu ambiente C#/.NET

Para este início rápido, usamos a versão mais recente do IDE do Visual Studio para criar e executar o aplicativo.

1. Inicie o Visual Studio.

2. Na página Introdução, escolha Criar um novo projeto.

   

3. Na página Criar um novo projeto, insira console na caixa de pesquisa. Escolha o modelo Aplicativo de Console e, em seguida, escolha Avançar.

   

4. Na janela de diálogo Configurar seu novo projeto, digite text-translation-sdk na caixa Nome do projeto. Em seguida, escolha Avançar.

   

5. Na janela de diálogo Informações adicionais, selecione .NET 6.0 (Suporte de longo prazo) e, em seguida, selecione Criar.

   

Instalar a biblioteca de cliente com o NuGet

1. Clique com o botão direito do mouse em seu projeto Translator-text-sdk e selecione Gerenciar pacotes NuGet...

2. Marque a guia Procurar e a caixa de seleção Incluir pré-lançamento e digite Azure.AI.Translation.Text.

   

3. Selecione a versão 1.0.0-beta.1 no menu suspenso e instale o pacote em seu projeto.

   

Compilar a aplicação

Para interagir com o serviço Translator usando a biblioteca de cliente, você precisa criar uma instância da TextTranslationClientclasse. Para fazer isso, crie um AzureKeyCredential com o seu key a partir do portal do Azure e uma TextTranslationClient instância com o AzureKeyCredential. A autenticação varia um pouco, dependendo se o recurso usa o ponto de extremidade regional ou global. Para este projeto, autentique-se usando o ponto de extremidade global. Para obter mais informações sobre como usar um ponto de extremidade regional, consulte SDKs de texto do tradutor.

1. Abra o arquivo Program.cs .

2. Exclua o código pré-existente, incluindo a linha Console.WriteLine("Hello World!"), e insira o seguinte exemplo de código no arquivo de Program.cs do seu aplicativo:

Exemplo de código

Traduzir texto

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

Executar a aplicação

Depois de adicionar o exemplo de código ao seu aplicativo, escolha o botão verde Iniciar ao lado de formRecognizer_quickstart para criar e executar o programa ou pressione F5.

Aqui está um trecho da saída esperada:

Configurar seu ambiente Java

Para este início rápido, usamos a ferramenta de automação de construção Gradle para criar e executar o aplicativo.

• Você deve ter a versão mais recente do Visual Studio Code ou seu IDE preferido. Consulte Java no Visual Studio Code.

  Gorjeta

  • O Visual Studio Code oferece um Coding Pack para Java para Windows e macOS.O pacote de codificação é um pacote de VS Code, o Java Development Kit (JDK) e uma coleção de extensões sugeridas pela Microsoft. O Coding Pack também pode ser usado para corrigir um ambiente de desenvolvimento existente.
  • Se você estiver usando o VS Code e o Coding Pack For Java, instale a extensão Gradle for Java .

• Se você não estiver usando o Visual Studio Code, certifique-se de ter o seguinte instalado em seu ambiente de desenvolvimento:

  • Um Java Development Kit (OpenJDK) versão 8 ou posterior.

  • Gradle, versão 6.8 ou posterior.

Criar um novo projeto Gradle

1. Na janela do console (como cmd, PowerShell ou Bash), crie um novo diretório para seu aplicativo chamado text-translation-app e navegue até ele.

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

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

2. Execute o gradle init comando a partir do diretório text-translation-app. Este comando cria arquivos de compilação essenciais para o Gradle, incluindo build.gradle.kts, que é usado em tempo de execução para criar e configurar seu aplicativo.

   gradle init --type basic
   

3. Quando solicitado a escolher uma DSL, selecione Kotlin.

4. Aceite o nome do projeto padrão (text-translation-app) selecionando Return ou Enter.

   Nota

   Pode levar alguns minutos para que todo o aplicativo seja criado, mas logo você verá várias pastas e arquivos, incluindo build-gradle.kts.

5. Atualize build.gradle.kts com o código a seguir. A classe principal é Traduzir:

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

Crie sua aplicação Java

1. No diretório text-translation-app, execute o seguinte comando:

   mkdir -p src/main/java
   

   O comando cria a seguinte estrutura de diretórios:

   

2. Navegue até o java diretório e crie um arquivo chamado Translate.java.

   Gorjeta

   • Você pode criar um novo arquivo usando o PowerShell.

   • Abra uma janela do PowerShell no diretório do projeto mantendo pressionada a tecla Shift e clicando com o botão direito do mouse na pasta.

   • Digite o seguinte comando New-Item Translate.java.

   • Você também pode criar um novo arquivo em seu IDE chamado Translate.java e salvá-lo no java diretório.

3. Copie e cole o exemplo de código de tradução de texto a seguir em seu arquivo Translate.java .

   • Atualize "<your-key>"o , "<your-endpoint>" e "<region>" com valores da sua instância do Tradutor do portal do Azure.

Exemplo de código

Traduzir texto

Para interagir com o serviço Translator usando a biblioteca de cliente, você precisa criar uma instância da TextTranslationClientclasse. Para fazer isso, crie um AzureKeyCredential com o seu key a partir do portal do Azure e uma TextTranslationClient instância com o AzureKeyCredential. A autenticação varia um pouco, dependendo se o recurso usa o ponto de extremidade regional ou global. Para este projeto, autentique-se usando o ponto de extremidade global. Para obter mais informações sobre como usar um ponto de extremidade regional, consulte SDKs de texto do tradutor.

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

Crie e execute o aplicativo**

Depois de adicionar o exemplo de código ao seu aplicativo, navegue de volta para o diretório principal do projeto—text-translation-app.

1. Crie seu aplicativo com o build comando (você deve receber uma mensagem BUILD SUCCESSFUL ):

   gradle build
   

2. Execute seu aplicativo com o run comando (você deve receber uma mensagem BUILD SUCCESSFUL ):

   gradle run
   

Aqui está um trecho da saída esperada:

Configurar o ambiente Node.js

Para este início rápido, usamos o ambiente de tempo de execução Node.js JavaScript para criar e executar o aplicativo.

1. Se ainda não o fez, instale a versão mais recente do Node.js. O Gerenciador de Pacotes de Nó (npm) está incluído na instalação do Node.js.

   Gorjeta

   Se você é novo no Node.js, experimente o módulo Introdução ao Node.js Learn.

2. Em uma janela de console (como cmd, PowerShell ou Bash), crie e navegue até um novo diretório para seu aplicativo chamado text-translation-app.

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

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

3. Execute o comando npm init para inicializar o aplicativo e organizar seu projeto.

   npm init
   

4. Especifique os atributos do seu projeto aceitando os prompts apresentados no terminal.

   • Os atributos mais importantes são nome, número da versão e ponto de entrada.
   • Recomendamos manter index.js o nome do ponto de entrada. A descrição, o comando de teste, o repositório GitHub, palavras-chave, autor e informações de licença são atributos opcionais — eles podem ser ignorados para este projeto.
   • Aceite as sugestões entre parênteses selecionando Devolver ou Enter.
   • Depois de concluir os prompts, um package.json arquivo será criado no diretório text-translation-app.

Instalar a biblioteca de cliente

Abra uma janela de terminal e instale a biblioteca de Azure Text Translation cliente para JavaScript com npm:

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

Compilar a aplicação

Para interagir com o serviço Translator usando a biblioteca de cliente, você precisa criar uma instância da TextTranslationClientclasse. Para fazer isso, crie um TranslateCredential com o seu key e <region> a partir do portal do Azure e uma TextTranslationClient instância. Para obter mais informações, consulte SDKs de texto do tradutor.

1. Crie o index.js arquivo no diretório do aplicativo.

   Gorjeta

   • Você pode criar um novo arquivo usando o PowerShell.

   • Abra uma janela do PowerShell no diretório do projeto mantendo pressionada a tecla Shift e clicando com o botão direito do mouse na pasta.

   • Digite o seguinte comando New-Item index.js.

   • Você também pode criar um novo arquivo nomeado index.js em seu IDE e salvá-lo no text-translation-app diretório.

2. Copie e cole o exemplo de código de tradução de texto a seguir em seu index.js arquivo. Atualize <your-endpoint> e <your-key> com valores da sua instância do Azure Portal Translator.

Exemplo de código

Traduzir texto

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

Executar a aplicação

Depois de adicionar o exemplo de código ao seu aplicativo, execute o programa:

1. Navegue até a pasta onde você tem seu aplicativo de tradução de texto (text-translation-app).

2. Digite o seguinte comando no seu terminal:

   node index.js
   

Aqui está um trecho da saída esperada:

Configure seu projeto Python

1. Se você ainda não fez isso, instale a versão mais recente do Python 3.x. O pacote do instalador do Python (pip) está incluído na instalação do Python.

   Gorjeta

   Se você é novo no Python, tente o módulo Introdução ao Python Learn.

2. Abra uma janela de terminal e instale a Azure Text Translation biblioteca de cliente para Python com pip:

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

Compilar a aplicação

Para interagir com o serviço Translator usando a biblioteca de cliente, você precisa criar uma instância da TextTranslationClientclasse. Para fazer isso, crie um TranslatorCredential com o seu key a partir do portal do Azure e uma TextTranslationClient instância. Para obter mais informações, consulte SDKs de texto do tradutor.

1. Crie um novo arquivo Python chamado text-translation-app.py em seu editor ou IDE preferido.

2. Copie e cole o exemplo de código de exemplo de tradução de texto a seguir no arquivo text-translation-app.py . Atualize <your-key>o , <your-endpoint>e <region> com valores da sua instância do Tradutor do portal do Azure.

Exemplo de código

Traduzir texto

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

Executar a aplicação

Depois de adicionar o exemplo de código ao seu aplicativo, compile e execute o programa:

Navegue até a pasta onde você tem seu arquivo text-translation-app.py .

Digite o seguinte comando no seu terminal:

python text-translation-app.py

Aqui está um trecho da saída esperada: