Quickstart: utilizando a biblioteca de clientes de Deteção de Idiomas e a API REST

Utilize este artigo para começar com a Deteção de Idiomas utilizando a biblioteca do cliente e a API REST. Siga estes passos para experimentar o código exemplos para o texto de mineração:

Documentação de referência | Código fonte da biblioteca | Pacote (NuGet) | Amostras adicionais

Pré-requisitos

  • Subscrição Azure - Crie uma gratuitamente
  • O IDE Visual Studio
  • Assim que tiver a sua subscrição Azure, crie um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, clique em Ir para o recurso.
    • Necessitará da chave e ponto final do recurso que criar para ligar a sua aplicação à API. Colará a sua chave e o ponto final no código abaixo mais tarde no arranque rápido.
    • Você pode usar o nível de preços gratuitos (F0) para experimentar o serviço, e atualizar mais tarde para um nível pago para produção.
  • Para utilizar a função Analisar, necessitará de um recurso idioma com o nível de preços padrão (S).

Configuração

Criar uma nova aplicação .NET Core

Utilizando o Visual Studio IDE, crie uma nova aplicação de consola .NET Core. Isto criará um projeto "Hello World" com um único ficheiro de origem C#: programa.cs.

Instale a biblioteca do cliente clicando à direita na solução no Explorador de Soluções e selecione Gerir pacotes NuGet. No gestor de pacotes que abre selecione Navegar e procurar .Azure.AI.TextAnalytics Selecione a versão 5.1.0e, em seguida, instale. Também pode utilizar a Consola Gestor de Pacotes.

Exemplo de código

Copie o seguinte código no ficheiro .cs programa . Lembre-se de substituir a key variável pela chave para o seu recurso e substitua a endpoint variável pelo ponto final do seu recurso.

Importante

Aceda ao portal do Azure. Se o recurso idioma que criou na secção Pré-Requisitos implementado com sucesso, clique no botão 'Ir a Recursos ' nos Passos Seguintes. Pode encontrar a sua chave e ponto final na página Chaves e Endpoint do recurso, sob Gestão de Recursos.

Lembre-se de remover a chave do seu código quando terminar, e nunca postá-la publicando publicamente. Para a produção, considere utilizar uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, cofre de chaves Azure.

using Azure;
using System;
using Azure.AI.TextAnalytics;

namespace LanguageDetectionExample
{
    class Program
    {
        private static readonly AzureKeyCredential credentials = new AzureKeyCredential("replace-with-your-key-here");
        private static readonly Uri endpoint = new Uri("replace-with-your-endpoint-here");

        // Example method for detecting the language of text
        static void LanguageDetectionExample(TextAnalyticsClient client)
        {
            DetectedLanguage detectedLanguage = client.DetectLanguage("Ce document est rédigé en Français.");
            Console.WriteLine("Language:");
            Console.WriteLine($"\t{detectedLanguage.Name},\tISO-6391: {detectedLanguage.Iso6391Name}\n");
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(endpoint, credentials);
            LanguageDetectionExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

Saída

Language:
        French, ISO-6391: fr

Documentação de referência | Código fonte da biblioteca | Pacote | Amostras

Pré-requisitos

  • Subscrição Azure - Crie uma gratuitamente
  • Kit de Desenvolvimento java (JDK) com versão 8 ou superior
  • Assim que tiver a sua subscrição Azure, crie um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, clique em Ir para o recurso.
    • Necessitará da chave e ponto final do recurso que criar para ligar a sua aplicação à API. Colará a sua chave e o ponto final no código abaixo mais tarde no arranque rápido.
    • Você pode usar o nível de preços gratuitos (F0) para experimentar o serviço, e atualizar mais tarde para um nível pago para produção.
  • Para utilizar a função Analisar, necessitará de um recurso idioma com o nível de preços padrão (S).

Configuração

Adicione a biblioteca do cliente

Crie um projeto Maven no seu IDE preferido ou ambiente de desenvolvimento. Em seguida, adicione a seguinte dependência ao ficheiro pom.xml do seu projeto. Pode encontrar a sintaxe de implementação para outras ferramentas de construção online.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.1.9</version>
    </dependency>
</dependencies>

Exemplo de código

Crie um ficheiro Java chamado Example.java. Abra o ficheiro e copie o código abaixo. Lembre-se de substituir a key variável pela chave para o seu recurso e substitua a endpoint variável pelo ponto final do seu recurso.

Importante

Aceda ao portal do Azure. Se o recurso idioma que criou na secção Pré-Requisitos implementado com sucesso, clique no botão 'Ir a Recursos ' nos Passos Seguintes. Pode encontrar a sua chave e ponto final na página Chaves e Endpoint do recurso, sob Gestão de Recursos.

Lembre-se de remover a chave do seu código quando terminar, e nunca postá-la publicando publicamente. Para a produção, considere utilizar uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, cofre de chaves Azure.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;

public class Example {

    private static String KEY = "replace-with-your-key-here";
    private static String ENDPOINT = "replace-with-your-endpoint-here";

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(KEY, ENDPOINT);
        detectLanguageExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }
    // Example method for detecting the language of text
    static void detectLanguageExample(TextAnalyticsClient client)
    {
        // The text to be analyzed.
        String text = "Ce document est rédigé en Français.";

        DetectedLanguage detectedLanguage = client.detectLanguage(text);
        System.out.printf("Detected primary language: %s, ISO 6391 name: %s, score: %.2f.%n",
                detectedLanguage.getName(),
                detectedLanguage.getIso6391Name(),
                detectedLanguage.getConfidenceScore());
    }
}

Saída

Detected primary language: French, ISO 6391 name: fr, score: 1.00.

Documentação de referência | Código fonte da biblioteca | Pacote (NPM) | Amostras

Pré-requisitos

