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

Articolo
11/21/2024

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

Cos'è Lingua di Azure AI?
Guida per sviluppatori del Servizio di linguaggio
Per informazioni sulle versioni precedenti dell'API, vedere la documentazione di riferimento seguente.
Usare le istruzioni di avvio rapido seguenti per visualizzare esempi per la versione corrente di queste funzionalità.

Condividi tramite