Use perfis de pontuação com classificador semântico no Pesquisa de IA do Azure

Pode aplicar um perfil de pontuação sobre resultados de pesquisa classificados semanticamente, onde o perfil de pontuação é processado por último.

Para garantir que o perfil de pontuação fornece a pontuação determinante, o classificador semântico adiciona um campo de resposta, @search.rerankerBoostedScore, que aplica a lógica do perfil de pontuação em resultados classificados semanticamente. Em resultados de pesquisa que incluem @search.score do ranking de nível 1, @search.rerankerScore do classificador semântico, e @search.rerankerBoostedScore, os resultados são ordenados por @search.rerankerBoostedScore.

Pré-requisitos

• Pesquisa de IA do Azure em qualquer região que forneça classificação semântica.

• Um índice de pesquisa com uma configuração semântica que especifica "rankingOrder": "boostedRerankerScore" e um perfil de pontuação que especifica funções.

Limitações

O aumento dos resultados classificados semanticamente aplica-se apenas a funções de pontuação. Não há aumento se o perfil de pontuação for apenas de campos de texto ponderados.

Este comportamento aplica-se a consultas semânticas que envia diretamente para um índice, como /docs/search. A recuperação agêntica não aplica perfis de pontuação do índice, incluindo defaultScoringProfile no índice subjacente, e as respostas obtidas não apresentam @search.rerankerBoostedScore. Para mais informações, consulte Criar uma fonte de conhecimento de índice de pesquisa e Consultar uma base de conhecimento.

Como funciona a configuração semântica com os perfis de pontuação?

Quando executa uma consulta semântica associada a um perfil de avaliação, é gerado um terceiro valor de pontuação de pesquisa, @search.rerankerBoostedScore, para cada documento nos seus resultados. Esta pontuação aumentada, calculada aplicando o perfil de pontuação à pontuação de reclassificação existente, não tem um intervalo garantido (0–4) como uma pontuação normal de reclassificação, e as pontuações podem ser significativamente superiores a 4.

Os resultados semânticos são ordenados por @search.rerankerBoostedScore, por defeito, caso exista um perfil de pontuação. Se a rankingOrder propriedade não for especificada, então BoostedRerankerScore é o valor padrão na configuração semântica.

Neste cenário, um perfil de pontuação é usado duas vezes.

1. Primeiro, o perfil de pontuação definido no seu índice é usado durante a fase inicial de classificação nível L1, melhorando os resultados de:

   • Consultas baseadas em texto (BM25 ou RRF)
   • A parte de texto das consultas vetoriais
   • Consultas híbridas que combinam ambos os tipos

2. De seguida, o classificador semântico reavalia os 50 melhores resultados, promovendo partidas mais semanticamente relevantes para o topo. Este passo pode eliminar o benefício do perfil de pontuação. Por exemplo, se fizeste boost com base na frescura, então a reordenação semântica substitui esse boost pela sua própria lógica do que é mais relevante.

3. Finalmente, o perfil de pontuação é aplicado novamente, após a reclassificação, restaurando a influência dos aumentos no ordenamento final dos resultados. Se aumentares pela frescura, os resultados classificados semanticamente são reavaliados com base na frescura.

Ativar perfis de pontuação em configuração semântica

Para permitir perfis de pontuação para resultados semanticamente classificados, atualize um índice definindo a rankingOrder propriedade da sua configuração semântica. Use o método PUT para atualizar o índice com as suas revisões. Não é necessária reconstrução do índice.

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

Desativar perfis de pontuação em configuração semântica

Para optar por não ordenar pela pontuação aumentada do reranker semântico, defina o campo rankingOrder para o valor reRankerScore na configuração semântica.

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

Mesmo que optes por não ordenar por @search.rerankerBoostedScore, o boostedRerankerScore campo continua a ser produzido na resposta, mas já não é usado para ordenar resultados.

Exemplo de consulta e resposta

Comece com uma consulta semântica que especifique um perfil de pontuação. Esta consulta dirige-se a um índice de pesquisa que tem rankingOrder definido como boostedRerankerScore.

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

A resposta inclui o novo rerankerBoostedScore, juntamente com o L1 @search.score e o L2 @search.rerankerScore. Os resultados estão ordenados por @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"
    }
  ]
}