Použití hodnoticích profilů se sémantickým rankerem v Azure AI Vyhledávač

Profil bodování můžete použít u sémanticky seřazených výsledků hledání, kde se profil bodování zpracuje jako poslední.

Aby se zajistilo, že profil bodování poskytuje určující skóre, přidá sémantický ranker pole odpovědi, @search.rerankerBoostedScorekteré použije logiku hodnoticího profilu na sémanticky seřazené výsledky. Ve výsledcích hledání, které zahrnují @search.score z pořadí 1, @search.rerankerScore ze sémantického rankeru a @search.rerankerBoostedScore, jsou výsledky tříděny podle @search.rerankerBoostedScore.

Požadavky

• Azure AI Vyhledávač v jakékoliv oblasti, která poskytuje sémantické řazení.

• Index vyhledávání s sémantickou konfigurací, která určuje "rankingOrder": "boostedRerankerScore" a bodovací profil, který určuje funkce.

Omezení

Zvýšení sémanticky seřazených výsledků se vztahuje pouze na funkce hodnoticího profilu. Pokud se profil bodování skládá jenom z vážených textových polí, není potřeba ho zvýšit.

Toto chování platí pro sémantické dotazy, které odesíláte přímo do indexu, například /docs/search. Agentní načítání nepoužívá profily hodnocení indexu, včetně defaultScoringProfile v podkladovém indexu, a odpovědi načtení nezobrazují @search.rerankerBoostedScore. Další informace najdete v tématu Vytvoření zdroje znalostí indexu vyhledávání a dotazování znalostní báze.

Jak funguje sémantická konfigurace s bodovacími profily?

Při spuštění sémantického dotazu přidruženého k hodnoticímu profilu se pro každý dokument ve výsledcích hledání vygeneruje třetí skóre hledání, @search.rerankerBoostedScore hodnota. Toto zvýšené skóre, vypočítané použitím skóringového profilu na stávající přehodnocovací skóre, nemá zaručený rozsah (0–4), jako běžné přehodnocovací skóre, a skóre může být výrazně vyšší než 4.

Sémantické výsledky se řadí ve výchozím nastavení @search.rerankerBoostedScore, pokud existuje profil bodování. rankingOrder Pokud není vlastnost zadána, je BoostedRerankerScore výchozí hodnota v sémantické konfiguraci.

V tomto scénáři se profil bodování používá dvakrát.

1. Nejprve se profil bodování definovaný v indexu použije během počáteční fáze hodnocení L1, což zvyšuje výsledky z:

   • Textové dotazy (BM25 nebo RRF)
   • Textová část vektorových dotazů
   • Hybridní dotazy, které kombinují oba typy

2. V dalším kroku sémantický ranker přeřadí prvních 50 výsledků, zvýhodňuje více sémanticky relevantních shod na první místa. Tento krok může vymazat výhodu profilu bodování. Pokud jste například posílili na základě aktuálnosti, sémantické přeřazení nahradí toto posílení vlastní logikou, co je nejrelevantnější.

3. Nakonec se profil bodování znovu použije po opětovném řazení, čímž se obnoví vliv zvýhodnění na konečné pořadí výsledků. Pokud zvýšíte hodnocení podle aktuálnosti, sémanticky seřazené výsledky se znovu ohodnotí na základě aktuálnosti.

Povolit hodnoticí profily v sémantické konfiguraci

Chcete-li povolit bodovací profily pro sémanticky seřazené výsledky, aktualizujte index nastavením rankingOrder vlastnosti jeho sémantické konfigurace. Pomocí metody PUT aktualizujte index pomocí revizí. Nevyžaduje se žádné opětovné sestavení indexu.

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

Zakázat hodnoticí profily v sémantické konfiguraci

Pokud chcete zrušit řazení podle sémantického rerankeru se zvýšením skóre, nastavte rankingOrder pole na reRankerScore hodnotu v sémantické konfiguraci.

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

I když se rozhodnete neřadit podle @search.rerankerBoostedScore, pole boostedRerankerScore se v odpovědi stále objeví, ale už se nevyužívá k řazení výsledků.

Příklad dotazu a odpovědi

Začněte sémantickým dotazem , který určuje profil bodování. Tento dotaz cílí na index vyhledávání, který je rankingOrder nastavený na boostedRerankerScore.

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

Odpověď zahrnuje nový rerankerBoostedScore, spolu s L1 @search.score a L2 @search.rerankerScore. Výsledky jsou seřazeny podle @search.rerankerBoostedScore.

{
  "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"
    }
  ]
}