Eseguire la migrazione alla versione più recente del linguaggio di intelligenza artificiale di Azure

  • Articolo

Suggerimento

È sufficiente iniziare a usare Il linguaggio di intelligenza artificiale di Azure? Vedere l'articolo di panoramica per informazioni dettagliate sul servizio, sulle funzionalità disponibili e sui collegamenti alle guide introduttive 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 v5.1.0), questo articolo consente di aggiornare le applicazioni per usare la versione più recente delle funzionalità del linguaggio di Intelligenza artificiale di Azure.

Endpoint del linguaggio unificato (API REST)

Questa sezione si applica alle applicazioni che usano il formato endpoint meno recente /text/analytics/... 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à del servizio linguistico seguenti è stato modificato:

Il servizio lingua 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. È necessario aggiornare la struttura della richiesta inviata dall'applicazione all'API, ad esempio il corpo JSON di riconoscimento delle entità seguente:

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

Usare le guide introduttive collegate in precedenza per visualizzare le chiamate API REST di esempio correnti per le funzionalità usate e l'output dell'API associato.

Librerie client

Per usare la versione più recente della libreria client, sarà necessario scaricare il pacchetto software più recente nello Azure.AI.TextAnalytics spazio dei nomi. Vedere gli articoli di avvio rapido collegati sopra per esempio codice e istruzioni per l'uso della libreria client nel linguaggio preferito.

Modifiche alle funzionalità della versione 2.1

Se si esegue la migrazione di un'applicazione dalla versione 2.1 dell'API, esistono diverse modifiche alle funzionalità da tenere presente.

Analisi del sentiment v2.1

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 sentiment (ad esempio "positive" o "negative") sia per le frasi che per il documento nel suo complesso e i relativi punteggi di attendibilità associati.

NER, PII e entity linking v2.1

Nella versione 2.1, l'API Analisi del testo ha usato un endpoint per Il riconoscimento entità denominato e il collegamento di entità. La versione corrente di questa funzionalità fornisce il rilevamento delle entità denominato espanso e include endpoint separati per le richieste di collegamento di entità e ner. Inoltre, è possibile usare un'altra funzionalità offerta nel servizio lingua che consente di rilevare le informazioni personali (PII) e integrità (PHI).

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

Categorie di entità versione 2.1

La tabella seguente elenca le categorie di entità restituite per NER v2.1.

Category Descrizione
Persona Nomi di persone.
Posizione Punti di riferimento naturali e umani, strutture, caratteristiche geografiche e entità geopolitiche
Organizzazione Aziende, gruppi politici, bande musicali, club sportivi, enti pubblici e organizzazioni pubbliche. Le nazionalità e le religioni non sono incluse in questo tipo di entità.
PhoneNumber Numeri di telefono (solo numeri di telefono stati Uniti e UE).
E-mail Indirizzi di posta elettronica.
URL URL ai siti Web.
IP Indirizzi IP di rete.
Datetime Date e orari del giorno.
Data Date calender.
Ora Orari del giorno
DateRange Intervalli di date.
Intervallo di tempo Intervalli di tempo.
Durata Durate
Set Impostare, ripetute volte.
Quantità Numeri e quantità numeriche.
Number Numeri.
Percentuale Percentuali.
Ordinale Numeri ordinali.
Età Età.
Valuta Valute.
Dimensione Dimensioni e misurazioni.
Temperatura Temperature.

Rilevamento della lingua v2.1

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

Estrazione di frasi chiave v2.1

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

Vedi anche