Helyesírás-ellenőrzés hozzáadása a lekérdezésekhez Azure AI Keresés (előzetes verzió)

A visszahívást úgy javíthatja, hogy helyesírás-javítást végez egy lekérdezésben, mielőtt azok elérnék a keresőmotort. A speller paraméter (előzetes verzió) minden szöveges (nem vektoros) lekérdezéstípushoz támogatott, és a Azure portálon, az előzetes verziójú REST API-kon és a Azure SDK kódtárak bétaverzióján keresztül érhető el.

Előfeltételek

• Keresési szolgáltatás az alapszintű vagy annál magasabb szinten, bármely régióban.

• Meglévő keresési index támogatott nyelvű tartalommal.

• Egy olyan lekérési kérelem, amelyben a speller=lexicon és a queryLanguage egy támogatott nyelvre van beállítva. A helyesírás-ellenőrzés az search paraméterben átadott sztringeken működik. Nem támogatott szűrők, homályos keresés, helyettesítő karakterek keresése, reguláris kifejezések vagy vektoros lekérdezések esetén.

Használjon olyan keresési ügyfelet, amely támogatja az előzetes verziójú API-kat a lekérdezési kérelemben. Használhat REST-ügyfelet vagy a Azure SDK-k bétaverzióját.

Helyesírás-javítás egyszerű kereséssel

Az alábbi példa a hotels-sample index használatával mutatja be a helyesírás-javítást egy egyszerű szöveges lekérdezésen. Helyesírás-javítás nélkül a lekérdezés nulla eredményt ad vissza. A javítással a lekérdezés egy eredményt ad vissza Johnson családközpontú üdülőhelyéhez.

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
}

Helyesírás-javítás teljes Lucene-val

A helyesírás-javítás a szövegelemzésen átesett egyes lekérdezési kifejezéseken történik, ezért használhatja a helyesírás-ellenőrző paramétert néhány Lucene-lekérdezéssel, másokkal azonban nem.

• A szövegelemzést megkerülő nem kompatibilis lekérdezési űrlapok a következők: helyettesítő karakter, regex, fuzzy
• A kompatibilis lekérdezési űrlapok a következők: mezős keresés, közelség, kifejezésnövelés

Ez a példa a Kategória mezőn végzett mezőalapú keresést használja teljes Lucene szintaxissal és egy hibásan írt lekérdezési kifejezéssel. A helyesírás-ellenőrző révén a "Suiite" elírása javítva lett, és a lekérdezés sikeres volt.

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
}

Helyesírás-javítás szemantikai rangsorolással

Ez a lekérdezés egy kivételével minden kifejezésben elírásokat tartalmaz, és helyesírás-javításon megy keresztül a releváns eredmények visszaadása érdekében. További információ: Szemantikai rangsoroló konfigurálása.

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
}

Támogatott nyelvek

Az érvényes értékek queryLanguage az alábbi táblázatban találhatók, a támogatott nyelvek listájából másolva (REST API-referencia).

Nyelvelemző szempontok

A nem angol nyelvű tartalmakat tartalmazó indexek gyakran használnak nyelvelemzőket a nem angol nyelvű mezőkön az anyanyelv nyelvi szabályainak alkalmazásához.

Ha nyelvelemzésen is áteső tartalomhoz ad hozzá helyesírás-ellenőrzést, minden indexelési és lekérdezésfeldolgozási lépéshez ugyanazt a nyelvet használva érhet el jobb eredményeket. Ha például egy mező tartalmát az "fr.microsoft" nyelvelemzővel indexelték, akkor a lekérdezések és helyesírás-ellenőrzésnek valamilyen formában francia lexikont vagy nyelvi könyvtárat kell használnia.

A nyelvi kódtárak Azure AI Keresés való felhasználásának összegzése:

• A nyelvelemzők meghívhatók az indexelés és a lekérdezés végrehajtása során, és vagy az Apache Lucene (például "de.lucene"), vagy a Microsoft ("de.microsoft").

• A helyesírás-ellenőrzés során meghívott nyelvi lexikonok a támogatott nyelvi táblázat egyik nyelvi kódjának használatával vannak megadva.

Egy lekérdezési kérelemben a hozzárendelt queryLanguage érték a következőre spellervonatkozik: .

Bár a keresési index tartalma több nyelven is összeállítható, a lekérdezés bemenete valószínűleg egy nyelven történik. A keresőmotor nem ellenőrzi a nyelvelemző és a tartalomkészítés nyelvének queryLanguagekompatibilitását, ezért ügyeljen arra, hogy a lekérdezéseket ennek megfelelően hatókörbe állítsa, hogy ne eredményezzen helytelen eredményeket.

Következő lépések

• Alapszintű lekérdezés létrehozása
• Teljes Lucene-lekérdezési szintaxis használata
• Egyszerű lekérdezési szintaxis használata