Dodawanie sprawdzania pisowni do zapytań w Wyszukiwanie AI platformy Azure (wersja zapoznawcza)

Możesz poprawić odnalezienie wyników, korygując pisownię słów w zapytaniu przed dotarciem do wyszukiwarki. speller Parametr (wersja zapoznawcza) jest obsługiwany dla wszystkich typów zapytań tekstowych (niewektorowych) i jest dostępny za pośrednictwem portalu Azure, interfejsów API REST w wersji zapoznawczej i wersji beta bibliotek Azure SDK.

Wymagania wstępne

• Usługa wyszukiwania w warstwie Podstawowa lub nowsza w dowolnym regionie.

• Istniejący indeks wyszukiwania z zawartością w obsługiwanym języku.

• Żądanie zapytania zawierające speller=lexicon i queryLanguage ustawione na obsługiwany język. Sprawdzanie pisowni działa na ciągach przekazanych w parametrze search . Nie jest obsługiwany w przypadku filtrów, wyszukiwania rozmytego, wyszukiwania wieloznacznych, wyrażeń regularnych ani zapytań wektorowych.

Użyj klienta wyszukiwania, który obsługuje interfejsy API w wersji zapoznawczej w żądaniu zapytania. Możesz użyć klienta REST lub wersji beta Azure SDKs.

Korekta pisowni przy użyciu prostego wyszukiwania

W poniższym przykładzie użyto indeksu hotels-sample , aby zademonstrować korektę pisowni w prostym zapytaniu tekstowym. Bez korekty pisowni zapytanie zwraca zero wyników. Po wprowadzeniu poprawek, zapytanie zwraca jeden wynik dla ośrodka wypoczynkowego przyjaznego rodzinom Johnsona.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "famly acitvites",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "queryType": "simple",
    "select": "HotelId,HotelName,Description,Category,Tags",
    "count": true
}

Korekta ortograficzna przy użyciu pełnego Lucene

Korekta pisowni występuje na poszczególnych terminach zapytania, które przechodzą analizę tekstu, dlatego można użyć parametru sprawdzania pisowni z niektórymi zapytaniami Lucene, ale nie innymi.

• Niezgodne formularze zapytań, które pomijają analizę tekstu, obejmują: symbol wieloznaczny, regex, rozmyty
• Zgodne formularze zapytań obejmują: wyszukiwanie po polach, zapytanie o bliskość, wzmocnienie trafności terminów

W tym przykładzie użyto wyszukiwania w polu "Kategoria" przy użyciu pełnej składni Lucene, a zapytanie zawiera błędnie napisany termin. Dzięki włączeniu korektora pisowni literówka w poleceniu "Suiite" została poprawiona i zapytanie zakończy się powodzeniem.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "Category:(Resort and Spa) OR Category:Suiite",
    "queryType": "full",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "select": "Category",
    "count": true
}

Korekta pisowni z klasyfikacją semantyczną

To zapytanie, zawierające literówki w każdym terminie z wyjątkiem jednego, przechodzi korektę pisowni, aby zwrócić odpowiednie wyniki. Aby dowiedzieć się więcej, zobacz Konfigurowanie klasyfikatora semantycznego.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "hisotoric hotell wiht great restrant nad wiifi",
    "queryType": "semantic",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "searchFields": "HotelName,Tags,Description",
    "select": "HotelId,HotelName,Description,Category,Tags",
    "count": true
}

Obsługiwane języki

Prawidłowe wartości queryLanguage można znaleźć w poniższej tabeli skopiowanej z listy obsługiwanych języków (dokumentacja interfejsu API REST)..

Zagadnienia dotyczące analizatora języka

Indeksy zawierające zawartość inną niż angielska często używają analizatorów języków w polach innych niż angielski, aby zastosować reguły językowe języka natywnego.

Podczas dodawania sprawdzania pisowni do zawartości, która również przechodzi analizę języka, można uzyskać lepsze wyniki przy użyciu tego samego języka dla każdego kroku indeksowania i przetwarzania zapytań. Jeśli na przykład zawartość pola została zindeksowana przy użyciu analizatora języka "fr.microsoft", zapytania i sprawdzanie pisowni powinny używać francuskiego leksykonu lub biblioteki językowej jakiejś formy.

Aby podsumować sposób użycia bibliotek językowych w Wyszukiwanie AI platformy Azure:

• Analizatory języka mogą być wywoływane podczas indeksowania i wykonywania zapytań i są albo Apache Lucene (na przykład "de.lucene") albo Microsoft ("de.microsoft").

• Leksykony języka wywoływane podczas sprawdzania pisowni są określane przy użyciu jednego z kodów języka w tabeli obsługiwanych języków .

W żądaniu zapytania wartość przypisana do queryLanguage elementu ma zastosowanie do spellerelementu .

Podczas gdy zawartość w indeksie wyszukiwania może składać się w wielu językach, dane wejściowe zapytania są najprawdopodobniej w jednym. Wyszukiwarka nie sprawdza zgodności analizatora queryLanguagejęzyka i języka, w którym składa się zawartość, dlatego należy odpowiednio ograniczyć zakres zapytań, aby uniknąć generowania nieprawidłowych wyników.

Następne kroki

• Tworzenie zapytania podstawowego
• Używanie pełnej składni zapytań Lucene
• Używanie prostej składni zapytań