Verwenden von Bewertungsprofilen mit semantischer Rangfolge in Azure KI-Suche

Sie können ein Bewertungsprofil über semantisch bewertete Suchergebnisse anwenden, wobei das Bewertungsprofil zuletzt verarbeitet wird.

Um sicherzustellen, dass das Bewertungsprofil die bestimmende Bewertung bereitstellt, fügt der semantische Rangierer ein Antwortfeld hinzu, @search.rerankerBoostedScoredas bewertungsprofillogik auf semantisch bewertete Ergebnisse anwendet. In Suchergebnissen, die @search.score aus der Rangfolge der Ebene 1, @search.rerankerScore aus dem semantischen Ranker und @search.rerankerBoostedScore umfassen, werden die Ergebnisse nach @search.rerankerBoostedScore sortiert.

Voraussetzungen

• Azure KI-Suche in jeder region, die semantische Rangfolge bereitstellt.

• Ein Suchindex mit einer semantischen Konfiguration, die angibt "rankingOrder": "boostedRerankerScore" , und ein Bewertungsprofil, das Funktionen angibt.

Einschränkungen

Die Verstärkung semantisch gerankter Ergebnisse gilt nur für Scoring-Profilfunktionen. Es gibt keine Verstärkung, wenn das Bewertungsprofil nur aus gewichteten Textfeldern besteht.

Dieses Verhalten gilt für semantische Abfragen, die Sie direkt an einen Index senden, wie z. B. /docs/search. Der agentische Abruf wendet keine Indexbewertungsprofile an, einschließlich defaultScoringProfile des zugrunde liegenden Indexes, und das Abrufen von Antworten wird nicht angezeigt @search.rerankerBoostedScore. Weitere Informationen finden Sie unter Erstellen einer Wissensquelle für einen Suchindex und Abfragen einer Wissensdatenbank.

Wie funktioniert die semantische Konfiguration mit Bewertungsprofilen?

Wenn Sie eine semantische Abfrage ausführen, die einem Bewertungsprofil zugeordnet ist, wird für jedes Dokument in Ihren Suchergebnissen ein dritter Suchwert, @search.rerankerBoostedScore Wert, generiert. Diese erhöhte Bewertung, die durch Anwenden des Bewertungsprofils auf die vorhandene Rerankerbewertung berechnet wird, verfügt nicht über einen garantierten Bereich (0-4) wie eine normale Rerankerbewertung, und die Ergebnisse können deutlich höher als 4 sein.

Semantische Ergebnisse werden von @search.rerankerBoostedScore standardmäßig sortiert, wenn ein Bewertungsprofil vorhanden ist. Wenn die rankingOrder Eigenschaft nicht angegeben ist, ist der BoostedRerankerScore Standardwert in der semantischen Konfiguration.

In diesem Szenario wird zweimal ein Bewertungsprofil verwendet.

1. Zunächst wird das in Ihrem Index definierte Bewertungsprofil während der ersten L1-Bewertungsphase verwendet, wodurch die Ergebnisse erhöht werden:

   • Textbasierte Abfragen (BM25 oder RRF)
   • Der Textbereich von Vektorabfragen
   • Hybridabfragen, die beide Typen kombinieren

2. Als Nächstes bewertet der semantische Ranker die 50 besten Ergebnisse neu und fördert semantisch relevantere Übereinstimmungen an die Spitze. Dieser Schritt kann den Vorteil des Bewertungsprofils löschen. Wenn Sie beispielsweise basierend auf Aktualität hochgestuft haben, ersetzt die semantische Neuanordnung diese Hochstufung durch ihre eigene Logik davon, was am relevantesten erscheint.

3. Schließlich wird das Bewertungsprofil nach der Neusortierung erneut angewendet, wodurch der Einfluss der Hochstufungen auf die endgültige Reihenfolge der Ergebnisse wiederhergestellt wird. Wenn Sie nach Aktualität hochstufen, werden die semantischen Ergebnisse basierend auf der Aktualität neu bewertet.

Aktivieren von Bewertungsprofilen in der semantischen Konfiguration

Um Bewertungsprofile für semantisch bewertete Ergebnisse zu aktivieren, aktualisieren Sie einen Index , indem Sie die rankingOrder Eigenschaft der semantischen Konfiguration festlegen. Verwenden Sie die PUT-Methode, um den Index mit Ihren Überarbeitungen zu aktualisieren. Es ist keine Indexneuerstellung erforderlich.

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

Deaktivieren von Bewertungsprofilen in der semantischen Konfiguration

Wenn Sie die Sortierung nach der durch den semantischen Reranker verstärkten Bewertung deaktivieren möchten, legen Sie das rankingOrder-Feld in der semantischen Konfiguration auf den reRankerScore-Wert fest.

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

Selbst wenn Sie die Sortierung @search.rerankerBoostedScoredeaktivieren, wird das boostedRerankerScore Feld weiterhin in der Antwort erstellt, aber es wird nicht mehr zum Sortieren von Ergebnissen verwendet.

Beispielabfrage und -antwort

Beginnen Sie mit einer semantischen Abfrage , die ein Bewertungsprofil angibt. Diese Abfrage zielt auf einen Suchindex ab, bei dem rankingOrder auf boostedRerankerScore gesetzt wurde.

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

Die Antwort umfasst die neue rerankerBoostedScore, neben der L1 @search.score und der L2 @search.rerankerScore. Die Ergebnisse werden sortiert nach @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"
    }
  ]
}