Konfigurieren von semantischen Rangfolgen und Zurückgeben von Beschriftungen in Suchergebnissen

Die semantische Sortierung durchläuft ein initiales Resultset und wendet eine L2-Bewertungsmethode an, die die semantisch relevantesten Ergebnisse an den Anfang des Stapels stellt. Sie können auch semantische Beschriftungen mit Hervorhebungen der relevantesten Begriffe und Ausdrücke sowie semantische Antworten abrufen.

In diesem Artikel wird erläutert, wie Sie einen Suchindex für die semantische Umrankung konfigurieren.

Hinweis

Wenn Sie über vorhandenen Code verfügen, der eine Vorschau oder frühere API-Versionen aufruft, finden Sie Informationen zum Migrieren des semantischen Rangfolgencodes , um Hilfe beim Ändern des Codes zu erhalten.

Voraussetzungen

Azure KI-Suche in einer beliebigen Region, die semantische Rangfolgen bereitstellt.
Ein vorhandener Suchindex mit Rich-Text-Inhalt. Die semantische Rangfolge gilt für Zeichenfolgenfelder (nonvector) und eignet sich am besten für Inhalte, die informations- oder beschreibend sind.
Berechtigung zum Erstellen und Verwenden von Objekten in Azure KI-Suche. Wir empfehlen den rollenbasierten Zugriff, aber Sie können API-Schlüssel verwenden, wenn eine Rollenzuweisung nicht machbar ist. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem Suchdienst.
Die Version 2026-05-01-Preview der REST-APIs des Suchdiensts.

Auswählen eines Clients

Sie können eine semantische Konfiguration für neue oder vorhandene Indizes angeben, indem Sie eines der folgenden Tools und Software Development Kits (SDKs) verwenden, um eine semantische Konfiguration hinzuzufügen:

Azure portal mithilfe des Index-Designers eine semantische Konfiguration hinzufügen.
Visual Studio Code mit dem REST-Client und einer Create or Update Index (REST)-API.
Azure SDK für .NET
Azure SDK für Python
Azure SDK für Java
Azure SDK für JavaScript

Hinzufügen einer semantischen Konfiguration

Einige Workloads erstellen automatisch eine semantische Konfiguration. Wenn Sie agentic retrieval und eine knowledge source verwenden, die Inhalte indiziert für Azure KI-Suche, verfügt Ihr generierter Index bereits über eine semantische Konfiguration, die für Ihre Inhalte geeignet ist.

Für andere Workloads können Sie eine semantische Konfiguration selbst einrichten. Eine semantische Konfiguration ist ein Abschnitt in Ihrem Index, der die feldeingaben festlegt, die für die semantische Rangfolge verwendet werden. Sie können jederzeit eine semantische Konfiguration hinzufügen oder aktualisieren, ohne dass eine Neuerstellung erforderlich ist. Wenn Sie mehrere Konfigurationen erstellen, können Sie einen Standardwert angeben. Geben Sie zur Abfragezeit eine semantische Konfiguration für eine Abfrageanforderung an, oder lassen Sie sie leer, um die Standardeinstellung zu verwenden.

Sie können bis zu 100 semantische Konfigurationen in einem einzelnen Index erstellen.

Wenn die semantische Konfiguration optional ist

Important

Diese Features und Funktionen sind Teil der REST-API 2026-05-01-Preview. Die 2026-05-01-preview wird Ihnen als Teil Ihres Azure-Abonnements zur Verfügung gestellt und unterliegt den für „Previews“ geltenden Bestimmungen in den Microsoft-Produktbestimmungen, dem Nachtrag zum Datenschutz für Microsoft-Produkte und -Dienste („DPA“) und den Ergänzenden Nutzungsbedingungen für Microsoft Azure-Vorschauen.

