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

Artigo
09/26/2024

Neste guia de início rápido, comece a usar o serviço Tradutor para traduzir texto usando uma linguagem de programação de sua escolha. Para este projeto, recomendamos usar o nível de preço gratuito (F0), enquanto você está aprendendo a tecnologia e, posteriormente, atualizar para um nível pago para produção.

Pré-requisitos

Você precisa de uma assinatura ativa do Azure. Se não tiver uma subscrição do Azure, pode criar uma gratuitamente

Depois de ter sua assinatura do Azure, crie um recurso de Tradutor no portal do Azure.
Depois que o recurso for implantado, selecione Ir para o recurso e recupere sua chave e o ponto de extremidade.
- Obtenha a chave, o ponto de extremidade e a região do recurso e conecte seu aplicativo ao serviço Tradutor. Cole esses valores no código posteriormente no início rápido. Você pode encontrá-los na página Chaves e Ponto de Extremidade do portal do Azure:

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.

Inicie o Visual Studio.
Na página Introdução, escolha Criar um novo projeto.
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.
Na janela de diálogo Configurar seu novo projeto, digite text-translation-sdk na caixa Nome do projeto. Em seguida, escolha Avançar.
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

Clique com o botão direito do mouse em seu projeto Translator-text-sdk e selecione Gerenciar pacotes NuGet...
Marque a guia Procurar e a caixa de seleção Incluir pré-lançamento e digite Azure.AI.Translation.Text.
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.

Nota

A partir do .NET 6, novos projetos usando o console modelo geram um novo estilo de programa que difere das versões anteriores.
A nova saída usa recursos recentes do C# que simplificam o código que você precisa escrever.
Quando você usa a versão mais recente, você só precisa escrever o Main corpo do método. Não é necessário incluir instruções de nível superior, diretivas de uso global ou diretivas de uso implícito.
Para obter mais informações, consulte Novos modelos C# geram instruções de nível superior.

Abra o arquivo Program.cs .
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

Importante

Lembre-se de remover a chave do seu código quando terminar e nunca publicá-la publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte Segurança dos serviços de IA do Azure.

Traduzir texto

Nota

Neste exemplo, estamos usando o endpoint global. Se você estiver usando um ponto de extremidade regional, consulte Criar um cliente de tradução de 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.

Captura de tela: execute seu programa Visual Studio.

Aqui está um trecho da saída esperada:

Captura de tela da saída do Visual Studio Code na janela do terminal.

Configurar seu ambiente Java

Nota

O SDK de Tradução de Texto do Azure para Java é testado e tem suporte nas plataformas Windows, Linux e macOS. Ele não é testado em outras plataformas e não suporta implantações Android.

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

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
```
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
```
Quando solicitado a escolher uma DSL, selecione Kotlin.
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.

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

No diretório text-translation-app, execute o seguinte comando:
```
mkdir -p src/main/java
```
O comando cria a seguinte estrutura de diretórios:
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.
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

Importante

Nota

Neste exemplo, estamos usando o endpoint global. Se você estiver usando um ponto de extremidade regional, consulte Criar um cliente de tradução de texto.

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.

Crie seu aplicativo com o build comando (você deve receber uma mensagem BUILD SUCCESSFUL ):
```
gradle build
```
Execute seu aplicativo com o run comando (você deve receber uma mensagem BUILD SUCCESSFUL ):
```
gradle run
```

Aqui está um trecho da saída esperada:

Captura de tela da saída Java na janela do terminal.

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.

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.
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
```
Execute o comando npm init para inicializar o aplicativo e organizar seu projeto.
```
npm init
```
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.

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

Importante

Traduzir texto

Nota

Neste exemplo, estamos usando um ponto de extremidade regional. Se você estiver usando o ponto de extremidade global, consulte Criar um cliente de tradução de 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:

Navegue até a pasta onde você tem seu aplicativo de tradução de texto (text-translation-app).
Digite o seguinte comando no seu terminal:
```
node index.js
```

Aqui está um trecho da saída esperada:

Captura de ecrã da saída JavaScript na janela do terminal.

Configure seu projeto Python

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

Crie um novo arquivo Python chamado text-translation-app.py em seu editor ou IDE preferido.
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

Importante

Traduzir texto

Nota

Neste exemplo, estamos usando um ponto de extremidade regional. Se você estiver usando o ponto de extremidade global, consulte Criar um cliente de tradução de 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:

Captura de ecrã da saída JavaScript na janela do terminal.

É isso, parabéns! Neste início rápido, você usou um SDK de tradução de texto para traduzir texto.

Próximos passos

Saiba mais sobre as opções de desenvolvimento da Tradução de Texto:

Visão geral do SDK de Tradução de

Texto Referência da Tradução de Texto V3

Partilhar via

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

Pré-requisitos

Configurar seu ambiente C#/.NET

Instalar a biblioteca de cliente com o NuGet

Compilar a aplicação

Exemplo de código

Executar a aplicação

Configurar seu ambiente Java

Criar um novo projeto Gradle

Crie sua aplicação Java

Exemplo de código

Crie e execute o aplicativo**

Configurar o ambiente Node.js

Instalar a biblioteca de cliente

Compilar a aplicação

Exemplo de código

Executar a aplicação

Configure seu projeto Python

Compilar a aplicação

Exemplo de código

Executar a aplicação

Próximos passos

Comentários

Recursos adicionais