Spellingcontrole toevoegen aan query's in Azure AI Zoeken (preview)

U kunt de herinnering verbeteren door de spelling van woorden in een query te corrigeren voordat ze de zoekmachine bereiken. De speller parameter (preview) wordt ondersteund voor alle typen tekstquery's (niet-vector) en is beschikbaar via de Azure-portal, preview-REST API's en bètaversies van Azure SDK bibliotheken.

Voorwaarden

• Een zoekservice in de Basic-laag of hoger, in elke regio.

• Een bestaande zoekindex met inhoud in een ondersteunde taal.

• Een queryaanvraag waarbij speller=lexicon en queryLanguage zijn ingesteld op een ondersteunde taal. Spellingcontrole werkt op tekenreeksen die zijn doorgegeven in de search parameter. Het wordt niet ondersteund voor filters, fuzzy search, zoeken met wildcards, reguliere expressies of vectorquery's.

Gebruik een zoekclient die preview-API's ondersteunt voor de queryaanvraag. U kunt een REST-client of bètaversies van de Azure-SDK's gebruiken.

Spellingcorrectie met eenvoudige zoekopdrachten

In het volgende voorbeeld wordt de hotels-sample-index gebruikt om de spellingcorrectie voor een eenvoudige tekstquery te demonstreren. Zonder spellingcorrectie retourneert de query nul resultaten. Na correctie retourneert de query één resultaat voor het familiegeoriënteerde resort van Johnson.

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
}

Spellingcorrectie met de volledige Lucene-bibliotheek

Spellingcorrectie vindt plaats op afzonderlijke querytermen die tekstanalyse ondergaan. Daarom kunt u de parameter spellingcontrole gebruiken met sommige Lucene-query's, maar niet met andere.

• Incompatibele queryformulieren die tekstanalyse omzeilen zijn: jokerteken, regex, fuzzy
• Compatibele queryformulieren zijn: zoeken in velden, nabijheid, termenverhoging

In dit voorbeeld wordt een veldzoekopdracht gebruikt voor het veld Categorie, met volledige Lucene-syntaxis en een verkeerd gespelde queryterm. Door de spellingscontrole op te nemen, wordt de typefout in 'Suiite' gecorrigeerd en slaagt de query.

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
}

Spellingcorrectie met semantische rangschikking

Deze query, met typfouten in elke term behalve één, ondergaat spellingcorrecties om relevante resultaten te retourneren. Zie Semantische rangschikking configureren voor meer informatie.

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
}

Ondersteunde talen

Geldige waarden voor queryLanguage vindt u in de volgende tabel, gekopieerd uit de lijst met ondersteunde talen (REST API-verwijzing).

Overwegingen voor taalanalyse

Indexen die niet-Engelse inhoud bevatten, gebruiken vaak taalanalyses op niet-Engelse velden om de taalkundige regels van de systeemeigen taal toe te passen.

Wanneer u spellingcontrole toevoegt aan inhoud die ook taalanalyse ondergaat, kunt u betere resultaten bereiken met dezelfde taal voor elke indexerings- en queryverwerkingsstap. Als de inhoud van een veld bijvoorbeeld is geïndexeerd met behulp van de taalanalyse 'fr.microsoft', moeten query's en spellingcontrole allemaal een Franse lexicon of taalbibliotheek van een bepaalde vorm gebruiken.

Als u wilt samenvatten hoe taalbibliotheken worden gebruikt in Azure AI Zoeken:

• Taalanalyses kunnen worden aangeroepen tijdens het indexeren en uitvoeren van query's en zijn Apache Lucene (bijvoorbeeld 'de.lucene') of Microsoft (de.microsoft).

• Taal lexicons die tijdens de spellingcontrole worden aangeroepen, worden opgegeven met behulp van een van de taalcodes in de ondersteunde taaltabel .

In een query geldt de waarde die is toegewezen aan queryLanguage voor speller.

Hoewel inhoud in een zoekindex in meerdere talen kan worden samengesteld, is de queryinvoer waarschijnlijk in één. De zoekmachine controleert niet op de compatibiliteit van queryLanguage, de taalanalysator en de taal waarin de inhoud is samengesteld, dus zorg ervoor dat u query's hierop afstemt om te voorkomen dat er onjuiste resultaten worden opgeleverd.

Volgende stappen

• Een basisquery maken
• Volledige Lucene-querysyntaxis gebruiken
• Eenvoudige querysyntaxis gebruiken