Använda bedömningsprofiler med semantisk rankning i Azure AI-sökning

Du kan använda en bedömningsprofil för semantiskt rankade sökresultat, där bedömningsprofilen bearbetas sist.

För att säkerställa att bedömningsprofilen ger den avgörande poängen lägger semantisk rankning till ett svarsfält, @search.rerankerBoostedScore, som tillämpar bedömningsprofillogik på semantiskt rankade resultat. I sökresultat som inkluderar @search.score från rankning på nivå 1, @search.rerankerScore från semantisk rankning och @search.rerankerBoostedScore, sorteras resultaten efter @search.rerankerBoostedScore.

Förutsättningar

• Azure AI-sökning i valfri region som ger semantisk rangordning.

• Ett sökindex med en semantisk konfiguration som specificerar "rankingOrder": "boostedRerankerScore" och en bedömningsprofil som specificerar funktioner.

Begränsningar

Ökning av semantiskt rankade resultat gäller endast för bedömningsprofilfunktioner. Det går inte att öka om bedömningsprofilen endast består av viktade textfält.

Det här beteendet gäller för semantiska frågor som du skickar direkt till ett index, till exempel /docs/search. Agentbaserad hämtning tillämpar inte bedömningsprofiler för index, inklusive defaultScoringProfile i det underliggande indexet, och hämtningssvaren visar inte @search.rerankerBoostedScore. Mer information finns i Skapa en kunskapskälla för sökindex och Fråga efter en kunskapsbas.

Hur fungerar semantisk konfiguration med bedömningsprofiler?

När du kör en semantisk fråga som är associerad med en bedömningsprofil genereras en tredje sökpoäng, @search.rerankerBoostedScore ett värde, för varje dokument i sökresultaten. Den här ökade poängen, som beräknas genom att tillämpa poängprofilen på den befintliga rerankerpoängen, har inte ett garanterat intervall (0–4) som en normal rerankerpoäng, och poängen kan vara betydligt högre än 4.

Semantiska resultat sorteras som standard efter @search.rerankerBoostedScore om det finns en bedömningsprofil. Om egenskapen rankingOrder inte har angetts BoostedRerankerScore är standardvärdet i den semantiska konfigurationen.

I det här scenariot används en bedömningsprofil två gånger.

1. Först används bedömningsprofilen som definierats i indexet under den inledande L1-rangordningsfasen, vilket ökar resultatet från:

   • Textbaserade frågor (BM25 eller RRF)
   • Textdelen av vektorfrågor
   • Hybridfrågor som kombinerar båda typerna

2. Därefter värderar den semantiska rankern om de 50 bästa resultaten för att främja de mest semantiskt relevanta matchningarna till toppen. Det här steget kan radera fördelarna med poängprofilen. Om du till exempel boostar baserat på färskhet, ersätter semantisk omorganisering den boost med sin egen logik för vad som är mest relevant.

3. Slutligen tillämpas bedömningsprofilen igen, efter omrankningen, vilket säkerställer boostarnas inflytande över den slutliga resultatordningen. Om du höjer rankingen med hjälp av färskhet, omrankas de semantiskt rankade resultaten baserat på färskhet.

Aktivera bedömningsprofiler i semantisk konfiguration

Om du vill aktivera bedömningsprofiler för semantiskt rankade resultat uppdaterar du ett index genom att ange egenskapen för rankingOrder dess semantiska konfiguration. Använd PUT-metoden för att uppdatera indexet med dina revisioner. Det krävs ingen återskapande av index.

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

Inaktivera bedömningsprofiler i semantisk konfiguration

Om du vill välja bort sortering efter semantisk reranker-boostad poäng anger du rankingOrder fältet till reRankerScore värde i den semantiska konfigurationen.

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

Även om du väljer bort att sortera efter @search.rerankerBoostedScore, genereras fältet boostedRerankerScore fortfarande i svaret, men det används inte längre för att sortera resultaten.

Exempelfråga och svar

Börja med en semantisk fråga som anger en bedömningsprofil. Den här frågan riktar sig mot ett sökindex som har rankingOrder angetts till boostedRerankerScore.

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

Svaret innehåller den nya rerankerBoostedScore, tillsammans med L1 @search.score och L2 @search.rerankerScore. Resultaten sorteras efter @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"
    }
  ]
}