Dela via

Migrera till den senaste versionen av Azure AI Language

  • Artikel

Tips

Har du precis börjat med Azure AI Language? Se översiktsartikeln för information om tjänsten, tillgängliga funktioner och länkar till snabbstarter för information om den aktuella versionen av API:et.

Om dina program fortfarande använder Textanalys-API:et eller klientbiblioteket (före stabil v5.1.0) hjälper den här artikeln dig att uppgradera dina program så att de använder den senaste versionen av språkfunktionerna i Azure AI.

Slutpunkt för enhetligt språk (REST API)

Det här avsnittet gäller för program som använder det äldre /text/analytics/... slutpunktsformatet för REST API-anrop. Ett exempel:

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

Om ditt program använder formatet ovan har REST API-slutpunkten för följande språktjänstfunktioner ändrats:

Språktjänsten tillhandahåller nu en enhetlig slutpunkt för att skicka REST API-begäranden till dessa funktioner. Om ditt program använder REST-API:et uppdaterar du dess slutpunkt för begäran så att den använder den aktuella slutpunkten:

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

Dessutom har formatet för JSON-begärandetexten ändrats. Du måste uppdatera den begärandestruktur som ditt program skickar till API:et, till exempel följande JSON-brödtext för entitetsigenkänning:

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

Använd snabbstarterna som är länkade ovan för att se aktuella REST API-exempelanrop för de funktioner som du använder och tillhörande API-utdata.

Klientbibliotek

Om du vill använda den senaste versionen av klientbiblioteket måste du ladda ned det senaste programvarupaketet i Azure.AI.TextAnalytics namnområdet. I snabbstartsartiklarna som är länkade ovan finns exempel på kod och instruktioner för att använda klientbiblioteket på önskat språk.

Funktionsändringar i version 2.1

Om du migrerar ett program från v2.1 i API:et finns det flera ändringar av funktionsfunktioner som du bör känna till.

Attitydanalys v2.1

Sentimentanalys i version 2.1 returnerar sentimentpoäng mellan 0 och 1 för varje dokument som skickas till API:et, med poäng närmare 1 som indikerar mer positiv attityd. Den aktuella versionen av den här funktionen returnerar sentimentetiketter (till exempel "positiva" eller "negativa") för både meningarna och dokumentet som helhet och deras associerade konfidenspoäng.

NER, PII och entitetslänkning v2.1

I version 2.1 använde Textanalys-API:et en slutpunkt för igenkänning av namngiven entitet (NER) och entitetslänkning. Den aktuella versionen av den här funktionen ger utökad namngiven entitetsidentifiering och har separata slutpunkter för NER - och entitetslänkningsbegäranden . Dessutom kan du använda en annan funktion som erbjuds i språktjänsten som gör att du kan identifiera personlig information (PII) och hälsoinformation (PHI).

Du måste också uppdatera ditt program för att använda entitetskategorierna som returneras i API:ets svar.

Entitetskategorier i version 2.1

I följande tabell visas entitetskategorierna som returneras för NER v2.1.

Kategori Beskrivning
Person Namn på personer.
Location Naturliga och människotillverkade landmärken, strukturer, geografiska egenskaper och geopolitiska entiteter
Organisation Företag, politiska grupper, musikband, idrottsklubbar, statliga organ och offentliga organisationer. Nationaliteter och religioner ingår inte i denna entitetstyp.
PhoneNumber Telefonnummer (endast telefonnummer för USA och EU).
E-post Email adresser.
URL URL:er till webbplatser.
IP-adress Nätverks-IP-adresser.
DateTime Datum och tider på dagen.
Date Kalenderdatum.
Tid Tider på dagen
DateRange Datumintervall.
TimeRange Tidsintervall.
Varaktighet Varaktigheter.
Ange Ange upprepade gånger.
Kvantitet Tal och numeriska kvantiteter.
Tal Nummer.
Procent Procentsatser.
Ordningstal Ordningstal.
Ålder Åldrar.
Valuta Valutor.
Dimension Dimensioner och mått.
Temperatur Temperaturer.

Språkidentifiering v2.1

Utdata för språkidentifieringsfunktionen har ändrats i den aktuella versionen. JSON-svaret innehåller ConfidenceScore i stället för score. Den aktuella versionen returnerar också bara ett språk för varje dokument.

Extrahering av nyckelfras v2.1

Funktionen för extrahering av nyckelfraser har för närvarande inte ändrats utanför slutpunkten och begärandeformatet.

Se även