Dela via

Migrera till den senaste versionen av Azure AI Language

  • Artikel

Dricks

Har du precis börjat med Azure AI Language? I översiktsartikeln finns 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 azure AI-språkfunktionerna.

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. Till exempel:

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

Om ditt program använder slutpunktsformatet 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 exempel på REST API-anrop 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 till exempel 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 i 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 attitydetiketter (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 namngiven entitetsigenkänning (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 för version 2.1

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

Kategori beskrivning
Person Namn på personer.
Plats 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).
Email E-postadresser.
webbadress URL:er till webbplatser.
IP Nätverks-IP-adresser.
Datum/tid Datum och tider på dagen.
Datum Kalenderdatum.
Tid Tider på dagen
DateRange Datumintervall.
TimeRange Tidsintervall.
Varaktighet Varaktigheter.
Ställ in Ställ in upprepade gånger.
Kvantitet Tal och numeriska kvantiteter.
Antal Tal.
Procent Procentsatser.
Ordning 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 nyckelfraser v2.1

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

Se även