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.

Dzienniki zmian zestawów SDK platformy Azure

Aby określić, które funkcje semantyczne są dostępne w określonym pakiecie zestawu Azure SDK i czy zmieniono nazwy interfejsów API, zobacz dziennik zmian zestawu SDK:

• 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 itworzenia 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.