Konfigurieren des semantischen Sortierers und Zurückgeben von Beschriftungstext 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 Neusortierung konfigurieren.

Hinweis

Wenn Sie über Code verfügen, der eine Vorschau oder frühere API-Versionen aufruft, lesen Sie Migrieren von Code für semantische Rangfolge, um Hilfe beim Ändern des Codes zu erhalten.

Voraussetzungen

• Ein Suchdienst auf einer Basic-Dienstebene oder höher, vorbehaltlich der Regionsverfügbarkeit.

• Der semantische Sortierer muss für Ihren Suchdienst aktiviert sein.

• Ein vorhandener Suchindex mit Rich-Text-Inhalt. Die semantische Rangfolge gilt für Zeichenfolgenfelder (im Gegensatz zu Vektorfeldern) und eignet sich am besten für informative oder beschreibende Inhalte.

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 mit dem Index-Designer zum Hinzufügen einer semantischen Konfiguration.
• Visual Studio Code mit dem REST-Client und eine (REST)-API zum Erstellen oder Aktualisieren des 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

Eine semantische Konfiguration ist ein Abschnitt in Ihrem Index, der Feldeingaben für die semantische Rangfolge festlegt. Sie können eine semantische Konfiguration jederzeit und ohne erneute Erstellung hinzufügen oder aktualisieren. Wenn Sie mehrere Konfigurationen erstellen, können Sie eine Standardkonfiguration angeben. Geben Sie zur Abfragezeit in einer Abfrageanforderung eine semantische Konfiguration an, oder lassen Sie sie leer, um die Standardkonfiguration zu verwenden.

Eine semantische Konfiguration hat einen Namen und folgende Eigenschaften:

Eigenschaft	Merkmale
Feld „Title“ (Titel)	Eine kurze Zeichenfolge, idealerweise mit weniger als 25 Wörtern. Bei diesem Feld kann es sich um den Titel eines Dokuments, um den Namen eines Produkts oder um einen eindeutigen Bezeichner handeln. Falls Sie über kein geeignetes Feld verfügen, lassen Sie es leer.
Inhaltsfelder	Längere Textblöcke in natürlicher Sprache. Hierfür gelten die maximalen Tokeneingabegrenzwerte der Machine Learning-Modelle. Gängige Beispiele sind der Textkörper eines Dokuments, die Beschreibung eines Produkts oder anderer Freitext.
Schlüsselwortfelder	Eine Liste mit Schlüsselwörtern – beispielsweise die Tags in einem Dokument oder ein beschreibender Begriff (etwa die Kategorie eines Elements).

Sie können nur ein einzelnes Titelfeld angeben. Die Anzahl von Inhalts- und Schlüsselwortfeldern ist dagegen unbegrenzt. Listen Sie die Inhalts- und Schlüsselwortfelder in der Reihenfolge ihrer Priorität auf, da Felder mit niedrigerer Priorität möglicherweise abgeschnitten werden.

Bei allen Eigenschaften der semantischen Konfiguration gilt für die Felder, die Sie zuweisen, Folgendes:

• Sie müssen über die Attribute searchable und retrievable verfügen.
• Es muss sich um Zeichenfolgen vom Typ Edm.String oder Collection(Edm.String) bzw. um Zeichenfolgenunterfelder vom Typ Edm.ComplexType handeln.

Azure portal

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu einem Suchdienst, für den die semantische Rangfolge aktiviert ist.

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

3. Wählen Sie Semantische Konfigurationen und dann Semantische Konfiguration hinzufügen aus.

   

4. Geben Sie auf der Seite Neue semantische Konfiguration einen Namen für die semantische Konfiguration ein, und wählen Sie die Felder aus, die in der semantischen Konfiguration verwendet werden sollen. Nur durchsuchbare und abrufbare Zeichenfolgenfelder sind berechtigt. Achten Sie darauf, Inhaltsfelder und Schlüsselwortfelder in der Prioritätsreihenfolge aufzulisten.

   

5. Wählen Sie zum Speichern der Konfigurationseinstellungen Speichern aus.

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

REST-API

1. Formulieren Sie eine Anforderung zum Erstellen oder Aktualisieren eines Index.

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

   "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"
                       }
                   ]
               }
           }
       ]
   }
   

.NET SDK

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

Das folgende Beispiel stammt aus dem semantischen Rangfolgebeispiel, das vom Azure SDK-Team erstellt 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")
                }
            })
        }
    }
};

Nächste Schritte

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

Erstellen einer Semantikabfrage