Azure Yapay Zeka Arama sorgulara yazım denetimi ekleme (önizleme)

Bir sorgudaki sözcükleri arama altyapısına ulaşmadan önce yazım düzelterek geri çağırmayı geliştirebilirsiniz. speller Parametresi (önizleme) tüm metin (vektör olmayan) sorgu türleri için desteklenir ve Azure portalı, önizleme REST API'leri ve Azure SDK kitaplıklarının beta sürümleri aracılığıyla sağlanır.

Önkoşullar

• Herhangi bir bölgede Temel katman veya üzeri bir arama hizmeti.

• Desteklenen bir dilde içerik içeren mevcut bir arama dizini.

• ve speller=lexicon değerleri queryLanguage olarak ayarlanmış bir sorgu isteği. Yazım denetimi, search parametresine geçirilen dizelerde çalışır. Filtreler, benzer arama, joker karakter araması, normal ifadeler veya vektör sorguları için desteklenmez.

Sorgu isteğinde önizleme API'lerini destekleyen bir arama istemcisi kullanın. Azure SDK’ları REST istemcisi veya beta sürümlerini kullanabilirsiniz.

Basit arama ile yazım düzeltmesi

Aşağıdaki örnek, basit bir metin sorgusunda yazım düzeltmesini göstermek için hotels-sample dizinini kullanır. Yazım düzeltmesi olmadan sorgu sıfır sonuç döndürür. Düzeltme ile sorgu, Johnson'ın aile odaklı tesisi için bir sonuç döndürür.

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
}

Tam Lucene ile yazım düzeltmesi

Yazım denetimi, metin analizinden geçen tek tek sorgu terimlerinde gerçekleşir. Bu nedenle yazım denetleyicisi parametresini bazı Lucene sorgularıyla kullanabilirsiniz, ancak diğerleri kullanamazsınız.

• Metin analizini atlayan uyumsuz sorgu formları şunlardır: joker karakter, düzenli ifade (regex), yakın eşleşme
• Uyumlu sorgu formları şunlardır: alanlı arama, yakınlık, terim artırma

Bu örnekte, Tam Lucene söz dizimi ve yanlış yazılmış sorgu terimiyle Kategori alanı üzerinde alanlı arama kullanılmaktadır. Yazım denetleyicisi dahil edilirse, "Suiite" içindeki yazım hatası düzeltilir ve sorgu başarılı olur.

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
}

Anlamsal derecelendirme ile yazım düzeltmesi

Bu sorgu, biri dışında tüm terimlerde yazım hatası olduğu için, doğru sonuçları döndürmek amacıyla yazım düzeltmelerinden geçerek işlenir. Daha fazla bilgi edinmek için bkz. Anlam derecesini yapılandırma.

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
}

Desteklenen diller

queryLanguage için geçerli değerler, desteklenen diller listesinden (REST API başvuru) kopyalanan aşağıdaki tabloda bulunabilir.

Dil çözümleyicisi ile ilgili dikkat edilmesi gerekenler

İngilizce olmayan içerik içeren dizinler, ana dilin dil kurallarını uygulamak için genellikle İngilizce olmayan alanlarda dil çözümleyicileri kullanır.

Dil analizinden geçen içeriğe yazım denetimi eklerken, her dizin oluşturma ve sorgu işleme adımı için aynı dili kullanarak daha iyi sonuçlar elde edebilirsiniz. Örneğin, bir alanın içeriği "fr.microsoft" dil çözümleyicisi kullanılarak dizine alındıysa, sorgular ve yazım denetiminin tümü fransızca sözcük sözlüğü veya bir biçimdeki dil kitaplığını kullanmalıdır.

Azure Yapay Zeka Arama dil kitaplıklarının nasıl kullanıldığını özetlemek için:

• Dil çözümleyicileri dizin oluşturma ve sorgu yürütme sırasında çağrılabilir ve Apache Lucene (örneğin, "de.lucene") veya Microsoft ("de.microsoft) olabilir.

• Yazım denetimi sırasında çağrılan dil sözcük kodları , desteklenen dil tablosundaki dil kodlarından biri kullanılarak belirtilir.

Sorgu isteğinde, öğesine queryLanguage atanan değer için spellergeçerlidir.

Bir arama dizinindeki içerik birden çok dilde oluşturulabilir ancak sorgu girişi büyük olasılıkla bir dildedir. Arama altyapısı, , dil çözümleyicisinin ve içeriğin oluşturulduğu dilin queryLanguageuyumluluğunu denetlemez, bu nedenle yanlış sonuçlar üretmekten kaçınmak için sorguları buna göre kapsamlandırdığından emin olun.

Sonraki adımlar

• Temel sorgu oluşturma
• Tam Lucene sorgu söz dizimlerini kullanma
• Basit sorgu söz dizimlerini kullanma