Verwenden von Bewertungsprofilen mit semantischem Ranker in Foundry IQ (Azure KI-Suche)

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

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

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. Agentic-Abruf akzeptiert scoringProfile oder scoringParameters eingaben nicht. Der zugrunde liegende Index defaultScoringProfile beeinflusst die Auswahl von Kandidaten in der ersten Phase, steuert aber nicht direkt das semantische Neuranking, und Antworten beim Abrufen enthalten @search.rerankerBoostedScore nicht. 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-10-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-10-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-10-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"
    }
  ]
}