Migreren naar de nieuwste versie van Azure AI Language

  • Artikel

Tip

Aan de slag met Azure AI Language? Zie het overzichtsartikel voor meer informatie over de service, beschikbare functies en koppelingen naar quickstarts voor informatie over de huidige versie van de API.

Als uw toepassingen nog steeds gebruikmaken van de Text Analytics API of clientbibliotheek (vóór stabiele versie 5.1.0), kunt u in dit artikel uw toepassingen upgraden om de nieuwste versie van de Azure AI-taalfuncties te gebruiken.

Unified Language-eindpunt (REST API)

Deze sectie is van toepassing op toepassingen die gebruikmaken van de oudere /text/analytics/... eindpuntindeling voor REST API-aanroepen. Bijvoorbeeld:

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

Als uw toepassing de bovenstaande eindpuntindeling gebruikt, is het REST API-eindpunt voor de volgende taalservicefuncties gewijzigd:

De Taalservice biedt nu een geïntegreerd eindpunt voor het verzenden van REST API-aanvragen naar deze functies. Als uw toepassing gebruikmaakt van de REST API, werkt u het aanvraageindpunt bij om het huidige eindpunt te gebruiken:

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

Daarnaast is de indeling van de JSON-aanvraagbody gewijzigd. U moet de aanvraagstructuur bijwerken die uw toepassing naar de API verzendt, bijvoorbeeld de volgende JSON-hoofdtekst voor entiteitsherkenning:

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

Gebruik de quickstarts die hierboven zijn gekoppeld om de huidige voorbeeld-REST API-aanroepen te bekijken voor de functie(s) die u gebruikt en de bijbehorende API-uitvoer.

Clientbibliotheken

Als u de nieuwste versie van de clientbibliotheek wilt gebruiken, moet u het nieuwste softwarepakket downloaden in de Azure.AI.TextAnalytics naamruimte. Zie de snelstartartikelen die hierboven zijn gekoppeld voor bijvoorbeeld code en instructies voor het gebruik van de clientbibliotheek in uw voorkeurstaal.

Wijzigingen in versie 2.1-functionaliteit

Als u een toepassing migreert vanuit v2.1 van de API, zijn er verschillende wijzigingen in de functiefunctionaliteit waarmee u rekening moet houden.

Sentimentanalyse v2.1

Sentimentanalyse in versie 2.1 retourneert gevoelsscores tussen 0 en 1 voor elk document dat naar de API wordt verzonden, met scores dichter bij 1 die wijzen op een positiever gevoel. De huidige versie van deze functie retourneert gevoelslabels (zoals 'positief' of 'negatief') voor zowel de zinnen als het document als geheel, en de bijbehorende betrouwbaarheidsscores.

NER, PII en entiteitskoppeling v2.1

In versie 2.1 gebruikte de Text Analytics-API één eindpunt voor Named Entity Recognition (NER) en entiteitskoppeling. De huidige versie van deze functie biedt uitgebreide detectie van benoemde entiteiten en heeft afzonderlijke eindpunten voor NER - en entiteitskoppelingsaanvragen . Daarnaast kunt u een andere functie gebruiken die wordt aangeboden in de taalservice waarmee u persoonlijke gegevens (PII) en statusgegevens (PHI) kunt detecteren.

U moet ook uw toepassing bijwerken om de entiteitscategorieën te gebruiken die worden geretourneerd in het antwoord van de API.

Entiteitscategorieën versie 2.1

De volgende tabel bevat de entiteitscategorieën die worden geretourneerd voor NER v2.1.

Categorie Beschrijving
Person Namen van personen.
Locatie Natuurlijke en door de mens gemaakte oriëntatiepunten, structuren, geografische kenmerken en geopolitieke entiteiten
Organisatie Bedrijven, politieke groepen, muziekgroepen, sportclubs, overheidsinstanties en publieke organisaties. Nationaliteiten en religies zijn niet opgenomen in dit entiteitstype.
PhoneNumber Telefoonnummers (alleen telefoonnummers in de VS en de EU).
Email Email adressen.
URL URL's naar websites.
IP IP-adressen van het netwerk.
DateTime Datums en tijden van de dag.
Date Kalenderdatums.
Tijd Tijden van de dag
DateRange Datumbereiken.
TimeRange Tijdsbereiken.
Duur Duur.
Instellen Instellen, herhaalde tijden.
Aantal Getallen en numerieke hoeveelheden.
Aantal Getallen.
Percentage Percentages.
Rangtelwoord Rangtelwoorden.
Leeftijd Leeftijden.
Valuta Valuta.
Dimensie Afmetingen en afmetingen.
Temperatuur Temperaturen.

Taaldetectie v2.1

De uitvoer van de functie taaldetectie is gewijzigd in de huidige versie. Het JSON-antwoord bevat ConfidenceScore in plaats van score. De huidige versie retourneert ook slechts één taal voor elk document.

Sleuteltermextractie v2.1

De functie voor sleuteltermextractie is momenteel niet gewijzigd buiten de indeling van het eindpunt en de aanvraag.

Zie ook