Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
Foundry IQ (Azure KI-Suche) in jeder Region, die semantisches Ranking 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 auf Foundry IQ. 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 Foundry IQ-Dienst.
Die 2026-11-01-preview-Version der REST-API 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, indem Sie den Index-Designer verwenden, um eine semantische Konfiguration hinzuzufügen.
- Visual Studio Code mit dem REST-Client und einer REST-API (Create or Update Index).
- 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 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
searchableundretrievable - Zeichenfolgen vom Typ
Edm.String,Collection(Edm.String)und Zeichenfolgen-Unterfelder vonEdm.ComplexType
Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.
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.
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.