Migrar para a mais recente do Serviço Cognitivo do Azure para Linguagem

Dica

Basta começar a usar o Serviço Cognitivo do Azure para Linguagem? Consulte o artigo de visão geral para obter detalhes sobre o serviço, os recursos disponíveis e os links para inícios rápidos para obter informações sobre a versão atual da API.

Se os aplicativos ainda estiverem usando a API de Análise de Texto ou da biblioteca de clientes (anterior à versão v5.1.0), este artigo ajudará a atualizar os aplicativos para usar a versão mais recente dos recursos do Serviço Cognitivo do Azure para Linguagem.

Ponto de extremidade de linguagem unificada (API REST)

Esta seção se aplica a aplicativos que usam o formato de ponto de extremidade mais antigo /text/analytics/... para chamadas à API REST. Por exemplo:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

Se o aplicativo usar o formato de ponto de extremidade acima, o ponto de extremidade da API REST para os seguintes recursos do serviço de linguagem foi alterado:

O serviço de linguagem agora fornece um ponto de extremidade unificado para enviar solicitações de API REST para esses recursos. Se o aplicativo usa a API REST, atualize o ponto de extremidade de solicitação dele para usar o ponto de extremidade atual:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

Além disso, o formato do corpo da solicitação JSON foi alterado. Você precisará atualizar a estrutura de solicitação que seu aplicativo envia para a API, por exemplo, o seguinte corpo JSON de reconhecimento de entidade:

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

Use os guias de início rápido vinculados acima para ver as chamadas da API REST de exemplo atual para os recursos que você está usando e a saída da API associada.

Bibliotecas de cliente

Para usar a versão mais recente da biblioteca de clientes, você precisará baixar o pacote de software mais recente no namespace Azure.AI.TextAnalytics. Consulte os artigos de início rápido vinculados acima para obter código de exemplo e instruções para usar a biblioteca de clientes na linguagem de sua preferência.

Alterações na funcionalidade da versão 2.1

Se você estiver migrando um aplicativo da v2.1 da API, há várias alterações na funcionalidade do recurso que você deve conhecer.

Análise de sentimento v2.1

Na versão 2.1, a Análise de sentimento retorna pontuações de sentimentos entre 0 e 1 para cada documento enviado à API, sendo que as pontuações mais próximas de 1 indicam sentimentos mais positivos. A versão atual deste recurso retorna rótulos de sentimentos (como "positivo" ou "negativo") para as frases e o documento como um todo, bem como as pontuações de confiança associadas.

NER, PII e vinculação de entidade v2.1

Na versão 2.1, a API de Análise de Texto usou um ponto de extremidade para NER (Reconhecimento de Entidade Nomeada) e vinculação de entidade. A versão atual desse recurso fornece detecção de entidade nomeada expandida e tem pontos de extremidade separados para NER e solicitações de vinculação de entidade. Além disso, você pode usar outro recurso oferecido no serviço de linguagem que permite detectar PII (informações de identificação pessoal) e PHI (informações de integridade).

Também será necessário atualizar seu aplicativo para usar as categorias de entidade retornadas na resposta da API.

Categorias de entidade da versão 2.1

A tabela a seguir lista as categorias de entidade retornadas para o NER v2.1.

Categoria Descrição
Pessoa Nomes de pessoas.
Local Pontos de referência naturais e humanos, estruturas, recursos geográficos e entidades geopolíticas
Organização Empresas, grupos políticos, bandas de música, clubes esportivos, órgãos governamentais e organizações públicas. As nacionalidades e as religiões não são incluídas nesse tipo de entidade.
PhoneNumber Números de telefone (números de telefone dos EUA e da EU).
Email Endereços de email.
URL URLs para sites.
IP Endereços IP de rede.
Datetime Datas e horas do dia.
Data Datas do calendário.
Hora Horas do dia
DateRange Intervalos de datas.
TimeRange Intervalos de tempo.
Duration Durações.
Definir Definido, horários repetidos.
Quantidade Números e quantidades numéricas.
Número Números.
Percentual Percentuais.
Ordinal Números ordinais.
Idade Idades.
Moeda Moedas.
Dimensão Dimensões e medidas.
Temperatura Temperaturas.

Detecção de idioma v2.1

A saída do recurso de detecção de idioma foi alterada na versão atual. A resposta JSON conterá ConfidenceScore em vez de score. A versão atual também retorna apenas um idioma para cada documento.

Extração de frases-chave v2.1

A funcionalidade do recurso de extração de frases-chave não foi alterada atualmente fora do formato de solicitação e ponto de extremidade.

Confira também