Delen via

Scoreprofielen gebruiken met een semantische rangschikking in Azure AI Search

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 @search.score van rangschikking op niveau 1, @search.rerankerScore van semantische rangschikking en @search.reRankerBoostedScore omvatten, worden de resultaten gesorteerd op @search.reRankerBoostedScore.

Prerequisites

Limitations

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

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, berekend door het scoreprofiel toe te passen op de bestaande herwaardeerderscore, heeft geen gegarandeerd bereik (0-4) zoals bij een normale herwaardeerderscore en scores kunnen aanzienlijk hoger zijn dan 4.

Semantische resultaten worden standaard gesorteerd op @search.rerankerBoostedScore indien er een scoreprofiel bestaat. 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, waardoor de resultaten worden verbeterd van:

    • Op tekst gebaseerde query's (BM25 of RRF)
    • Het tekstgedeelte van vectorqueries
    • 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 op actualiteit sorteert, worden de semantisch gerangschikte resultaten opnieuw beoordeeld op basis van actualiteit.

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=2025-09-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=2025-09-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

Zelfs als u zich afmeldt voor sorteren op @search.rerankerBoostedScore, blijft het boostedRerankerScore veld aanwezig 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 richt zich op een zoekindex die rankingOrder is ingesteld op boostedRerankerScore.

POST /indexes/{index-name}/docs/search?api-version=2025-09-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"
    }
  ]
}
  • Last updated on