Azure Yapay Zeka Arama'te eş anlamlılar ekleme

Arama hizmetinde eş anlamlı eşlem eşdeğer terimleri ilişkilendirir ve kullanıcının terimi gerçekten sağlaması gerekmeden sorgu kapsamını genişletir. Örneğin, köpek, canis ve yavru köpek eş anlamlılar olarak eşlendiğinde, canis ile ilgili bir sorgu, köpek içeren bir belgeyle eşleşir. İçeriğiniz teknik jargon, argo veya belirsiz terminoloji içeriyorsa, İngilizce ve Fransızca sürümleri gibi farklı diller için birden çok eş anlamlı haritası veya sözlük oluşturabilirsiniz.

Eş anlamlı haritalarla ilgili bazı önemli noktalar:

• Eşanlamlı haritası, bir kez oluşturulabilen ve birçok dizin tarafından kullanılabilen üst düzey bir kaynaktır.
• Eş anlamlı haritası, metin alanlarına uygulanır.
• İstediğiniz zaman dizin oluşturma veya sorgularda kesinti yaşamadan eş anlamlı eşlem oluşturabilir ve atayabilirsiniz.
• Hizmet katmanınız, oluşturabileceğiniz eş anlamlı eşleme sayısını sınırlar.
• Arama hizmetinizde birden çok eş anlamlı eşlemesi olabilir, ancak bir dizin içinde alan tanımında yalnızca bir eş anlamlı eşleme ataması olabilir.

Eş anlamlılar haritası oluşturma

Eş anlamlı eşlem, eş anlamlı eşleme girdileri olarak işlev gösteren bir ad, biçim ve kurallardan oluşur. Desteklenen tek biçimdir solrve biçim kural yapımını solr belirler.

Eş anlamlılar haritası oluşturmak için bunu programatik olarak yapın. Azure portalı eş anlamlı eşleme tanımlarını desteklemez.

POST /synonymmaps?api-version=2026-04-01
{
    "name": "geo-synonyms",
    "format": "solr",
    "synonyms": "
        USA, United States, United States of America\n
        Washington, Wash., WA => WA\n"
}

Kuralları tanımlama

Eşleme kuralları, Apache Solr'ın bu belgede açıklanan açık kaynak eş anlamlı filtre belirtimine uyar: SynonymGraphFilter. solr biçimi iki tür kuralı destekler:

• denklik (burada terimler sorgudaki eşit yedeklerdir)

• açık eşlemeler (terimlerin tek bir açık terimle eşlendiği)

Her kural, yeni satır karakteri (\n ) ile sınırlandırılır. Ücretsiz bir hizmette eş anlamlı eşleme başına en fazla 5.000 kural ve diğer katmanlarda harita başına 20.000 kural tanımlayabilirsiniz. Her kuralda en fazla 20 genişletme veya öğe bulunabilir. Daha fazla bilgi için bkz . Eş anlamlı sınırları.

Sorgu ayrıştırıcıları, büyük veya karışık harf terimlerini otomatik olarak küçük harfe çevirir. Dizedeki virgül veya tire gibi özel karakterleri korumak için eş anlamlı eşlem oluştururken uygun kaçış karakterlerini ekleyin.

Denklik kuralları

Eşdeğer terimlerin kuralları aynı kural içinde virgülle ayrılmıştır. İlk örnekte, ABD için bir sorgu, ABD OR "Birleşik Devletler" OR "Birleşik Devletler of America." olarak genişletilir. Bir ifadeyle eşleşme sağlamak istiyorsanız, sorgunun kendisi tırnak içine alınmış bir ifade sorgusu olmalıdır.

Denklik durumunda, köpek için bir sorgu, sorguyu köpek yavrusu ve köpek kelimelerini de içerecek şekilde genişletir.

{
"format": "solr",
"synonyms": "
    USA, United States, United States of America\n
    dog, puppy, canine\n
    coffee, latte, cup of joe, java\n"
}

