Migrowanie semantycznego kodu klasyfikacji z poprzednich wersji

Jeśli semantyczny kod klasyfikacji został napisany względem interfejsów API wczesnej wersji zapoznawczej, ten artykuł identyfikuje zmiany kodu niezbędne do migracji do nowszych wersji interfejsu API. Zmiany powodujące niezgodność dla klasyfikatora semantycznego są ograniczone do logiki zapytań w ostatnich interfejsach API, ale jeśli kod został napisany w początkowej wersji zapoznawczej, może być konieczne również zmianę konfiguracji semantycznej.

Zmiany powodujące niezgodność

Istnieją dwie zmiany powodujące niezgodność dla semantycznego rankera w różnych wersjach interfejsu API REST:

• searchFields został zastąpiony w semanticConfiguration wersji 2021-04-30-preview
• queryLanguage został zignorowany od 2023-07-01-preview, ale przywrócono ponowne zapisywanie zapytań w wersji 2024-11-01-preview

Inne aktualizacje specyficzne dla wersji dotyczą nowych funkcji, ale nie przerywają istniejącego kodu i w związku z tym nie przerywają zmian.

Jeśli używasz zestawów SDK platformy Azure, z upływem czasu zmieniono nazwy wielu interfejsów API. Dzienniki zmian zestawu SDK zawierają szczegółowe informacje.

Wersje interfejsu API zapewniające klasyfikację semantyczną

Sprawdź kod wersji interfejsu API REST lub wersji pakietu ZESTAWU SDK, aby potwierdzić, który z nich zapewnia klasyfikację semantyczną. Następujące wersje interfejsu API mają pewien poziom obsługi klasyfikacji semantycznej.

Typ wydania	Wersja interfejsu API REST	Aktualizacje klasyfikatora semantycznego
inicjał	2020-06-30-preview	Dodaje queryType=semantic do dokumentów wyszukiwania
preview	2021-04-30-preview	Dodaje semanticConfiguration polecenie do tworzenia lub aktualizowania indeksu
preview	2023-07-01-preview	Aktualizuje semanticConfigurationprogram . Począwszy od 14 lipca 2023 r., aktualizacje modeli semantycznych hostowanych przez firmę Microsoft wykonane semantyczne klasyfikator języka niezależnego od klasy, skutecznie likwidując queryLanguage właściwość na potrzeby klasyfikacji semantycznej. Nie ma żadnych zmian powodujących niezgodność w kodzie, ale właściwość jest ignorowana. Klienci zostali poinformowani o usunięciu tej właściwości z kodu.
preview	2023-10-01-preview	Dodaje semanticQuery do wysyłania zapytania używanego tylko do celów ponownego korbowania.
stajnia	2023-11-01	Ogólnie dostępne. Wprowadzono zmiany w semanticConfiguration tej wersji, które zostały wprowadzone w stabilnej wersji. Jeśli kod jest przeznaczony dla tej wersji lub nowszej, jest zgodny z nowszymi wersjami interfejsu API, chyba że przyjmujesz nowe funkcje w wersji zapoznawczej.
preview	2024-05-01-preview	Bez zmian
stajnia	2024-07-01	Bez zmian
preview	2024-09-01-preview	Bez zmian
preview	2024-11-01-preview	Dodaje ponowne zapisywanie zapytań. Właściwość jest teraz wymagana queryLanguage , jeśli używasz ponownego zapisywania zapytań (wersja zapoznawcza).

Dzienniki zmian zestawów SDK platformy Azure

Zestawy SDK platformy Azure są zgodnie z niezależnym harmonogramem wydania. Należy sprawdzić dzienniki zmian, aby określić, które pakiety udostępniają funkcje semantyczne i czy zmieniono nazwy interfejsów API.

• Dziennik zmian zestawu Azure SDK dla platformy .NET
• Dziennik zmian zestawu Azure SDK dla języka Python
• Dziennik zmian zestawu Azure SDK dla języka Java
• Dziennik zmian zestawu Azure SDK dla języka JavaScript

2024-11-01-preview

• Dodaje ponowne zapisywanie zapytań w dokumentach wyszukiwania.
• Wymaga queryLanguage obsługi obciążeń ponownego zapisywania zapytań. Aby uzyskać listę prawidłowych wartości, zobacz interfejs API REST.

2024-09-01-preview

Brak zmian w składni klasyfikacji semantycznej ze stabilnej wersji 2024-07-01.

2024-07-01

Brak zmian w składni klasyfikacji semantycznej z wersji 2024-05-01-preview.

Nie używaj tej wersji interfejsu API. Implementuje on składnię zapytania wektorowego, która jest niezgodna z dowolną nowszą wersją interfejsu API.

2024-05-01-preview

Brak zmian w składni klasyfikacji semantycznej z wersji 2024-03-01-preview.

2024-03-01-preview

Nie wprowadzono żadnych zmian w składni klasyfikacji semantycznej z wersji 2023-10-01-preview, ale wprowadzono zapytania wektorowe. Klasyfikacja semantyczna ma teraz zastosowanie do odpowiedzi z zapytań hybrydowych i wektorowych. Można zastosować ponowne korbowanie dla dowolnych pól tekstowych czytelnych dla człowieka w odpowiedzi, przy założeniu, że pola są wymienione w prioritizedFieldspliku .

2023-11-01

• SemanticDebug Wyklucza i semanticQuery, w przeciwnym razie jest to samo co wersja zapoznawcza 2023-10-01-preview.

2023-10-01-preview

• Dodaje semanticQuery

2023-07-01-preview

• Dodaje semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Dodaje wiele pól związanych z semantyczną odpowiedzią, takich jak SemanticDebug i SemanticErrorMode.
• Ignoruje queryLanguageelement , nie jest już używany w klasyfikacji semantycznej.

Począwszy od 14 lipca 2023 r., semantyczny rangą jest niezależny od języka. W wersjach zapoznawczych semantyczna klasyfikacja będzie depriorytizować wyniki różniące się od querylanguage określonych przez analizatora pól. queryLanguage Jednak właściwość nadal ma zastosowanie do korekty pisowni i krótkiej listy języków obsługiwanych przez tę funkcję.

2021-04-30-preview

• Obsługa semantyczna odbywa się za pośrednictwem interfejsu API wyszukiwania i tworzenia lub aktualizowania indeksu w wersji zapoznawczej.
• Dodaje semanticConfiguration do indeksu wyszukiwania. Konfiguracja semantyczna ma nazwę i priorytetową listę pól.
• Dodaje pole "priorytetowe".

Właściwość searchFields nie jest już używana do określania priorytetów pól. We wszystkich wersjach semanticConfiguration.prioritizedFields zamienia searchFields się jako mechanizm określania pól do użycia na potrzeby klasyfikacji L2.

2020-06-30-preview

• Obsługa semantyczna odbywa się za pomocą wywołania interfejsu API podglądu dokumentów wyszukiwania.
• Dodaje queryType=semantic do żądania zapytania.
• Dostosowuje się searchFields tak, aby jeśli typ zapytania jest semantyczny, searchFields właściwość określa kolejność priorytetu danych wejściowych pól do semantycznego rankera.
• Dodaje captionselement , answersi highlights do odpowiedzi zapytania.

Następne kroki

Przetestuj migrację konfiguracji semantycznej, uruchamiając zapytanie semantyczne.

Tworzenie zapytania semantycznego