Eseguire la migrazione alla versione più recente di Lingua di Azure AI.

  • Articolo

Suggerimento

Alle prime armi con Lingua di Azure AI? Vedere l'articolo di panoramica per informazioni dettagliate sul servizio, sulle funzionalità disponibili e sui collegamenti alle guide di avvio rapido per informazioni sulla versione corrente dell'API.

Se le applicazioni usano ancora l'API Analisi del testo o la libreria client (prima della versione stabile 5.1.0), questo articolo aiuterà ad aggiornare le applicazioni per usare la versione più recente delle funzionalità di Lingua di Azure AI.

Endpoint del linguaggio unificato (API REST)

Questa sezione si riferisce alle applicazioni che usano il /text/analytics/...formato di endpoint meno recente per le chiamate API REST. Ad esempio:

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

Se l'applicazione usa il formato dell'endpoint precedente, l'endpoint dell'API REST per le funzionalità Servizio di linguaggio seguenti è stato modificato:

Il Servizio di linguaggio fornisce ora un endpoint unificato per l'invio di richieste API REST a queste funzionalità. Se l'applicazione usa l'API REST, aggiornare l'endpoint della richiesta per usare l'endpoint corrente:

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

Inoltre, il formato del corpo della richiesta JSON è stato modificato. Sarà necessario aggiornare la struttura di richiesta inviata dall'applicazione all'API, ad esempio il seguente corpo JSON di riconoscimento delle entità:

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

Usare le istruzioni di avvio rapido il cui collegamento è fornito qui sopra per visualizzare le chiamate API REST di esempio correnti per la/e funzionalità in uso e l'output dell'API associato.

Librerie client

Per usare la versione più recente della libreria client, è necessario scaricare il pacchetto software più recente nello spazio dei nomi Azure.AI.TextAnalytics. Vedere gli articoli di avvio rapido di cui è fornito un collegamento qui sopra per codice di esempio e le istruzioni per l'uso della libreria client nella lingua preferita.

Modifiche alle funzionalità della versione 2.1

Se si esegue la migrazione di un'applicazione dalla versione 2.1 dell'API, è necessario tenere presenti diverse modifiche alle funzionalità.

Analisi del sentiment v2

L'analisi del sentiment nella versione 2.1 restituisce punteggi di sentiment compresi tra 0 e 1 per ogni documento inviato all'API, con punteggi più vicini a 1 che indicano un sentiment più positivo. La versione corrente di questa funzionalità restituisce etichette del sentiment (ad esempio "positive" o "negative") sia per le frasi che per il documento nel suo complesso e i relativi punteggi di attendibilità associati.

Collegamento di NER, PII ed entità v2.1

Nella versione 2.1, l'API Analisi del testo usava un endpoint per il Riconoscimento delle entità denominate (NER) e il collegamento delle entità. La versione corrente di questa funzionalità fornisce il rilevamento migliorato di entità denominate e dispone di endpoint separati per le richieste NER e di collegamento delle entità. Inoltre, è possibile usare un'altra funzionalità offerta nel Servizio di linguaggio che consente di rilevare informazioni personali (PII) e di integrità (PHI).

Sarà anche necessario aggiornare l'applicazione per usare le categorie di entità restituite nella risposta dell'API.

Categorie di entità della versione 2.1

Nella tabella seguente sono elencate le categorie di entità restituite per NER v2.1.

Categoria Descrizione
Person Nomi di persone.
Ufficio Punti di riferimento naturali e umani, strutture, caratteristiche geografiche ed entità geopolitiche
Organizzazione Società, gruppi politici, bande musicali, club sportivi, enti governativi e organizzazioni pubbliche. Le nazionalità e le religioni non sono incluse in questo tipo di entità.
PhoneNumber Numeri di telefono (solo numeri di telefono USA e UE).
E-mail Indirizzi di posta elettronica.
URL URL di siti Web.
IP Indirizzi IP di rete.
Data/Ora Date e ore del giorno.
Data Date di calendario.
Ora Ora del giorno
DateRange Intervalli di date.
Intervallo di tempo Intervalli di tempo.
Durata Durate.
Set Impostare ore ripetute.
Quantità Numeri e quantità numeriche.
Numero Numeri.
Percentuale Percentuali.
Ordinale Numeri ordinali.
Età Età
Valuta Valute.
Dimensione Dimensioni e misurazioni.
Temperatura Temperature.

Rilevamento lingua v2.1

L'output della funzionalità di rilevamento della lingua è stato modificato nella versione corrente. La risposta JSON conterrà ConfidenceScore invece di score. Inoltre, la versione corrente restituisce una sola lingua per ogni documento.

Estrazione di frasi chiave v2.1

La funzionalità di estrazione di frasi chiave non è attualmente cambiata al di fuori dell'endpoint e del formato di richiesta.

Vedi anche