Pontozási profilok használata szemantikai rangsorolóval az Azure AI Keresésben

A pontozási profiltszemantikailag rangsorolt keresési eredményekre alkalmazhatja, ahol a pontozási profil feldolgozása utolsóként történik.

Annak érdekében, hogy a pontozási profil biztosítsa a meghatározó pontszámot, a szemantikai rangsoroló hozzáad egy válaszmezőt, @search.rerankerBoostedScoreamely a pontozási profil logikáját alkalmazza a szemantikailag rangsorolt eredményekre. Az 1. szintű rangsorolásból származó @search.score találatok, a szemantikai rangsorból származó @search.rerankerScore, és @search.rerankerBoostedScore találatok a @search.rerankerBoostedScore szerint vannak rendezve.

Előfeltételek

• Azure AI Keresés minden olyan régióban, amely szemantikai rangsort biztosít.

• Keresési index olyan szemantikai konfigurációval, amely meghatározza a függvényeket "rankingOrder": "boostedRerankerScore" , és egy pontozási profil, amely függvényeket határoz meg.

Korlátozások

A szemantikailag rangsorolt eredmények növelése csak a pontozási profilfüggvényekre vonatkozik. Nincs lehetőség a kiemelésre, ha a pontozási profil csak súlyozott szövegmezőket tartalmaz.

Ez a viselkedés azokra a szemantikai lekérdezésekre vonatkozik, amelyeket közvetlenül egy indexnek küld, például /docs/search. Az ügynökalapú lekérés nem alkalmazza az index pontozási profiljait, beleértve a mögöttes indexen lévő defaultScoringProfile elemet is, és a lekérési válaszok nem jelenítik meg a @search.rerankerBoostedScore elemet. További információ: Keresési index tudásbázis létrehozása és Tudásbázis lekérdezése.

Hogyan működik a szemantikai konfiguráció pontozási profilokkal?

Amikor egy pontozási profilhoz társított szemantikai lekérdezést hajt végre, a rendszer egy harmadik keresési pontszámot ( @search.rerankerBoostedScore értéket) hoz létre a keresési eredmények minden dokumentumához. Ez a megnövelt pontszám, amelyet úgy számítunk ki, hogy a pontozási profilt a meglévő reranker-pontszámra alkalmazzuk, nem rendelkezik garantált tartománylal (0–4), mint egy normál reranker-pontszám, és a pontszámok jelentősen magasabbak lehetnek 4-nél.

A szemantikai eredmények alapértelmezés szerint vannak rendezve @search.rerankerBoostedScore , ha létezik pontozási profil. Ha a rankingOrder tulajdonság nincs megadva, akkor BoostedRerankerScore a szemantikai konfiguráció alapértelmezett értéke.

Ebben a forgatókönyvben a rendszer kétszer használ pontozási profilt.

1. Először az indexben definiált pontozási profilt használja a rendszer a kezdeti L1 rangsorolási fázisban, amely a következő eredményekből emeli ki az eredményeket:

   • Szövegalapú lekérdezések (BM25 vagy RRF)
   • A vektoros lekérdezések szöveges része
   • Hibrid lekérdezések, amelyek mindkét típust egyesítik

2. Ezután a szemantikai rangsoroló újraértékeli a top 50 találatot, előmozdítva a szemantikai szempontból relevánsabb találatokat az élre. Ez a lépés törölheti a pontozási profil előnyeit. Például, ha a frissesség alapján növelted az értékelést, akkor a szemantikai átrendezés a saját logikájával cseréli le ezt az előnyt arra, amit a leginkább relevánsnak tart.

3. Végül a pontozási profil ismét alkalmazásra kerül az eredmények újrasorrendezése után, helyreállítva a kiemelések hatását a végső sorrendre. Ha növeli a frissességet, a szemantikailag rangsorolt eredményeket a rendszer a frissesség alapján újraértékeli.

Pontozási profilok engedélyezése szemantikai konfigurációban

A szemantikailag rangsorolt eredmények pontozási profiljainak engedélyezéséhez frissítse az indexet a rankingOrder szemantikai konfiguráció tulajdonságának beállításával. A PUT metódussal frissítheti az indexet a módosításaival. Nincs szükség index-újraépítésre.

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

Pontozási profilok letiltása szemantikai konfigurációban

Ha ki szeretné zárni a szemantikai reranker által megnövelt pontszám szerinti rendezést, állítsa a rankingOrder mezőt a reRankerScore értékre a szemantikai konfigurációban.

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

Még akkor is, ha nem engedélyezi a rendezést @search.rerankerBoostedScore, a boostedRerankerScore mező továbbra is megjelenik a válaszban, de már nem használja az eredmények rendezésére.

Példa lekérdezésre és válaszra

Kezdje egy szemantikai lekérdezéssel , amely egy pontozási profilt határoz meg. Ez a lekérdezés egy olyan keresési indexet céloz meg, amely rankingOrder-re van boostedRerankerScore beállítva.

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

A válasz tartalmazza az új rerankerBoostedScore, valamint az L1 @search.score és az L2 @search.rerankerScore. Az eredményeket a rendszer a következő szerint rendezi @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"
    }
  ]
}