  • Subscrição Azure - Crie uma gratuitamente
  • A versão atual de Node.js.
  • Assim que tiver a sua subscrição Azure, crie um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, clique em Ir para o recurso.
    • Necessitará da chave e ponto final do recurso que criar para ligar a sua aplicação à API. Colará a sua chave e o ponto final no código abaixo mais tarde no arranque rápido.
    • Você pode usar o nível de preços gratuitos (F0) para experimentar o serviço, e atualizar mais tarde para um nível pago para produção.
  • Para utilizar a função Analisar, necessitará de um recurso idioma com o nível de preços padrão (S).

Configuração

Criar uma nova aplicação Node.js

Numa janela de consola (como cmd, PowerShell ou Bash), crie um novo diretório para a sua aplicação e navegue até ela.

mkdir myapp 

cd myapp

Executar o npm init comando para criar uma aplicação de nó com um package.json ficheiro.

npm init

Instalar a biblioteca do cliente

Instale o pacote NPM:

npm install --save @azure/ai-text-analytics@5.1.0

Exemplo de código

Abra o ficheiro e copie o código abaixo. Lembre-se de substituir a key variável pela chave para o seu recurso e substitua a endpoint variável pelo ponto final do seu recurso.

Importante

Aceda ao portal do Azure. Se o recurso idioma que criou na secção Pré-Requisitos implementado com sucesso, clique no botão 'Ir a Recursos ' nos Passos Seguintes. Pode encontrar a sua chave e ponto final na página Chaves e Endpoint do recurso, sob Gestão de Recursos.

Lembre-se de remover a chave do seu código quando terminar, e nunca postá-la publicando publicamente. Para a produção, considere utilizar uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, cofre de chaves Azure.

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");
const key = '<paste-your-key-here>';
const endpoint = '<paste-your-endpoint-here>';
// Authenticate the client with your key and endpoint
const textAnalyticsClient = new TextAnalyticsClient(endpoint, new AzureKeyCredential(key));

// Example method for detecting the language of text
async function languageDetection(client) {

    const languageInputArray = [
        "Ce document est rédigé en Français."
    ];
    const languageResult = await client.detectLanguage(languageInputArray);

    languageResult.forEach(document => {
        console.log(`ID: ${document.id}`);
        console.log(`\tPrimary Language ${document.primaryLanguage.name}`)
    });
}
languageDetection(textAnalyticsClient);

Saída

ID: 0
    Primary Language French

Documentação de referência | Código fonte da biblioteca | Pacote (PiPy) | Amostras

Pré-requisitos