Açık eşleme

Açık eşleme kuralları bir okla =>gösterilir. Belirtildiğinde, arama sorgusunun sol tarafıyla => eşleşen bir terim dizisi, sorgu zamanında sağ taraftaki alternatiflerle değiştirilir.

Açık durumda, Washington, Wash. veya WA için bir sorgu WA olarak yeniden yazılır ve sorgu altyapısı yalnızca WA terimindeki eşleşmeleri arar. Açık eşleme yalnızca belirtilen yönde geçerlidir ve bu durumda WA sorgusunu Washington'a yeniden yazmaz.

{
"format": "solr",
"synonyms": "
    Washington, Wash., WA => WA\n
    California, Calif., CA => CA\n"
}

Özel karakterlerden kaçış

Eş anlamlılar, diğer tüm sorgu terimleri gibi sorgu işleme sırasında da analiz edilir. Bu, ayrılmış ve özel karakterlere yönelik kuralların eş anlamlı haritanızdaki terimler için geçerli olduğu anlamına gelir. Kaçış gerektiren karakterlerin listesi basit söz dizimi ile tam söz dizimi arasında değişir:

• basit söz dizimi+ | " ( ) ' \
• tam söz dizimi+ - & | ! ( ) { } [ ] ^ " ~ * ? : \ /

Varsayılan çözümleyicinin attığı karakterleri korumak için, bu karakterleri koruyan bir çözümleyiciyle değiştirin. Bazı seçenekler arasında hecelenmiş sözcükleri koruyan Microsoft doğal dil çözümleyicileri veya daha karmaşık desenler için özel bir çözümleyici bulunur. Daha fazla bilgi için bkz . Kısmi terimler, desenler ve özel karakterler.

Aşağıdaki örnekte, ters eğik çizgiyle bir karakterden kaçış örneği gösterilmektedir:

{
    "format": "solr",
    "synonyms": "WA\, USA, WA, Washington\n"
}

Ters eğik çizgi, JSON ve C# gibi diğer dillerde özel bir karakter olduğundan, muhtemelen iki kez kaçış yapmanız gerekir. JSON'da bir örnek aşağıda verilmişti:

{
    "format":"solr",
    "synonyms": "WA\\, USA, WA, Washington"
}

Eş anlamlı haritaları yönetme

Eş anlamlılar haritasını sorguları ve indeksleme iş yüklerini aksatmadan güncelleyebilirsiniz. Ancak, bir alana eş anlamlı eşlem eklediğinizde, eş anlamlı eşlemesini silerseniz, söz konusu alanları içeren tüm sorgular 404 hatasıyla başarısız olur.

Eş anlamlı eşlem oluşturma, güncelleştirme ve silme işlemleri her zaman belgenin tamamına yönelik bir işlemdir. Eş anlamlı eşlemesinin bölümlerini artımlı olarak güncelleştiremez veya silemezsiniz. Tek bir kuralın bile güncelleştirilmesi için yeniden yükleme gerekir.

Alanlara eş anlamlıları atamak

Eş anlamlı eşlemesini oluşturduktan sonra, bunu dizininizdeki bir alana atayın. Eş anlamlı haritaları atamak için bunu programlı bir şekilde yapın. Azure portalı eş anlamlı eşleme alanı ilişkilendirmelerini desteklemez.

• Bir alan Edm.String veya Collection(Edm.String) türünde olmalıdır.
• Bir alan "searchable":true içermelidir
• Bir alanda yalnızca bir eş anlamlı haritası olabilir

Arama hizmetinde eş anlamlı eşlem varsa, yeniden dizin oluşturma veya yeniden derleme gerekmediğinden bir sonraki sorguda kullanılır.

