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

Hinweis

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.

Important

Features oder Funktionen, die in diesem Artikel als "Vorschau" gekennzeichnet sind, befinden sich in der öffentlichen Vorschau und unterliegen den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Spezifische Vorschaubedingungen für Foundry IQ (Azure KI-Suche) finden Sie unter Vorschaufunktionen.

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

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:

Hinzufügen einer semantischen Konfiguration

Einige Workloads erstellen automatisch eine semantische Konfiguration. Wenn Sie agentische Abrufe und eine Wissensquelle verwenden, die Inhalte auf Foundry IQ indiziert, verfügt Ihr generierter Index bereits über eine semantische Konfiguration, die für Ihre Inhalte geeignet ist.

Tip

Ab der 2026-05-01-preview API-Version erfordern unterstützte agentische Abruf-Knowledge Base-Flüsse keine explizite semantische Konfiguration. Diese Ausnahme gilt nicht für klassische semantische Rangfolgenabfragen oder ältere API-Versionen. Weitere Informationen finden Sie unter Erstellen einer Wissensquelle für den Suchindex.

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.

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
  1. Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.

  2. Wählen Sie in den Indizes im linken Navigationsbereich einen Index aus.

  3. Wählen Sie semantische Konfigurationen und dann " Semantikkonfiguration hinzufügen" aus.

    Screenshot der Option zum Hinzufügen einer semantischen Konfiguration im Azure-Portal.

  4. 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.

    Screenshot, auf dem gezeigt wird, wie Sie eine semantische Konfiguration im Azure-Portal erstellen.

  5. Wählen Sie "Speichern" aus, um die Konfigurationseinstellungen zu speichern.

  6. Wählen Sie " Speichern" auf der Indexseite erneut aus, um die semantische Konfiguration im Index zu speichern.

Melden Sie sich für semantische Bewertungsmodelle vorab an (Vorschau)

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-11-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.