Die Vorschauversion 2026-05-01 unterstützt Verbindungen mit anderen Microsoft-Diensten und Diensten von Drittanbietern. Die Nutzung dieser Dienste unterliegt den jeweiligen Bestimmungen und kann dazu führen, dass Daten außerhalb der Azure-Compliancegrenze verarbeitet oder gespeichert werden und dass Daten in die Azure-Compliancegrenze fließen.

Es liegt in Ihrer Verantwortung, zu verwalten, ob Ihre Daten außerhalb der Compliance- und geografischen Grenzen Ihrer Organisation und alle damit verbundenen Auswirkungen fließen und dass entsprechende Berechtigungen, Grenzen und Genehmigungen bereitgestellt werden.

Sie sind dafür verantwortlich, Anwendungen, die Sie im Kontext Ihrer spezifischen Anwendungsfälle erstellen, sorgfältig zu überprüfen und zu testen und alle geeigneten Entscheidungen und Anpassungen zu treffen. Dazu gehört die Implementierung ihrer eigenen verantwortungsvollen KI-Entschärfungen, wie Metaprompts, Inhaltsfilter oder andere Sicherheitssysteme, und sicherzustellen, dass Ihre Anwendungen angemessene Qualität, Zuverlässigkeit, Sicherheit und Vertrauenswürdigkeitsstandards erfüllen. Weitere Informationen finden Sie im Azure KI-Suche Transparenzhinweis.

In der 2026-05-01-preview-API können unterstützte agentische Retrievalabläufe das Rankingverhalten von Azure KI-Suche verwenden, ohne dass im zugrunde liegenden Index eine explizite semantische Konfiguration erforderlich ist. Dieses Vorschauverhalten hilft Teams, mit dem Abruf der Wissensbasis zu beginnen, ohne die Erstellung der semantischen Konfiguration zu blockieren.

Diese Änderung entfernt keine klassische Konfiguration der semantischen Rangfolge. Definieren Sie weiterhin eine semantische Konfiguration für klassische semantische Suchabfragen, ältere API-Versionen und Workloads, die explizite Kontrolle über Titel-, Inhalts- und Schlüsselwortfelder benötigen.

Für Suchindex-Wissensquellen semanticConfigurationName bleibt eine unterstützte Eigenschaft. Legen Sie sie fest, wenn die Wissensquelle eine bestimmte semantische Konfiguration verwenden soll. In unterstützten 2026-05-01-preview agentischen Abrufflüssen können Sie ihn weglassen, wenn der Dienst das Vorschauverhalten verwenden soll, das keine explizite semantische Konfiguration für den zugrunde liegenden Index erfordert.

Die semantische Konfiguration ist nur für unterstützte agentische Abrufabläufe zum Abrufen aus der Knowledge Base optional, die die 2026-05-01-preview API verwenden. Klassische semantische Suchabfragen und ältere API-Versionen erfordern weiterhin eine semantische Konfiguration, wenn Sie die semantische Rangfolge verwenden. Wenn Sie einen Index ohne semantische Konfiguration für den Vorschauablauf erstellen, gehen Sie nicht davon aus, dass derselbe Index mit GA- oder älteren Semantikbewertungs-APIs unverändert verwendet werden kann.

Eine semantische Konfiguration weist einen Namen und die folgenden Eigenschaften auf:

Eigenschaft	Merkmale
Titelfeld	Eine kurze Zeichenfolge, idealerweise unter 25 Wörtern. Bei diesem Feld kann es sich um den Titel eines Dokuments, den Namen eines Produkts oder um einen eindeutigen Bezeichner handeln. Wenn Sie kein geeignetes Feld haben, lassen Sie es leer.
Inhaltsfelder	Längere Textabschnitte in natürlicher Sprache, vorbehaltlich maximaler Tokeneingabegrenzwerte für die Machine Learning-Modelle. Häufige Beispiele sind der Textkörper eines Dokuments, eine Beschreibung eines Produkts oder anderer Freiformtext.
Schlüsselwortfelder	Eine Liste von Schlüsselwörtern, z. B. die Tags in einem Dokument oder ein beschreibender Ausdruck, z. B. die Kategorie eines Elements.

