Konfigurowanie semantycznego rangatora i zwracania podpisów w wynikach wyszukiwania

Semantyczny ranking iteruje w początkowym zestawie wyników, stosując metodologię klasyfikacji L2, która promuje najbardziej semantycznie istotne wyniki na szczycie stosu. Możesz również uzyskać podpisy semantyczne z wyróżnieniami na najbardziej odpowiednich terminach i frazach oraz odpowiedziami semantycznymi.

W tym artykule wyjaśniono, jak skonfigurować indeks wyszukiwania pod kątem semantycznego ponownego korbowania.

Wymagania wstępne

• Usługa wyszukiwania w warstwie Podstawowa lub nowsza, 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 ciągów (niewektorów) i działa najlepiej na zawartości, która jest informacyjna lub opisowa.

Wybieranie klienta

Aby dodać konfigurację semantyczną, można użyć dowolnego z następujących narzędzi i zestawów SDK:

• 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 Edm.ComplexType

Witryna Azure Portal

1. Zaloguj się do witryny Azure Portal i przejdź do usługi wyszukiwania, która ma włączoną semantyczną klasyfikację.

2. W obszarze Indeksy w okienku nawigacji po lewej stronie wybierz indeks.

3. Wybierz pozycję Konfiguracje semantyczne, a następnie wybierz pozycję Dodaj konfigurację semantyczną.

   

4. Na stronie Nowa konfiguracja semantyczna wprowadź nazwę konfiguracji semantycznej i wybierz pola do użycia w konfiguracji semantycznej. 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.

   

5. Wybierz pozycję Zapisz , aby zapisać ustawienia konfiguracji.

6. Wybierz ponownie pozycję Zapisz na stronie indeksu, aby zapisać konfigurację semantyczną w indeksie.

Interfejs API REST

1. Sformułuj żądanie tworzenia lub aktualizowania indeksu .

2. 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"
                       }
                   ]
               }
           }
       ]
   }
   

Zestaw SDK platformy .NET

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:

• 2024-07-01 (REST)
• Dziennik zmian zestawu Azure SDK dla platformy .NET (11.5)
• Dziennik zmian zestawu Azure SDK dla języka Python (11.4)
• Dziennik zmian zestawu Azure SDK dla języka Java (11.6)
• Dziennik zmian zestawu Azure SDK dla języka JavaScript (12.0)

queryLanguage for semantic ranker

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.

Przestań używać queryLanguage w kodzie, jeśli używasz go do klasyfikowania semantycznego. Właściwość queryLanguage ma nadal zastosowanie do funkcji, takich jak korekta pisowni, ale nie do klasyfikacji semantycznej.

searchFields for semantic ranker

W przypadku interfejsu API REST i wszystkich pakietów SDK przeznaczonych dla wersji 2021-04-30-Preview i nowszych searchFields właściwość nie jest już używana do klasyfikacji semantycznej.

Zamiast tego użyj semanticConfiguration właściwości (w indeksie wyszukiwania), aby określić, które pola wyszukiwania są używane w klasyfikacji semantycznej. Aby określić priorytetyzacja pól, dodaj element semanticConfiguration do w schemacie indeksu zgodnie z instrukcjami w tym artykule.

Żądania zapytań można zachować searchFields , jeśli używasz ich do ograniczania wyszukiwania pełnotekstowego do listy nazwanych pól.

Następne kroki

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

Tworzenie zapytania semantycznego