Udostępnij za pośrednictwem

Migrowanie do najnowszej wersji języka sztucznej inteligencji platformy Azure

  • Artykuł

Napiwek

Dopiero zaczynasz pracę z językiem sztucznej inteligencji platformy Azure? Zobacz artykuł z omówieniem, aby uzyskać szczegółowe informacje na temat usługi, dostępnych funkcji i linków do przewodników Szybki start, aby uzyskać informacje na temat bieżącej wersji interfejsu API.

Jeśli aplikacje nadal korzystają z interfejsu API analiza tekstu lub biblioteki klienta (przed stabilną wersją 5.1.0), ten artykuł pomoże Ci uaktualnić aplikacje do korzystania z najnowszej wersji funkcji języka sztucznej inteligencji platformy Azure.

Punkt końcowy ujednoliconego języka (interfejs API REST)

Ta sekcja dotyczy aplikacji korzystających ze starszego /text/analytics/... formatu punktu końcowego dla wywołań interfejsu API REST. Na przykład:

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

Jeśli aplikacja używa powyższego formatu punktu końcowego, punkt końcowy interfejsu API REST dla następujących funkcji usługi językowej uległ zmianie:

Usługa językowa udostępnia teraz ujednolicony punkt końcowy do wysyłania żądań interfejsu API REST do tych funkcji. Jeśli aplikacja używa interfejsu API REST, zaktualizuj punkt końcowy żądania, aby używał bieżącego punktu końcowego:

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

Ponadto format treści żądania JSON został zmieniony. Należy zaktualizować strukturę żądań, którą aplikacja wysyła do interfejsu API, na przykład następującą treść JSON rozpoznawania jednostek:

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

Skorzystaj z przewodników Szybki start połączonych powyżej, aby wyświetlić bieżące przykładowe wywołania interfejsu API REST dla używanych funkcji i skojarzonych danych wyjściowych interfejsu API.

Biblioteki klienta

Aby użyć najnowszej wersji biblioteki klienta, należy pobrać najnowszy pakiet oprogramowania w Azure.AI.TextAnalytics przestrzeni nazw. Zapoznaj się z powyższymi artykułami szybki start, aby zapoznać się z przykładowym kodem i instrukcjami dotyczącymi używania biblioteki klienta w preferowanym języku.

Zmiany funkcji w wersji 2.1

W przypadku migrowania aplikacji z wersji 2.1 interfejsu API należy pamiętać o kilku zmianach funkcji.

Analiza tonacji w wersji 2.1

Analiza tonacji w wersji 2.1 zwraca wyniki tonacji z zakresu od 0 do 1 dla każdego dokumentu wysyłanego do interfejsu API z wynikami zbliżonymi do 1 wskazującymi bardziej pozytywną tonację. Bieżąca wersja tej funkcji zwraca etykiety tonacji (takie jak "pozytywne" lub "ujemne") zarówno dla zdań, jak i dokumentu jako całości oraz skojarzone z nimi wskaźniki ufności.

Łączenie jednostek NER, PII i entity linking w wersji 2.1

W wersji 2.1 interfejs API analiza tekstu używał jednego punktu końcowego do rozpoznawania jednostek nazwanych (NER) i łączenia jednostek. Bieżąca wersja tej funkcji zapewnia rozszerzone wykrywanie nazwanych jednostek i ma oddzielne punkty końcowe dla żądań NER i żądań łączenia jednostek . Ponadto możesz użyć innej funkcji oferowanej w usłudze językowej, która umożliwia wykrywanie informacji osobistych (PII) i informacji o kondycji (PHI).

Należy również zaktualizować aplikację, aby korzystała z kategorii jednostek zwróconych w odpowiedzi interfejsu API.

Kategorie jednostek w wersji 2.1

W poniższej tabeli wymieniono kategorie jednostek zwrócone dla NER w wersji 2.1.

Kategoria opis
Osoba Nazwiska osób.
Lokalizacja Naturalne i ludzkie punkty orientacyjne, struktury, cechy geograficzne i jednostki geopolityczne
Organizacja Firmy, grupy polityczne, zespoły muzyczne, kluby sportowe, organy rządowe i organizacje publiczne. Narodowości i religie nie są uwzględnione w tym typie jednostki.
PhoneNumber Numery telefonów (tylko numery telefonów USA i UE).
Email Adresy e-mail.
URL Adresy URL witryn sieci Web.
Adres IP Adresy IP sieci.
DateTime Daty i godziny dnia.
Data Kalender daty.
Czas Godziny dnia
Zakres dat Zakresy dat.
Zakres czasu Zakresy czasu.
Czas trwania Czas trwania.
Zestaw Ustawiaj, powtarzane czasy.
Ilość Liczby i ilości liczbowe.
Liczba Liczby.
Procent Procenty.
Liczba porządkowa Liczby porządkowe.
Wiek Wieku.
Waluta Walut.
Wymiar Wymiary i pomiary.
Temperatura Temperatury.

Wykrywanie języka w wersji 2.1

Dane wyjściowe funkcji wykrywania języka zmieniły się w bieżącej wersji. Odpowiedź JSON będzie zawierać ConfidenceScore zamiast score. Bieżąca wersja zwraca również tylko jeden język dla każdego dokumentu.

Wyodrębnianie kluczowych fraz w wersji 2.1

Funkcja wyodrębniania kluczowych fraz nie zmieniła się obecnie poza punktem końcowym i formatem żądania.

Zobacz też