Usare i profili di punteggio con il ranker semantico in Azure AI Search

È possibile applicare un profilo di punteggio sui risultati della ricerca classificati semanticamente, in cui il profilo di punteggio viene elaborato per ultimo.

Per garantire che il profilo di punteggio fornisca il punteggio di determinazione, il classificatore semantico aggiunge un campo di risposta, @search.rerankerBoostedScore, che applica la logica del profilo di punteggio ai risultati classificati semanticamente. Nei risultati della ricerca che includono @search.score dalla classificazione di livello 1, @search.rerankerScore dal classificatore semantico e @search.rerankerBoostedScore, i risultati vengono ordinati in base a @search.rerankerBoostedScore.

Prerequisiti

• Azure AI Search in qualsiasi regione che fornisce la classificazione semantica.

• Indice di ricerca con una configurazione semantica che specifica "rankingOrder": "boostedRerankerScore" e un profilo di punteggio che specifica le funzioni.

Limitazioni

L'incremento dei risultati classificati semanticamente si applica solo alle funzioni del profilo di punteggio. Non esiste alcun aumento se il profilo di punteggio è costituito solo da campi di testo ponderati.

Questo comportamento si applica alle query semantiche inviate direttamente a un indice, ad esempio /docs/search. Il recupero agentico non applica i profili di punteggio dell'indice, incluso defaultScoringProfile nell'indice sottostante, e le risposte di recupero non espongono @search.rerankerBoostedScore. Per altre informazioni, vedere Creare un'origine dei dati dell'indice di ricerca e Eseguire una query in una base di conoscenza.

Come funziona la configurazione semantica con i profili di punteggio?

Quando si esegue una query semantica associata a un profilo di punteggio, viene generato un terzo punteggio di ricerca, @search.rerankerBoostedScore valore, per ogni documento nei risultati della ricerca. Il punteggio potenziato, calcolato applicando il profilo di punteggio al punteggio del reranker esistente, non ha un intervallo garantito di (0-4) come un normale punteggio del reranker, e i punteggi possono essere significativamente superiori a 4.

I risultati semantici vengono ordinati per @search.rerankerBoostedScore di default se esiste un profilo di punteggio. Se la rankingOrder proprietà non è specificata, BoostedRerankerScore è il valore predefinito nella configurazione semantica.

In questo scenario, un profilo di assegnazione dei punteggi viene usato due volte.

1. Prima di tutto, il profilo di punteggio definito nel tuo indice viene utilizzato durante la fase iniziale di classificazione L1, migliorando i risultati a partire da:

   • Query basate su testo (BM25 o RRF)
   • Parte di testo delle query vettoriali
   • Query ibride che combinano entrambi i tipi

2. Successivamente, il ranker semantico ricalcola i punteggi dei primi 50 risultati, promuovendo le corrispondenze più semanticamente pertinenti ai primi posti. Questo passaggio può cancellare il vantaggio del profilo di punteggio. Ad esempio, se l'incremento è stato effettuato in base alla novità, il riordino semantico utilizza la propria logica per determinare cosa è più rilevante.

3. Infine, il profilo di punteggio viene nuovamente applicato, dopo il riordinamento, ripristinando l'influenza degli incrementi sull'ordine finale dei risultati. Se si aumenta il peso della freschezza, i risultati classificati semanticamente vengono rivalutati in base alla freschezza.

Abilitare i profili di punteggio nella configurazione semantica

Per abilitare i profili di punteggio per i risultati classificati semanticamente, aggiornare un indice impostando la rankingOrder proprietà della relativa configurazione semantica. Utilizzare il metodo PUT per aggiornare l'indice con le revisioni. Non è necessaria alcuna ricompilazione dell'indice.

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

Disabilitare i profili di punteggio nella configurazione semantica

Per rifiutare l'ordinamento in base al punteggio con boosting del riclassificatore semantico, impostare il campo rankingOrder sul valore reRankerScore nella configurazione semantica.

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

Anche se si rinuncia all'ordinamento tramite @search.rerankerBoostedScore, il campo boostedRerankerScore è ancora incluso nella risposta, ma non viene più usato per ordinare i risultati.

Query e risposta di esempio

Iniziare con una query semantica che specifica un profilo di punteggio. Questa query è destinata a un indice di ricerca che ha rankingOrder impostato su boostedRerankerScore.

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

La risposta include il nuovo rerankerBoostedScore, insieme a L1 @search.score e L2 @search.rerankerScore. I risultati vengono ordinati in base a @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"
    }
  ]
}