  • Subscrição Azure - Crie uma gratuitamente
  • Python 3.x
  • Assim que tiver a sua subscrição Azure, crie um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, clique em Ir para o recurso.
    • Necessitará da chave e ponto final do recurso que criar para ligar a sua aplicação à API. Colará a sua chave e o ponto final no código abaixo mais tarde no arranque rápido.
    • Você pode usar o nível de preços gratuitos (F0) para experimentar o serviço, e atualizar mais tarde para um nível pago para produção.
  • Para utilizar a função Analisar, necessitará de um recurso idioma com o nível de preços padrão (S).

Configuração

Instalar a biblioteca do cliente

Depois de instalar Python, pode instalar a biblioteca do cliente com:

pip install azure-ai-textanalytics==5.1.0

Exemplo de código

Crie um novo ficheiro Python e copie o código abaixo. Lembre-se de substituir a key variável pela chave para o seu recurso e substitua a endpoint variável pelo ponto final do seu recurso.

Importante

Aceda ao portal do Azure. Se o recurso idioma que criou na secção Pré-Requisitos implementado com sucesso, clique no botão 'Ir a Recursos ' nos Passos Seguintes. Pode encontrar a sua chave e ponto final na página Chaves e Endpoint do recurso, sob Gestão de Recursos.

Lembre-se de remover a chave do seu código quando terminar, e nunca postá-la publicando publicamente. Para a produção, considere utilizar uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, cofre de chaves Azure.

key = "paste-your-key-here"
endpoint = "paste-your-endpoint-here"

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

# Authenticate the client using your key and endpoint 
def authenticate_client():
    ta_credential = AzureKeyCredential(key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

# Example method for detecting the language of text
def language_detection_example(client):
    try:
        documents = ["Ce document est rédigé en Français."]
        response = client.detect_language(documents = documents, country_hint = 'us')[0]
        print("Language: ", response.primary_language.name)

    except Exception as err:
        print("Encountered exception. {}".format(err))
language_detection_example(client)

Saída

Language:  French

Documentação de referência

Pré-requisitos

  • Subscrição Azure - Crie uma gratuitamente
  • A versão atual da CURL.
  • Assim que tiver a sua subscrição Azure, crie um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, clique em Ir para o recurso.
    • Necessitará da chave e ponto final do recurso que criar para ligar a sua aplicação à API. Colará a sua chave e o ponto final no código abaixo mais tarde no arranque rápido.
    • Você pode usar o nível de preços gratuitos (F0) para experimentar o serviço, e atualizar mais tarde para um nível pago para produção.

Nota

  • Os seguintes exemplos BASH usam o carácter de continuação da \ linha. Se a sua consola ou terminal utilizar um carácter de continuação de linha diferente, utilize esse personagem.
  • Pode encontrar amostras específicas da linguagem no GitHub.
  • Vá ao portal do Azure e encontre a chave e o ponto final para o recurso idioma que criou nos pré-requisitos. Serão localizados na página chave e endpoint do recurso, sob gestão de recursos. Em seguida, substitua as cordas do código abaixo com a sua chave e ponto final. Para ligar para a API, precisa das seguintes informações:
parameter Descrição
-X POST <endpoint> Especifica o seu ponto final para aceder à API.
-H Content-Type: application/json O tipo de conteúdo para o envio de dados JSON.
-H "Ocp-Apim-Subscription-Key:<key> Especifica a chave para aceder à API.
-d <documents> O JSON contendo os documentos que pretende enviar.

Os seguintes comandos cURL são executados a partir de uma concha BASH. Edite estes comandos com o seu próprio nome de recurso, chave de recursos e valores JSON.

Deteção de idioma

  1. Copie o comando num editor de texto.
  2. Faça as alterações seguintes ao comando, se for necessário:
    1. Substitua o valor <your-text-analytics-key-here> pela sua chave.
    2. Substitua a primeira parte do URL <your-text-analytics-endpoint-here> de pedido pelo URL do seu próprio ponto final.
  3. Abra uma janela da linha de comandos.
  4. Cole o comando a partir do editor de texto na janela da linha de comandos e, em seguida, execute o comando.
curl -X POST https://<your-text-analytics-endpoint-here>/text/analytics/v3.1/languages/ \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-text-analytics-key-here>" \
-d '{ documents: [{ id: "1", text: "This is a document written in English."}]}'

Resposta JSON

{
   "documents":[
      {
         "id":"1",
         "detectedLanguage":{
            "name":"English",
            "iso6391Name":"en",
            "confidenceScore":1.0
         },
         "warnings":[
            
         ]
      }
   ],
   "errors":[
      
   ],
   "modelVersion":"2021-01-05"
}

Limpar os recursos

Se pretender limpar e remover uma subscrição dos Serviços Cognitivos, pode eliminar o grupo de recursos ou recursos. A eliminação do grupo de recursos também elimina quaisquer outros recursos que lhe sejam associados.

Passos seguintes