Konfigurowanie semantycznego klasyfikowania i zwracania podpis w wynikach wyszukiwania

Artykuł
02/13/2024

W tym artykule dowiesz się, jak wywołać semantyczny ranking w zestawie wyników, promując najbardziej semantycznie istotne wyniki na górze stosu. Można również uzyskać semantyczne podpis z wyróżnionymi terminami i frazami oraz semantycznymi odpowiedziami.

Wymagania wstępne

Usługa wyszukiwania w warstwie Podstawowa, Standardowa (S1, S2, S3) lub Zoptymalizowana pod kątem magazynu (L1, L2), z zastrzeżeniem dostępności regionu.
Semantyczny ranger włączony w usłudze wyszukiwania.
Istniejący indeks wyszukiwania z zawartością tekstu sformatowanego. Klasyfikacja semantyczna ma zastosowanie do pól tekstowych (niewektorów) i działa najlepiej na zawartości, która jest informacyjna lub opisowa.

Wybieranie klienta

Wybierz klienta wyszukiwania, który obsługuje klasyfikację semantyczną. Oto kilka opcji:

Witryna Azure Portal, korzystając z projektanta indeksów, aby dodać konfigurację semantyczną.
Program Visual Studio Code z klientem REST
Zestaw Azure SDK dla platformy .NET
Zestaw Azure SDK dla środowiska Python
Zestaw Azure SDK dla języka Java
Zestaw Azure SDK dla języka JavaScript

Dodawanie konfiguracji semantycznej

Konfiguracja semantyczna to sekcja w indeksie, która ustanawia dane wejściowe pól dla klasyfikacji semantycznej. W dowolnym momencie można dodać lub zaktualizować konfigurację semantyczną bez konieczności ponownego kompilowanie. Jeśli tworzysz wiele konfiguracji, możesz określić wartość domyślną. W czasie wykonywania zapytania określ konfigurację semantyczną w żądaniu zapytania lub pozostaw ją pustą, aby użyć wartości domyślnej.

Konfiguracja semantyczna ma nazwę i następujące właściwości:

Właściwości	Charakterystyki
Pole Tytuł	Krótki ciąg, najlepiej poniżej 25 słów. To pole może być tytułem dokumentu, nazwy produktu lub unikatowego identyfikatora. Jeśli nie masz odpowiedniego pola, pozostaw to pole puste.
Pola zawartości	Dłuższe fragmenty tekstu w postaci języka naturalnego, z zastrzeżeniem maksymalnych limitów wejściowych tokenu w modelach uczenia maszynowego. Typowe przykłady obejmują treść dokumentu, opis produktu lub inny tekst dowolny.
Pola słów kluczowych	Lista słów kluczowych, takich jak tagi w dokumencie lub termin opisowy, taki jak kategoria elementu.

Można określić tylko jedno pole tytułu, ale możesz mieć dowolną liczbę pól zawartości i słów kluczowych. W przypadku pól zawartości i słów kluczowych wyświetl pola w kolejności priorytetów, ponieważ pola o niższym priorytecie mogą zostać obcięte.

We wszystkich właściwościach konfiguracji semantycznej przypisywane pola muszą być następujące:

Przypisano jako i searchableretrievable
Ciągi typu Edm.String, , Collection(Edm.String)podpola ciągów Collection(Edm.ComplexType)

Zaloguj się do witryny Azure Portal i przejdź do usługi wyszukiwania, która ma włączoną semantyczną klasyfikację.
W okienku nawigacji po lewej stronie otwórz indeks.
Wybierz pozycję Konfiguracje semantyczne, a następnie wybierz pozycję Dodaj konfigurację semantyczną.

Zostanie otwarta strona Nowa konfiguracja semantyczna z opcjami wybierania pola tytułu, pól zawartości i pól słów kluczowych. Kwalifikuje się tylko pola ciągów do przeszukiwania i pobierania. Pamiętaj, aby wyświetlić listę pól zawartości i pól słów kluczowych w kolejności priorytetów.

Wybierz przycisk OK , aby zapisać zmiany.

Sformułuj żądanie tworzenia lub aktualizowania indeksu .

Dodaj konfigurację semantyczną do definicji indeksu, na przykład po scoringProfiles lub suggesters. Określenie wartości domyślnej jest opcjonalne, ale przydatne, jeśli masz więcej niż jedną konfigurację.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

Użyj klasy SemanticConfiguration w zestawie Azure SDK dla platformy .NET.

Poniższy przykład pochodzi z semantycznego przykładu klasyfikacji utworzonego przez zespół zestawu Azure SDK.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Migrowanie z wersji zapoznawczych

Jeśli semantyczny kod klasyfikacji korzysta z interfejsów API w wersji zapoznawczej, w tej sekcji wyjaśniono, jak przeprowadzić migrację do stabilnych wersji. Możesz sprawdzić dzienniki zmian pod kątem weryfikacji ogólnej dostępności:

Zmiany zachowania:

Od 14 lipca 2023 r. semantyczny rangą jest niezależny od języka. Wyniki mogą się powtarzać, składające się z wielojęzycznej zawartości, bez stronniczości w stosunku do określonego języka. W wersjach zapoznawczych semantyczna klasyfikacja będzie depriorytizować wyniki różniące się od języka określonego przez analizatora pól.
W wersji 2021-04-30-Preview i wszystkich nowszych wersjach dla interfejsu API REST i wszystkich pakietów SDK przeznaczonych dla tej samej wersji: semanticConfiguration (w definicji indeksu) definiuje pola wyszukiwania używane w klasyfikacji semantycznej. Wcześniej w interfejsie API searchFields REST 2020-06-30-Preview (w żądaniu zapytania) był używany do określania specyfikacji i priorytetyzacji pól. To podejście działało tylko w wersji 2020-06-30-Preview i jest przestarzałe we wszystkich innych wersjach.

Krok 1. Usuwanie elementu queryLanguage

Aparat klasyfikacji semantycznej jest teraz niezależny od języka. Jeśli queryLanguage określono ją w logice zapytania, nie jest już używana do klasyfikacji semantycznej, ale nadal ma zastosowanie do korekty pisowni.

Zachowaj queryLanguage , jeśli używasz sprawdzania pisowni, a wartość języka jest obsługiwana przez funkcję sprawdzania pisowni. Sprawdzanie pisowni ma ograniczoną dostępność w różnych językach.

W przeciwnym razie usuń element queryLanguage.

Krok 2. Zastąp ciąg `searchFields` ciągiem `semanticConfiguration`

Jeśli kod wywołuje pakiety interfejsu API REST 2020-06-30-Preview lub beta SDK przeznaczone dla tej wersji interfejsu API REST, możesz użyć searchFields w żądaniu zapytania w celu określenia pól i priorytetów semantycznych. W początkowych wersjach searchFields beta miał podwójne przeznaczenie, ograniczając początkowe zapytanie do pól wymienionych w searchFieldspliku , a także ustawiając priorytet pola, jeśli użyto klasyfikacji semantycznej. W nowszych wersjach searchFields zachowuje swój pierwotny cel, ale nie jest już używany do klasyfikowania semantycznego.

Zachowaj searchFields w żądaniach zapytań, jeśli używasz ich do ograniczania wyszukiwania pełnotekstowego do listy nazwanych pól.

Dodaj element semanticConfiguration do schematu indeksu, aby określić priorytetyzację pól, postępując zgodnie z instrukcjami w tym artykule.

Następne kroki

Przetestuj konfigurację semantyczną, uruchamiając zapytanie semantyczne.

Tworzenie zapytania semantycznego