Scoreprofielen gebruiken met een semantische rangschikking in Azure AI Zoeken

U kunt een scoreprofiel toepassen op semantisch gerangschikte zoekresultaten, waarbij het scoreprofiel voor het laatst wordt verwerkt.

Om ervoor te zorgen dat het scoreprofiel de score bepaalt, voegt de semantische ranker een antwoordveld toe, @search.rerankerBoostedScorewaarmee scoreprofiellogica wordt toegepast op semantisch gerangschikte resultaten. In zoekresultaten die bevatten @search.score uit rangschikking op niveau 1, @search.rerankerScore van semantische rangschikking en @search.rerankerBoostedScore, worden de resultaten gesorteerd op @search.rerankerBoostedScore.

Voorwaarden

• Azure AI Zoeken in elke regio die semantische rangschikking biedt.

• Een zoekindex met een semantische configuratie die "rankingOrder": "boostedRerankerScore" specificeert en een scoreprofiel dat functies specificeert.

Beperkingen

Het verhogen van semantisch gerangschikte resultaten is alleen van toepassing op scoreprofielfuncties. Er is geen boost als het scoreprofiel alleen bestaat uit gewogen tekstvelden.

Dit gedrag is van toepassing op semantische query's die u rechtstreeks naar een index verzendt, zoals /docs/search. Agentische retrieval past geen indexscoreprofielen toe, met inbegrip van defaultScoringProfile op de onderliggende index, en in de ophaalreacties wordt @search.rerankerBoostedScore niet weergegeven. Zie Een zoekindexkennisbron maken en een knowledge base opvragen voor meer informatie.

Hoe werkt semantische configuratie met scoreprofielen?

Wanneer u een semantische query uitvoert die is gekoppeld aan een scoreprofiel, wordt er een derde zoekscore, @search.rerankerBoostedScore waarde, gegenereerd voor elk document in uw zoekresultaten. Deze verhoogde score, die wordt berekend door het scoreprofiel toe te passen op de bestaande rerankerscore, heeft geen gegarandeerd bereik (0-4) zoals een normale rerankerscore, en de scores kunnen aanzienlijk hoger zijn dan 4.

Als er een scoreprofiel bestaat, worden semantische resultaten standaard gesorteerd door @search.rerankerBoostedScore. Als de rankingOrder eigenschap niet is opgegeven, is dit BoostedRerankerScore de standaardwaarde in de semantische configuratie.

In dit scenario wordt twee keer een scoreprofiel gebruikt.

1. Eerst wordt het scoreprofiel dat in uw index is gedefinieerd gebruikt tijdens de eerste L1-rangschikkingsfase, waarbij de resultaten worden verbeterd van:

   • Op tekst gebaseerde query's (BM25 of RRF)
   • Het tekstdeel van vectorvragen
   • Hybride query's die beide typen combineren

2. Vervolgens geeft de semantische ranker de top 50 resultaten opnieuw aan, wat meer semantisch relevante overeenkomsten naar de top promoveert. Met deze stap kunt u het voordeel van het scoreprofiel wissen. Als u bijvoorbeeld een boost hebt gegeven op basis van frisheid, vervangt semantische volgorde die boost door zijn eigen logica van wat het meest relevant is.

3. Ten slotte wordt het scoreprofiel opnieuw toegepast, na opnieuw rangschikken, waardoor de invloed van de boosts op de uiteindelijke volgorde van de resultaten wordt hersteld. Als u de versheid verhoogt, worden de semantisch gerangschikte resultaten opnieuw gescored op basis van versheid.

Scoreprofielen in semantische configuratie inschakelen

Als u scoreprofielen wilt inschakelen voor semantisch gerangschikte resultaten, werkt u een index bij door de eigenschap van de rankingOrder semantische configuratie in te stellen. Gebruik de PUT-methode om de index bij te werken met uw revisies. Er is geen index opnieuw opbouwen vereist.

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

Scoreprofielen uitschakelen in semantische configuratie

Als u zich wilt afmelden voor sorteren op semantische herrankeringsscore, stelt u het rankingOrder veld in op reRankerScore waarde in de semantische configuratie.

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

Zelfs als u ervoor kiest om niet te sorteren volgens @search.rerankerBoostedScore, wordt het boostedRerankerScore-veld nog steeds opgenomen in het antwoord, maar wordt het niet meer gebruikt om resultaten te sorteren.

Voorbeeldquery en antwoord

Begin met een semantische query waarmee een scoreprofiel wordt opgegeven. Deze query is gericht op een zoekindex die rankingOrder is ingesteld op boostedRerankerScore.

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

Het antwoord bevat de nieuwe rerankerBoostedScore, naast de L1 @search.score en de L2 @search.rerankerScore. Resultaten worden gesorteerd op @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"
    }
  ]
}