Dodawanie sprawdzania pisowni do zapytań w usłudze Foundry IQ (Wyszukiwanie AI platformy Azure) (wersja zapoznawcza)

Uwaga

Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.

Ważne

Sprawdzanie pisowni zapytań jest w publicznej wersji zapoznawczej i podlega Dodatkowym warunkom użytkowania wersji zapoznawczych Microsoft Azure. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcjonalność w wersji zapoznawczej.

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 Foundry IQ w warstwie Podstawowa lub wyższej, 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.

Biblioteka klienta Wersje
interfejs API REST Wersje 2020-06-30-Preview i nowsze. Zalecamy najnowszy interfejs API w wersji zapoznawczej: 2026-11-01-preview
Azure SDK dla .NET wersja 11.7.0-beta.4
Azure SDK dla Java wersja 11.8.0-beta.7
Azure SDK dla języka JavaScript wersja 11.3.0-beta.8
Azure SDK dla Python wersja 11.6.0b12

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-11-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-11-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-11-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)..

Język język zapytań
Angielski [EN] EN, EN-US (ustawienie domyślne)
Hiszpański [ES] ES, ES-ES (ustawienie domyślne)
Francuski [FR] FR, FR-FR (ustawienie domyślne)
Niemiecki [DE] DE, DE-DE (ustawienie domyślne)
Holenderski [NL] NL, NL-BE, NL-NL (ustawienie domyślne)

Uwaga

Wcześniej, gdy semantyczny ranker był w wersji zapoznawczej, parametr queryLanguage był również używany do rankingu semantycznego. Semantic ranker jest teraz niezależny od języka.

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ć, jak biblioteki językowe są używane w Foundry IQ (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 .

Uwaga

Spójność języka w różnych wartościach właściwości jest problemem tylko wtedy, gdy używasz analizatorów języka. Jeśli używasz językowo niezależnych analizatorów (takich jak keyword, simple, standard, stop, whitespace lub standardasciifolding.lucene), to wartość queryLanguage może być dowolna.

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