Azure Yapay Zeka Arama'te semantik sıralayıcı ile puanlama profillerini kullanma

Anlamsal olarak sıralanmış arama sonuçları üzerine, puanlama profili en son işlendiğinde bir puanlama profili uygulayabilirsiniz.

Uygulanan puanlama profilinin belirleyici puanı sağladığından emin olmak için anlamsal derecelendirilmiş sonuçlara puanlama profilinin mantığını uygulayan bir yanıt alanı @search.rerankerBoostedScore ekler. 1. Derece 1 derecelendirmesinden @search.score, anlamsal derecelendiriciden @search.rerankerScore ve @search.rerankerBoostedScore içeren arama sonuçlarında, sonuçlar @search.rerankerBoostedScore ölçütüne göre sıralanır.

Önkoşullar

• Anlamsal derecelendirme sağlayan herhangi bir bölgede Azure Yapay Zeka Arama.

• Belirli bir anlamsal yapılandırmaya ve "rankingOrder": "boostedRerankerScore" belirten bir puanlama profiline sahip bir arama dizini.

Sınırlama

Anlamsal olarak sıralanmış sonuçların artırılması yalnızca puanlama profili işlevleri için geçerlidir. Puanlama profili yalnızca ağırlıklı metin alanlarından oluşuyorsa yükseltme olmaz.

Bu davranış, gibi /docs/searchdoğrudan bir dizine gönderdiğiniz anlamsal sorgular için geçerlidir. Aracı tabanlı alma, temel dizindeki puanlama profilleri dahil defaultScoringProfile dizinini uygulamaz ve alma yanıtları @search.rerankerBoostedScore göstermez. Daha fazla bilgi için bkz. Arama dizini bilgi kaynağı oluşturma ve Bilgi bankası sorgulama.

Puanlama profilleriyle anlamsal yapılandırma nasıl çalışır?

Puanlama profiliyle ilişkili bir anlam sorgusu yürüttüğünüzde, arama sonuçlarınızdaki her belge için üçüncü bir arama puanı ( @search.rerankerBoostedScore değer) oluşturulur. Puanlama profilinin mevcut yeniden puanlama puanına uygulanmasıyla hesaplanan bu artırılmış puan, normal yeniden puanlama puanı gibi garantili bir aralığa (0-4) sahip değildir ve puanlar 4'ten önemli ölçüde yüksek olabilir.

Puanlama profili varsa anlamsal sonuçlar varsayılan olarak sıralanır @search.rerankerBoostedScore . rankingOrder Özellik belirtilmezse, BoostedRerankerScore anlamsal yapılandırmadaki varsayılan değerdir.

Bu senaryoda, bir puanlama profili iki kez kullanılır.

1. İlk olarak, dizininizde tanımlanan puanlama profili ilk L1 derecelendirme aşamasında kullanılır ve sonuçları artırmak için kullanılır:

   • Metin tabanlı sorgular (BM25 veya RRF)
   • Vektör sorgularının metin bölümü
   • Her iki türü de birleştiren karma sorgular

2. Ardından, semantik derece oluşturucu ilk 50 sonucu yeniden puanlar ve daha anlamsal olarak ilgili eşleşmeleri en üste doğru teşvik eder. Bu adım puanlama profilinin avantajlarını silebilir. Örneğin, yeniliğe göre bir artırım yaptıysanız, semantik sıralama, bu artırımı, en uygun olanı kendi mantığıyla belirleyerek değiştirir.

3. Son olarak, yeniden sıralamanın ardından puanlama profili tekrar uygulanır ve bu değişiklikler sonuçların son sırası üzerinde etkili olur. Eğer yeniliğe göre bir artış yaparsanız, semantik olarak sıralanmış sonuçlar yeniliğe göre yeniden değerlendirilir.

Anlamsal yapılandırmada puanlama profillerini etkinleştirme

Sıralamalı sonuçlar için puanlama profillerini etkinleştirmek için, semantik yapılandırmasının özelliğini ayarlayarak rankingOrder. Dizini düzeltmelerinizle güncelleştirmek için PUT yöntemini kullanın. Dizin yeniden oluşturulması gerekli değil.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "boostedRerankerScore"
      }
    ]
  }
}

Anlamsal yapılandırmada puanlama profillerini devre dışı bırakma

Semantik yapılandırmada sıralamayı semantik reranker artırılmış puana göre yapmaktan vazgeçmek için rankingOrder alanını reRankerScore değerine ayarlayın.

PUT /indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

ölçütüne @search.rerankerBoostedScoreboostedRerankerScore göre sıralamayı geri çevirseniz bile, alan yanıtta yine de oluşturulur, ancak artık sonuçları sıralamak için kullanılmaz.

Örnek sorgu ve yanıt

Puanlama profili belirten bir anlamsal sorguyla başlayın. Bu sorgu, rankingOrder olarak ayarlanmış boostedRerankerScore bir arama dizinini hedefler.

POST /indexes/{index-name}/docs/search?api-version=2026-04-01
{
  "search": "my query to be boosted",
  "scoringProfile": "myScoringProfile",
  "queryType": "semantic"
}

Yanıt, L1 rerankerBoostedScore ve L2 @search.scoreile birlikte yeni @search.rerankerScoreöğesini içerir. Sonuçlar @search.rerankerBoostedScore göre sıralanır.

{
  "value": [
    {
      "@search.score": 0.63,
      "@search.rerankerScore": 2.98,
      "@search.rerankerBoostedScore": 7.68,
      "content": "boosted content 2"
    },
    {
      "@search.score": 1.12,
      "@search.rerankerScore": 3.12,
      "@search.rerankerBoostedScore": 5.61,
      "content": "boosted content 1"
    }
  ]
}