Delen via

Migreren naar de nieuwste versie van Azure AI Language

  • Artikel

Tip

Bent u net 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 v5.1.0), helpt dit artikel u bij het upgraden van uw toepassingen om de nieuwste versie van de Azure AI-taalfuncties te gebruiken.

Eindpunt voor Unified Language (REST API)

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

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 Language-service 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 hoofdtekst van de JSON-aanvraag 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 REST API-aanroepen te zien voor de functies die u gebruikt en de bijbehorende API-uitvoer.

Clientbibliotheken

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

Functionaliteitswijzigingen van versie 2.1

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

Sentimentanalyse v2.1

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

NER, PII en entiteitskoppeling v2.1

In versie 2.1 heeft de Text Analytics-API één eindpunt gebruikt voor NER (Named Entity Recognition) en entity linking. 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 (PII) en gezondheidsinformatie (PHI) kunt detecteren.

U moet uw toepassing ook 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
Persoon Namen van personen.
Locatie Natuurlijke en menselijke oriëntatiepunten, structuren, geografische kenmerken en geopolitieke entiteiten
Organisatie Bedrijven, politieke groepen, muzikale bands, sportclubs, overheidsinstanties en publieke organisaties. Nationaliteiten en religies zijn niet opgenomen in dit entiteitstype.
PhoneNumber Telefoonnummers (alleen amerikaanse en EU-telefoonnummers).
E-mailen E-mailadressen.
URL URL's naar websites.
IP IP-adressen van het netwerk.
Datum en tijd Datums en tijden van de dag.
Datum Kalenderdatums.
Tijd Tijdstippen van de dag
DateRange Datumbereiken.
TimeRange Tijdsbereiken.
Duur Duur.
Instellen Instellen, herhaalde tijden.
Hoeveelheid Getallen en numerieke hoeveelheden.
Aantal Cijfers.
Percentage Percentages.
Rangtelwoord Rangtelwoorden.
Leeftijd Leeftijden.
Valuta Valuta.
Dimensie Afmetingen en afmetingen.
Temperatuur Temperaturen.

Taaldetectie v2.1

De uitvoer van de taaldetectiefunctie 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 het eindpunt en de aanvraagindeling.

Zie ook