Konfigurieren des semantischen Sortierers und Zurückgeben von Beschriftungstext in Suchergebnissen

Artikel
10/22/2024

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.

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 eines der folgenden Tools und SDKs (Software Development Kits) 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
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.

Melden Sie sich beim Azure-Portal an, und navigieren Sie zu einem Suchdienst, für den die semantische Rangfolge aktiviert ist.
Wählen Sie unter Indizes im linken Navigationsbereich einen Index aus.
Wählen Sie Semantische Konfigurationen und dann Semantische Konfiguration hinzufügen aus.
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.
Wählen Sie zum Speichern der Konfigurationseinstellungen Speichern aus.
Wählen Sie erneut Speichern auf der Indexseite aus, um die semantische Konfiguration im Index zu speichern.

Formulieren Sie eine Anforderung zum Erstellen oder Aktualisieren eines Index.

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

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")
                }
            })
        }
    }
};

Migrieren von Vorschauversionen

Falls Ihr Code für die semantische Rangfolge Vorschau-APIs verwendet, erfahren Sie in diesem Abschnitt, wie Sie zu stabilen Versionen migrieren. Sie können die Änderungsprotokolle prüfen, um die allgemeine Verfügbarkeit zu überprüfen:

„queryLanguage“ für semantischen Sortierer

Seit dem 14. Juli 2023 ist der semantische Sortierer sprachunabhängig. Sie kann Ergebnisse aus mehrsprachigen Inhalten ohne Verzerrung in Richtung einer bestimmten Sprache neu priorisieren. In Vorschauversionen wurde die Priorität von Ergebnissen, die nicht der von der Feldanalyse angegebenen Sprache entsprachen, durch die semantische Rangfolge heruntergesetzt.

Beenden Sie die Verwendung von queryLanguage in Ihrem Code, wenn Sie dieses Element für die semantische Rangfolge verwendet haben. Die queryLanguage-Eigenschaft gilt weiterhin für Features wie Rechtschreibkorrektur, aber nicht für die semantische Rangfolge.

„searchFields“ für semantischen Sortierer

Für die REST-API und alle SDK-Pakete, die auf Version 2021-04-30-Preview und höher abzielen, wird die searchFields-Eigenschaft nicht mehr für die semantische Rangfolge verwendet.

Verwenden Sie stattdessen die semanticConfiguration-Eigenschaft (in einem Suchindex), um zu bestimmen, welche Suchfelder in der semantischen Rangfolge verwendet werden. Fügen Sie semanticConfiguration zu einem Indexschema hinzu, um die Feldpriorisierung anzugeben, und folgen Sie den Anweisungen in diesem Artikel.

Sie können searchFields in Abfrageanforderungen beibehalten, wenn Sie damit die Volltextsuche auf die Liste der benannten Felder beschränken.

Nächste Schritte

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

Erstellen einer Semantikabfrage

Freigeben über