Migrace na nejnovější verzi jazyka Azure AI

  • Článek

Tip

Začínáte s Jazykem Azure AI? Podrobnosti o službě, dostupných funkcích a odkazy na rychlé starty najdete v článku s přehledem , kde najdete informace 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), tento článek vám pomůže upgradovat aplikace tak, aby používaly nejnovější verzi funkcí jazyka Azure AI.

Koncový bod sjednoceného jazyka (REST API)

Tato část se týká aplikací, které pro volání rozhraní REST API používají starší /text/analytics/... formát koncového bodu. 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 jazykové služby:

Služba Language teď poskytuje jednotný koncový bod pro odesílání požadavků rozhraní REST API na tyto funkce. Pokud vaše aplikace používá rozhraní REST API, aktualizujte koncový bod žádosti tak, aby používal 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ů si můžete prohlédnout aktuální příklad volání rozhraní REST API pro funkce, které používáte, a související výstup rozhraní API.

Klientské knihovny

Pokud chcete používat nejnovější verzi klientské knihovny, budete si muset stáhnout nejnovější balíček softwaru v Azure.AI.TextAnalytics oboru názvů. Projděte si výše uvedené články rychlého startu, kde najdete příklad kódu a pokyny pro použití klientské knihovny v preferovaném jazyce.

Změny funkcí verze 2.1

Pokud migrujete aplikaci z rozhraní API verze 2.1, měli byste mít na paměti několik změn funkcí.

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

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

NER, PII a entity linking v2.1

Ve verzi 2.1 rozhraní API Analýza textu používalo jeden koncový bod pro rozpoznávání pojmenovaných entit (NER) a propojení entit. Aktuální verze této funkce poskytuje rozšířenou detekci pojmenovaných entit a obsahuje samostatné koncové body pro žádosti o propojení NER a entit . Kromě toho můžete použít další funkci nabízenou ve službě Jazyk, která umožňuje zjišťovat osobní (PII) a informace o zdraví (PHI).

Budete také muset aplikaci aktualizovat 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ých pro NER v2.1.

Kategorie Popis
Person (Osoba) Jména lidí.
Umístění Přírodní a lidské památky, struktury, geografické rysy a geopolitické entity
Organizace Společnosti, politické skupiny, hudební kapely, sportovní kluby, státní 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 PRO USA a EU).
E-mail Email adresy.
URL Adresy URL na weby.
IP adresa 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 Nastavené, opakované časy.
Množství Čísla a číselné veličiny.
Číslo Čísla.
Procento Procenta.
Řádová číslovka Pořadová čísla.
Věk Věkových kategorií.
Měna Měny.
Dimenze Rozměry a rozměry.
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 funkce extrakce klíčových frází se v současné době nezměnila mimo formát koncového bodu a požadavku.

Viz také