PUT /indexes?api-version=2026-04-01
{
    "name":"hotels-sample",
    "fields":[
        {
            "name":"description",
            "type":"Edm.String",
            "searchable":true,
            "synonymMaps":[
            "en-synonyms"
            ]
        },
        {
            "name":"description_fr",
            "type":"Edm.String",
            "searchable":true,
            "analyzer":"fr.microsoft",
            "synonymMaps":[
            "fr-synonyms"
            ]
        }
    ]
}

// Update an index
string indexName = "hotels";
SearchIndex index = new SearchIndex(indexName)
{
    Fields =
    {
        new SimpleField("hotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true },
        new SearchableField("hotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("description") { AnalyzerName = LexicalAnalyzerName.EnLucene },
        new SearchableField("descriptionFr") { AnalyzerName = LexicalAnalyzerName.FrLucene }
        new ComplexField("address")
        {
            Fields =
            {
                new SearchableField("streetAddress"),
                new SearchableField("city") { IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("stateProvince") { IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("country") { SynonymMapNames = new[] { synonymMapName }, IsFilterable = true, IsSortable = true, IsFacetable = true },
                new SearchableField("postalCode") { IsFilterable = true, IsSortable = true, IsFacetable = true }
            }
        }
    }
};

await indexClient.CreateIndexAsync(index);

Eşdeğer veya eşlenmiş alanlarda sorgu

Eş anlamlı alan ataması sorgu yazma şeklinizi değiştirmez. Eş anlamlı eşleme atamasının ardından tek fark, eş anlamlı eşlemesinde bir sorgu terimi varsa, arama altyapısının kurala bağlı olarak terimi veya tümceciği genişletmesi veya yeniden yazmasıdır.

Sorgu yürütme sırasında eş anlamlılar nasıl kullanılır?

Eş anlamlılar, bir dizinin içeriğini eşdeğer terimlerle tamamlayan bir sorgu genişletme tekniğidir, ancak yalnızca eş anlamlı ataması olan alanlar için kullanılır. Alan kapsamlı bir sorgu eş anlamlı etkinleştirilmiş bir alanı dışlarsa eş anlamlı eşleminden eşleşme görmezsiniz.

Eş anlamlı özellikli alanlar için eş anlamlılar, ilişkili alanla aynı metin analizine tabidir. Örneğin, bir alan standart Lucene çözümleyicisi kullanılarak analiz edilirse, eş anlamlı terimler de sorgu zamanında standart Lucene çözümleyicisine tabidir. Eğer eş anlamlı terimdeki noktalar veya tireler gibi noktalama işaretlerini korumak istiyorsanız, alana içerik koruma analizörü uygulayın.

Dahili olarak, eş anlamlılar özelliği OR işlecini kullanarak özgün sorguyu eş anlamlılarla yeniden yazar. Bu nedenle, isabet vurgulama ve puanlama profilleri özgün terimi ve eş anlamlıları eşdeğer olarak değerlendirir.

Eş anlamlılar yalnızca serbest biçimli metin sorgularına uygulanır ve filtreler, modeller, otomatik tamamlama veya öneriler için desteklenmez. Otomatik tamamlama ve öneriler yalnızca özgün terimi temel alır; eş anlamlı eşleşmeleri yanıtta görünmez.

Geliştirme (üretim dışı) ortamında mevcut bir dizininiz varsa, eş anlamlıların eklenmesinin, puanlama profilleri, isabet vurgulama ve öneriler de dahil olmak üzere arama deneyimini nasıl değiştirdiğini görmek için küçük bir sözlükle denemeler yapın.

Joker karakter aramaları

Eş anlamlı genişletmeleri joker karakter arama terimleri için geçerli değildir; ön ek, belirsiz ve regex terimleri genişletilmemiştir.

Eş anlamlı genişletme ve joker karakter, regex veya benzer aramalar uygulayan tek bir sorgu yapmanız gerekiyorsa, OR söz dizimini kullanarak sorguları birleştirebilirsiniz. Örneğin, basit sorgu söz diziminde eş anlamlıları joker karakterlerle birleştirmek için terim <query> | <query>* olacaktır.

Sonraki adım