Migrace na nejnovější verzi jazyka Azure AI

Článek
11/21/2024

Tip

Teprve začínáte používat Azure AI Language? Podrobnosti o službě, dostupných funkcích a odkazech na rychlé starty najdete v článku s přehledem informací o aktuální verzi rozhraní API.

Pokud vaše aplikace stále používají rozhraní API Analýza textu nebo klientskou knihovnu (před stabilní verzí 5.1.0), pomůže vám tento článek upgradovat aplikace tak, aby používaly nejnovější verzi jazykových funkcí Azure AI.

Koncový bod sjednoceného jazyka (REST API)

Tato část se týká aplikací, které používají starší /text/analytics/... formát koncového bodu pro volání rozhraní REST API. Příklad:

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

Pokud vaše aplikace používá výše uvedený formát koncového bodu, změnil se koncový bod rozhraní REST API pro následující funkce služby jazyka:

Služba Language teď poskytuje jednotný koncový bod pro odesílání požadavků rozhraní REST API do těchto funkcí. Pokud vaše aplikace používá rozhraní REST API, aktualizujte koncový bod požadavku tak, aby používala aktuální koncový bod:

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

Kromě toho se změnil formát textu požadavku JSON. Budete muset aktualizovat strukturu požadavků, kterou vaše aplikace odesílá do rozhraní API, například následující text JSON pro rozpoznávání entit:

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

Pomocí výše uvedených rychlých startů zobrazíte aktuální ukázková volání rozhraní REST API pro funkce, které používáte, a přidružený výstup rozhraní API.

Klientské knihovny

Pokud chcete použít nejnovější verzi klientské knihovny, budete muset stáhnout nejnovější softwarový balíček v Azure.AI.TextAnalytics oboru názvů. Podívejte se na články rychlého startu, které jsou uvedené výše, například kód a pokyny pro použití klientské knihovny ve vašem preferovaném jazyce.

Změny funkcí verze 2.1

Pokud migrujete aplikaci z rozhraní API verze 2.1, existuje několik změn funkcí, o kterých byste měli vědět.

Analýza mínění v2.1

Analýza mínění ve verzi 2.1 vrací skóre mínění mezi 0 a 1 pro každý dokument odeslaný do rozhraní API s skóre blížícím se 1, které udávají pozitivnější mínění. Aktuální verze této funkce vrací popisky mínění (například "kladné" nebo "záporné") pro věty i dokument jako celek a jejich přidružené skóre spolehlivosti.

Propojení NER, PII a entit v2.1

Ve verzi 2.1 použilo rozhraní API Analýza textu jeden koncový bod pro rozpoznávání pojmenovaných entit (NER) a propojení entit. Aktuální verze této funkce poskytuje rozšířené rozpoznávání pojmenovaných entit a má samostatné koncové body pro požadavky na propojení NER a entit . Kromě toho můžete použít jinou funkci nabízenou ve službě Language, která umožňuje detekovat osobní (PII) a informace o stavu (PHI).

Budete také muset aktualizovat aplikaci tak, aby používala kategorie entit vrácené v odpovědi rozhraní API.

Kategorie entit verze 2.1

Následující tabulka uvádí kategorie entit vrácené pro NER v2.1.

Kategorie	Popis
Osoba	Jména lidí.
Umístění	Přírodní a lidské památky, struktury, geografické prvky a geopolitické entity
Organizace	Společnosti, politické skupiny, hudební kapely, sportovní kluby, vládní orgány a veřejné organizace. V tomto typu entity nejsou zahrnuté státní příslušnosti a náboženství.
PhoneNumber	Telefonní čísla (pouze telefonní čísla USA a EU).
E-mail	E-mailové adresy
Adresa URL	Adresy URL na weby.
IP	Síťové IP adresy.
DateTime	Data a časy dne.
Datum	Kalendářní data.
Čas	Denní časy
Rozsah dat	Rozsahy kalendářních dat.
Časový rozsah	Časové rozsahy.
Doba trvání	Doby trvání.
Nastavit	Nastavte opakované časy.
Množství	Čísla a číselné množství
Počet	Čísla.
Procento	Procenta.
Řadová číslovka	Pořadová čísla.
Věk	Věky.
Měna	Měny.
Dimenze	Rozměry a měření.
Teplota	Teploty.

Rozpoznávání jazyka v2.1

Výstup funkce rozpoznávání jazyka se v aktuální verzi změnil. Odpověď JSON bude obsahovat ConfidenceScore místo score. Aktuální verze také vrací pouze jeden jazyk pro každý dokument.

Extrakce klíčových frází v2.1

Funkce extrakce klíčových frází se v současné době nezměnila mimo koncový bod a formát požadavku.

Viz také

Co je jazyk Azure AI?
Příručka pro vývojáře jazykových služeb
Informace o předchozích verzích rozhraní API najdete v následující referenční dokumentaci.
Následující úvodní příručky vám pomůžou zobrazit příklady aktuální verze těchto funkcí.

Sdílet prostřednictvím