Migrar para a versão mais recente do Azure AI Language

  • Artigo

Gorjeta

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

Se seus aplicativos ainda estiverem usando a API de Análise de Texto ou a biblioteca de cliente (antes da v5.1.0 estável), este artigo ajudará você a atualizar seus aplicativos para usar a versão mais recente dos recursos de linguagem da IA do Azure.

Ponto de extremidade de idioma unificado (API REST)

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

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

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

O serviço Language agora fornece um ponto de extremidade unificado para enviar solicitações de API REST para esses recursos. Se seu aplicativo usa a API REST, atualize seu ponto de extremidade de solicitação 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 o exemplo atual de chamadas de API REST para o(s) recurso(s) que você está usando e a saída de API associada.

Bibliotecas de cliente

Para usar a versão mais recente da biblioteca do cliente, você precisará baixar o pacote de software mais recente no Azure.AI.TextAnalytics namespace. Consulte os artigos de início rápido vinculados acima, por exemplo, código e instruções para usar a biblioteca do cliente em seu idioma preferido.

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

Análise de sentimento v2.1

A Análise de Sentimento na versão 2.1 retorna pontuações de sentimento entre 0 e 1 para cada documento enviado à API, com pontuações mais próximas de 1 indicando um sentimento mais positivo. A versão atual desse recurso retorna rótulos de sentimento (como "positivo" ou "negativo") para as frases e o documento como um todo, e suas 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 Reconhecimento de Entidade Nomeada (NER) e vinculação de entidade. A versão atual desse recurso fornece deteção de entidade nomeada expandida e tem pontos de extremidade separados para solicitações de vinculação de entidade e NER. Além disso, você pode usar outro recurso oferecido no serviço de idioma que permite detetar informações pessoais (PII) e de saúde (PHI).

Você também precisará atualizar seu aplicativo para usar as categorias de entidade retornadas na resposta da API.

Categorias de entidades da versão 2.1

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

Categoria Description
Pessoa Nomes de pessoas.
Location Marcos naturais e feitos pelo homem, estruturas, características geográficas e entidades geopolíticas
Organization Empresas, grupos políticos, bandas musicais, clubes desportivos, organismos governamentais e organizações públicas. Nacionalidades e religiões não estão incluídas neste tipo de entidade.
PhoneNumber Números de telefone (apenas números de telefone dos EUA e da UE).
E-mail Endereços de e-mail.
URL URLs para sites.
IP Endereços IP de rede.
DateTime Datas e horas do dia.
Date Datas do calendário.
Hora Horas do dia
Intervalo de Datas Intervalos de datas.
Intervalo de Tempo Intervalos de tempo.
Duração Duração.
Definição Conjunto, repetidos tempos.
Quantidade Números e quantidades numéricas.
Número Números.
Percentagem Porcentagens.
Ordinal Números ordinais.
Antiguidade Idades.
Moeda moedas.
Dimensão Dimensões e medidas.
Temperatura Temperaturas.

Deteção de idioma v2.1

A saída do recurso de deteçã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 frase-chave v2.1

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

Consulte também