Anlam sıralamasını yapılandırma ve arama sonuçlarında başlık döndürme

Makale
02/14/2024

Bu makalede, bir sonuç kümesi üzerinde semantik derecelendirme çağırmayı ve en semantik olarak ilgili sonuçları yığının en üstüne yükseltmeyi öğrenin. Ayrıca en ilgili terimler ve tümcecikler üzerinde vurgular ve anlamsal yanıtlar içeren anlamsal başlık alabilirsiniz.

Önkoşullar

Temel, Standart katman (S1, S2, S3) veya Depolama İyileştirilmiş katmanındaki (L1, L2) arama hizmeti, bölge kullanılabilirliğine bağlıdır.
Arama hizmetinizde semantik derece etkinleştirildi.
Zengin metin içeriğine sahip mevcut bir arama dizini. Anlam derecelendirmesi metin (açıklamasız) alanları için geçerlidir ve bilgilendirici veya açıklayıcı içerik üzerinde en iyi sonucu verir.

İstemci seçme

Anlam sıralamasını destekleyen bir arama istemcisi seçin. Aşağıda bazı seçenekleri görebilirsiniz:

Azure portalında dizin tasarımcısını kullanarak anlamsal yapılandırma ekleyin.
REST istemcisiyle Visual Studio Code
.NET için Azure SDK
Python için Azure SDK
Java için Azure SDK
JavaScript için Azure SDK

Anlamsal yapılandırma ekleme

Anlamsal yapılandırma, dizininizde semantik derecelendirme için alan girişleri oluşturan bir bölümdür. İstediğiniz zaman bir anlamsal yapılandırma ekleyebilir veya güncelleştirebilirsiniz; yeniden derleme gerekmez. Birden çok yapılandırma oluşturursanız varsayılan bir yapılandırma belirtebilirsiniz. Sorgu zamanında, sorgu isteğinde bir anlamsal yapılandırma belirtin veya varsayılanı kullanmak için bunu boş bırakın.

Anlamsal yapılandırmanın bir adı ve aşağıdaki özellikleri vardır:

Özellik	Özellikler
Başlık alanı	İdeal olarak 25 sözcüğün altında kısa bir dize. Bu alan, belgenin başlığı, ürün adı veya benzersiz tanımlayıcı olabilir. Uygun alanınız yoksa boş bırakın.
İçerik alanları	Makine öğrenmesi modellerinde maksimum belirteç giriş sınırlarına tabi olarak, doğal dil biçiminde daha uzun metin öbekleri. Yaygın örnekler arasında belgenin gövdesi, ürünün açıklaması veya diğer serbest biçimli metinler yer alır.
Anahtar sözcük alanları	Belgedeki etiketler gibi anahtar sözcüklerin listesi veya öğenin kategorisi gibi açıklayıcı bir terim.

Yalnızca bir başlık alanı belirtebilirsiniz, ancak istediğiniz kadar içerik ve anahtar sözcük alanınız olabilir. İçerik ve anahtar sözcük alanları için, daha düşük öncelikli alanlar kesilebileceği için alanları öncelik sırasına göre listeleyin.

Tüm anlamsal yapılandırma özelliklerinde atadığınız alanlar şu şekilde olmalıdır:

ve olarak searchable özniteliklendirildi retrievable
, , Collection(Edm.String)dize alt alanları türünde Edm.StringdizelerCollection(Edm.ComplexType)

Azure portalında oturum açın ve anlam derecelendirmesi etkinleştirilmiş bir arama hizmetine gidin.
Sol gezinti bölmesindeki Dizinler'den bir dizin açın.
AnlamSal Yapılandırmalar'ı ve ardından Semantik Yapılandırma Ekle'yi seçin.

Yeni Anlam Yapılandırması sayfası, başlık alanı, içerik alanları ve anahtar sözcük alanları seçme seçenekleriyle birlikte açılır. Yalnızca aranabilir ve alınabilir dize alanları uygundur. İçerik alanlarını ve anahtar sözcük alanlarını öncelik sırasına göre listelediğinden emin olun.

