Aracılığıyla paylaş

Azure AI Search'te puanlama profillerini anlamsal sıralayıcı ile kullanma

Uyarı

Bu özellik şu anda genel önizlemededir. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Puanlama profillerinisemantik ranker ile tümleştirme, daha yeni Azure AI Search API sürümlerinde ve Azure SDK paketlerinde desteklenir. Anlam sıralayıcı, arama işlem hattınızdaki son sıralama sonuçları üzerinde tutarlı bir alaka ve daha fazla denetim sahibi olmanıza yardımcı olmak için yeni bir alan, @search.rerankerBoostedScore, ekler.

Bu tümleştirmeden önce puanlama profilleri yalnızca BM25 dereceli ve RRF dereceli arama sonuçlarının ilk L1 derecelendirme aşamasını etkiledi. Ancak anlamsal L2 sıralayıcısı sonuçları yeniden derecelendirdikten sonra bu artışların hiçbir etkisi kalmadı. Anlamsal yeniden sıralama işlemi puanlama profillerini tamamen yoksaydı.

Puanlama profillerini semantik sıralayıcı ile tümleştirmek, puanlama profillerini L2 dereceli sonuçlara uygulayarak bu davranışı giderir ve yükseltmelerin dikkate alındığından emin olur.

Önkoşullar

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.

API sürümünden 2025-05-01-preview itibaren, anlamsal sonuçlar @search.rerankerBoostedScore tarafından varsayılan olarak sıralanır. rankingOrder Özellik belirtilmezse, boostedReRankerScore anlamsal yapılandırmadaki varsayılan değerdir.

Bu özellik etkinleştirildiğinde, dizininizde tanımlanan puanlama profili ilk derecelendirme aşamasında uygulanır. Sonuçları şu kaynaklardan artırı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

Ardından semantik dereceleyici ilk 50 sonucu yeniden işler. Ayrıca yeniden sıralama sonrasında puanlama profilini tekrar uygular, böylece geliştirmeleriniz sonuçların nihai sırasını etkiler.

Anlamsal yapılandırmada puanlama profillerini etkinleştirme

Anlamsal derecelendirme ile puanlama profillerini etkinleştirmek için, semantik yapılandırmasının 2025-05-01-preview özelliğini ayarlayarak dizini güncelleştirmek için önizleme API'sini rankingOrder kullanın. Dizini düzeltmelerinizle güncelleştirmek için PUT yöntemini kullanın. Dizin yeniden derlemesi gerekmez.

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

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

Semantik reranker artırılmış puana göre sıralamayı devre dışı bırakmak için, rankingOrder alanını anlamsal yapılandırmada reRankerScore değeri olarak ayarlayın.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2024-05-01-Preview
{
  "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. Sorgu, yeni önizleme REST API'sini kullanır ve rankingOrderboostedReRankerScore olarak ayarlanmış bir arama dizinini hedefler.

POST https://{service-name}.search.windows.com/indexes/{index-name}/docs/search?api-version=2025-05-01-Preview
{
  "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"
    }
  ]
}