Udostępnij przez

Migrowanie do najnowszej wersji języka sztucznej inteligencji platformy Azure

  • Artykuł

Porada

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 języka ujednoliconego (interfejs API REST)

Ta sekcja dotyczy aplikacji korzystających ze starszego /text/analytics/... formatu punktu końcowego na potrzeby 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 zmieniono format treści żądania JSON. Musisz zaktualizować strukturę żądań wysyłaną przez aplikację 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 korzystać z najnowszej wersji biblioteki klienta, należy pobrać najnowszy pakiet oprogramowania w Azure.AI.TextAnalytics przestrzeni nazw. Zapoznaj się z powyższymi artykułami Szybkiego startu, aby zapoznać się z przykładowym kodem i instrukcjami dotyczącymi korzystania z 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 wysł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 "negatywne") zarówno dla zdań, jak i dokumentu jako całości, oraz skojarzone z nimi oceny 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 żądania łączenia jednostek . Ponadto możesz użyć innej funkcji oferowanej w usłudze językowej, która umożliwia wykrywanie informacji osobistych (PII) i 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
Person (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).
E-mail Email adresy.
Adres URL Adresy URL witryn sieci Web.
Adres IP Adresy IP sieci.
DateTime Daty i godziny dnia.
Date Kalender daty.
Godzina Godziny dnia
Zakres dat Zakresy dat.
Zakres czasu Zakresy czasu.
Czas trwania Czas trwania.
Set Ustawiaj, powtarzane czasy.
Liczba Liczby i ilości liczbowe.
Liczba Numery.
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 wartość 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ż