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

Você pode aplicar um perfil de pontuação sobre os resultados da pesquisa semanticamente classificados, em que o perfil de pontuação é processado pela última vez.

Para garantir que o perfil de pontuação forneça a pontuação determinante, o classificador semântico adiciona um campo de resposta, @search.rerankerBoostedScoreque aplica a lógica de perfil de pontuação em resultados semanticamente classificados. Nos resultados da pesquisa que incluem a classificação de nível 1 @search.score, o ranking semântico @search.rerankerScore 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 reforço dos resultados semanticamente classificados aplica-se somente às funções do perfil de pontuação. Não haverá aumento se o perfil de pontuação consistir apenas em campos de texto ponderados.

Esse comportamento se aplica a consultas semânticas que você envia diretamente para um índice, como /docs/search. A recuperação por meio de agentes não aplica os perfis de pontuação de índice, incluindo defaultScoringProfile no índice subjacente, e as respostas recuperadas não vêm à superfície @search.rerankerBoostedScore. Para obter mais informações, consulte Criar uma fonte de conhecimento de índice de pesquisa e consultar uma base de dados de conhecimento.

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

Quando você executa uma consulta semântica associada a um perfil de pontuação, uma terceira pontuação de pesquisa, @search.rerankerBoostedScore valor, é gerada para cada documento em seus resultados de pesquisa. Essa pontuação aumentada, calculada aplicando o perfil de pontuação à pontuação de reclassificador existente, não tem um intervalo garantido (0 a 4) como uma pontuação de reclassificador normal e as pontuações podem ser significativamente maiores que 4.

Os resultados semânticos são classificados por @search.rerankerBoostedScore padrão se houver um perfil de pontuação. Se a rankingOrder propriedade não for especificada, será BoostedRerankerScore o valor padrão na configuração semântica.

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

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

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

2. Em seguida, o classificador semântico reavalia os 50 melhores resultados, promovendo as correspondências semanticamente mais relevantes para o topo. Esta etapa pode eliminar o benefício do perfil de pontuação. Por exemplo, se você intensificou com base na recentidade, a reordenação semântica substitui essa intensificação por sua própria lógica do que é mais relevante.

3. Por fim, o perfil de pontuação é aplicado novamente após a reclassificação, restaurando a influência dos intensificadores sobre a ordem dos resultados finais. Se você intensificar pela recentidade, os resultados semanticamente classificados serão pontuados novamente com base na recentidade.

Habilitar perfis de pontuação na configuração semântica

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

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

Desabilitar perfis de pontuação na configuração semântica

Para desativar a classificação pela pontuação aumentada do reclassificador 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 você opte por não classificar por @search.rerankerBoostedScore, o campo boostedRerankerScore ainda aparece na resposta, não sendo mais usado para classificar os resultados.

Exemplo de consulta e resposta

Comece com uma consulta semântica que especifica um perfil de pontuação. Essa consulta tem como destino um índice de pesquisa definido rankingOrder 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, ao lado do L1 @search.score e do L2 @search.rerankerScore. Os resultados sã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"
    }
  ]
}