Sie können nur ein Titelfeld angeben, sie können jedoch beliebig viele Inhalts- und Schlüsselwortfelder enthalten. Für Inhalts- und Schlüsselwortfelder sollten die Felder in der Reihenfolge ihrer Priorität aufgelistet werden, da Felder mit niedrigerer Priorität möglicherweise gekürzt werden.

Für alle semantischen Konfigurationseigenschaften müssen die Felder, die Sie zuweisen, wie folgt sein:

Zugeordnet als searchable und retrievable
Zeichenfolgen vom Typ Edm.String, Collection(Edm.String) und Zeichenfolgen-Unterfelder von Edm.ComplexType

Wechseln Sie zum Suchdienst im Azure-Portal.
Wählen Sie in den Indizes im linken Navigationsbereich einen Index aus.
Wählen Sie semantische Konfigurationen und dann " Semantikkonfiguration hinzufügen" aus.
Geben Sie auf der Seite "Neue semantische Konfiguration " einen Semantikkonfigurationsnamen ein, und wählen Sie die Felder aus, die in der semantischen Konfiguration verwendet werden sollen. Nur durchsuchbare und abrufbare Zeichenfolgenfelder sind berechtigt. Stellen Sie sicher, dass Inhaltsfelder und Schlüsselwortfelder in der Prioritätsreihenfolge aufgeführt werden.
Wählen Sie "Speichern" aus, um die Konfigurationseinstellungen zu speichern.
Wählen Sie " Speichern" auf der Indexseite erneut aus, um die semantische Konfiguration im Index zu speichern.

Formulieren sie eine Create- oder Update Index-Anforderung .

Fügen Sie der Indexdefinition eine semantische Konfiguration hinzu, z. B. nach scoringProfiles oder suggesters. Die Angabe eines Standardwerts ist optional, aber nützlich, wenn Sie mehrere Konfigurationen haben.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

Verwenden Sie die SemanticConfiguration-Klasse im Azure SDK für .NET.

Das folgende Beispiel stammt aus dem semantic Ranking-Beispiel das vom Azure SDK Team verfasst wurde.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Aktivieren Sie die Vorabversion der semantischen Ranking-Modelle

Hinweis

Dieses Feature befindet sich derzeit in der Vorschau. Diese Vorschau wird ohne Vereinbarung auf Serviceebene bereitgestellt und wird für Produktionsworkloads nicht empfohlen. Bestimmte Features werden möglicherweise nicht unterstützt oder weisen eingeschränkte Funktionen auf. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Mithilfe von REST-APIs in der Vorschau und Azure-SDKs in der Vorschau, die diese Eigenschaft bereitstellen, können Sie einen Index optional so konfigurieren, dass er vorab veröffentlichte Modelle für das semantische Ranking verwendet, wenn ein solches Modell in Ihrer Region bereitgestellt wurde. Es gibt keinen Mechanismus, um zu wissen, ob eine Vorabversion verfügbar ist oder ob sie für eine bestimmte Abfrage verwendet wurde. Aus diesem Grund wird empfohlen, diese Eigenschaft in Testumgebungen zu verwenden, und nur dann, wenn Sie die neuesten semantischen Bewertungsmodelle ausprobieren möchten.

Die Konfigurationseigenschaft ist "flightingOptIn": trueund wird im Semantikkonfigurationsbereich eines Indexes festgelegt. Die Eigenschaft ist standardmäßig null oder falsch. Sie können sie jederzeit für eine Erstellungs- oder Aktualisierungsanforderung festlegen und wirkt sich auf semantische Abfragen aus, die vorwärts gehen, vorausgesetzt, die Abfrage legt eine semantische Konfiguration fest, die die Eigenschaft enthält.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-05-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Nächste Schritte

Testen Sie die semantische Konfiguration, indem Sie eine semantische Abfrage ausführen.

Erstellen einer semantischen Abfrage

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-03