Aggiungere il controllo ortografico alle query in Azure AI Search (anteprima)

È possibile migliorare il richiamo correggendo le parole in una query prima di raggiungere il motore di ricerca. Il speller parametro (anteprima) è supportato per tutti i tipi di query di testo (non vettoriali) ed è disponibile tramite il portale di Azure, le API REST di anteprima e le versioni beta delle librerie di Azure SDK.

Prerequisiti

• Un servizio di ricerca al livello Basic o superiore, in qualsiasi area.

• Indice di ricerca esistente con contenuto in una lingua supportata.

• Richiesta di query con speller=lexicon e queryLanguage impostata su un linguaggio supportato. Il controllo ortografico funziona sulle stringhe passate nel search parametro . Non è supportato per i filtri, la ricerca fuzzy, la ricerca con caratteri jolly, le espressioni regolari o le query vettoriali.

Usare un client di ricerca che supporta le API di anteprima nella richiesta di query. È possibile usare un client REST o versioni beta del Azure SDK.

Correzione ortografia con ricerca semplice

Nell'esempio seguente viene utilizzato l'indice hotels-sample per illustrare la correzione ortografica su una query di testo semplice. Senza correzione ortografia, la query restituisce zero risultati. Con la correzione, la query restituisce un risultato per il resort orientato alla famiglia di 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
}

Correzione ortografica completa con Lucene

La correzione ortografica si verifica in singoli termini di query che vengono sottoposti ad analisi del testo, motivo per cui è possibile usare il parametro del correttore ortografico con alcune query Lucene, ma non altre.

• I moduli di query incompatibili che ignorano l'analisi del testo includono: carattere jolly, regex, fuzzy
• I moduli di query compatibili includono: ricerca con campi, prossimità, potenziamento dei termini

In questo esempio viene usata la ricerca per campi nel campo Categoria, con la sintassi Lucene completa e un termine della query con errori di ortografia. Includendo il correttore ortografico, l'ortografia in "Suiite" viene corretta e la query ha esito positivo.

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
}

Correzione ortografia con classificazione semantica

Questa query, con errori di digitazione in ogni termine ad eccezione di uno, viene sottoposta a correzioni ortografiche per restituire risultati pertinenti. Per altre informazioni, vedere Configurare il ranker semantico.

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
}

Lingue supportate

I valori validi per queryLanguage sono disponibili nella tabella seguente, copiati dall'elenco delle lingue supportate (informazioni di riferimento sull'API REST).

Considerazioni sull'analizzatore del linguaggio

Gli indici che contengono contenuti non in lingua inglese spesso usano analizzatori della lingua nei campi non inglesi per applicare le regole linguistiche della lingua nativa.

Quando si aggiunge il controllo ortografico al contenuto che viene sottoposto anche all'analisi del linguaggio, è possibile ottenere risultati migliori usando lo stesso linguaggio per ogni passaggio di indicizzazione e elaborazione delle query. Ad esempio, se il contenuto di un campo è stato indicizzato usando l'analizzatore del linguaggio "fr.microsoft", le query e il controllo ortografico devono usare tutti un lessico francese o una raccolta di lingue di qualche modulo.

Per riepilogare il modo in cui le librerie del linguaggio vengono usate in Azure AI Search:

• Gli analizzatori del linguaggio possono essere richiamati durante l'indicizzazione e l'esecuzione di query e sono Apache Lucene (ad esempio, "de.lucene") o Microsoft ("de.microsoft).

• I lessico linguistici richiamati durante il controllo ortografico vengono specificati usando uno dei codici di lingua nella tabella della lingua supportata .

In una richiesta di query il valore assegnato a queryLanguage si applica a speller.

Anche se il contenuto in un indice di ricerca può essere composto in più lingue, è molto probabile che l'input della query sia in una sola. Il motore di ricerca non verifica la compatibilità di queryLanguage, l'analizzatore del linguaggio e il linguaggio in cui è composto il contenuto, quindi assicurarsi di definire l'ambito delle query di conseguenza per evitare di produrre risultati non corretti.

Passaggi successivi

• Creare una interrogazione di base
• Usare la sintassi di query completa Lucene
• Usare la sintassi semplice di query