Değişiklikleri kaydetmek için Tamam'ı seçin.

Dizin Oluşturma veya Güncelleştirme isteğini formüle edin.

Dizin tanımına belki de veya suggesterssonrasında scoringProfiles bir anlamsal yapılandırma ekleyin. Varsayılanı belirtmek isteğe bağlıdır, ancak birden fazla yapılandırmanız varsa kullanışlıdır.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

.NET için Azure SDK'sında SemanticConfiguration sınıfını kullanın.

Aşağıdaki örnek, Azure SDK ekibi tarafından yazılan anlamsal derecelendirme örneğinden alınmalıdır.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Önizleme sürümlerinden geçiş

Anlamsal derecelendirme kodunuz önizleme API'lerini kullanıyorsa, bu bölümde kararlı sürümlere nasıl geçiş yapılacağını açıklanmaktadır. Genel kullanılabilirlik doğrulaması için değişiklik günlüklerini de kontrol edebilirsiniz:

Davranış değişiklikleri:

14 Temmuz 2023 itibarıyla semantik dereceleyici dilden bağımsızdır. Çok dilli içeriklerden oluşan sonuçları, belirli bir dile karşı sapma olmadan yeniden düzenleyebilir. Önizleme sürümlerinde semantik derecelendirme, alan çözümleyicisi tarafından belirtilen dilden farklı sonuçların yerini alır.
2021-04-30-Preview ve sonraki tüm sürümlerde REST API ve aynı sürümü hedefleyen tüm SDK paketleri için: semanticConfiguration (dizin tanımında) anlamsal derecelendirmede hangi arama alanlarının kullanıldığını tanımlar. Daha önce 2020-06-30-Preview REST API'sinde searchFields (sorgu isteğinde) alan belirtimi ve öncelik belirleme için kullanılıyordu. Bu yaklaşım yalnızca 2020-06-30-Preview sürümlerinde çalıştı ve diğer tüm sürümlerde kullanımdan kaldırıldı.

1. Adım: queryLanguage'ı kaldırma

Anlamsal derecelendirme altyapısı artık dilden bağımsızdır. Sorgu mantığınızda belirtilirsequeryLanguage, artık anlamsal derecelendirme için kullanılmaz, ancak yine de yazım düzeltmesi için geçerlidir.

Yazım denetleyicisi kullanıyorsanız ve dil değeri yazım denetleyicisi tarafından destekleniyorsa saklayınqueryLanguage. Yazım denetimi, diller arasında sınırlı kullanılabilirliğe sahiptir.

Aksi takdirde silin queryLanguage.

2. Adım: şununla değiştirin `searchFields` : `semanticConfiguration`

Kodunuz bu REST API sürümünü hedefleyen 2020-06-30-Preview REST API veya beta SDK paketlerini çağırıyorsa, anlamsal alanları ve öncelikleri belirtmek için sorgu isteğinde kullanıyor searchFields olabilirsiniz. İlk beta sürümlerinde, searchFields ilk sorguyu içinde searchFieldslistelenen alanlarla kısıtlayan ve ayrıca anlamsal derecelendirme kullanıldıysa alan önceliğini ayarlayan çift amaçlıydı. Sonraki sürümlerde özgün searchFields amacını korur, ancak artık anlamsal derecelendirme için kullanılmaz.

Tam metin aramasını adlandırılmış alanlar listesiyle sınırlamak için kullanıyorsanız sorgu isteklerinde tutun searchFields .

Bu makaledeki yönergeleri izleyerek alan önceliklendirmesini belirtmek için dizin şemasına bir semanticConfiguration ekleyin.

Sonraki adımlar

Anlamsal bir sorgu çalıştırarak anlam yapılandırmanızı test edin.

Anlamsal sorgu oluşturma