Erstellen einer Semantikabfrage in Azure KI-Suche

In diesem Artikel erfahren Sie, wie Sie eine semantische Rangfolge für ein Resultset aufrufen und dabei die semantisch relevantesten Ergebnisse an den Anfang des Stapels heraufstufen. Sie können auch semantische Beschriftungen mit Hervorhebungen der relevantesten Begriffe und Ausdrücke sowie semantische Antworten abrufen.

Voraussetzungen

• Suchdienst mit Basic-Dienstebene oder höher mit semantischer Rangfolge

• Vorhandener Suchindex mit semantischer Konfiguration und Rich-Text-Inhalt

• Bei Bedarf finden Sie hier eine Einführung in das Feature.

Hinweis

Sowohl Beschriftungen als auch Antworten werden wörtlich aus dem Text im Suchdokument extrahiert. Das semantische Subsystem nutzt maschinelles Leseverständnis, um Inhalte mit den Merkmalen einer Beschriftung oder Antwort zu erkennen, erstellt aber keine neuen Sätze oder Ausdrücke. Aus diesem Grund funktionieren Inhalte, die Erläuterungen oder Definitionen enthalten, am besten für die semantische Rangfolge. Wenn Sie eine Interaktion im Chatstil mit generierten Antworten benötigen, lesen Sie Retrieval Augmented Generation (RAG).

Auswählen eines Clients

Wählen Sie einen Suchclient aus, der die semantische Rangfolge unterstützt. Hier einige Optionen:

• Azure-Portal mit dem Index-Designer zum Hinzufügen einer semantischen Konfiguration.
• Visual Studio Code mit einem REST-Client
• Azure SDK für .NET
• Azure-SDK für Python
• Azure SDK für Java
• Azure SDK für JavaScript

Vermeiden von Features, die die Relevanzbewertung umgehen

Mehrere Abfragefunktionen in Azure KI Search umgehen die Relevanzbewertung oder sind anderweitig nicht mit der semantischen Rangfolge kompatibel. Wenn Ihre Abfragelogik die folgenden Features enthält, können Sie die semantische Rangfolge für Ihre Ergebnisse nicht verwenden:

• Eine Abfrage mit search=* oder mit einer leeren Suchzeichenfolge (z. B. eine reine Filterabfrage) funktioniert nicht, da keine semantische Relevanz gemessen werden kann. Die Abfrage muss Begriffe oder Ausdrücke bereitstellen, die während der Verarbeitung bewertet werden können.

• Eine Abfrage, die in der vollständigen Lucene-Syntax (queryType=full) erstellt wurde, ist mit der semantischen Rangfolge (queryType=semantic) nicht kompatibel. Die vollständige Lucene-Syntax wird vom semantischen Modell nicht unterstützt.

• Eine Sortierung nach bestimmten Feldern (durch orderby-Klauseln) setzt Suchbewertungen und eine semantische Bewertung außer Kraft. Da die semantische Bewertung die Rangfolge bereitstellen soll, führt das Hinzufügen einer orderby-Klausel zu einem HTTP 400-Fehler, wenn Sie die semantische Rangfolge auf sortierte Ergebnisse anwenden.

Einrichten der Abfrage

Fügen Sie der Abfrageanforderung in diesem Schritt Parameter hinzu. Für eine erfolgreiche Ausführung muss Ihre Abfrage eine Volltextsuche sein (mit Übergabe einer Zeichenfolge unter Verwendung des Parameters search), und der Index muss Textfelder mit umfangreichen semantischen Inhalten sowie eine semantische Konfiguration enthalten.

Azure portal

Der Suchexplorer enthält Optionen für die semantische Rangfolge.

1. Melden Sie sich beim Azure-Portal an.

2. Öffnen Sie einen Suchindex, und wählen Sie Suchexplorer aus.

3. Wählen Sie Abfrageoptionen aus. Wenn Sie bereits eine semantische Konfiguration definiert haben, ist sie standardmäßig ausgewählt. Wenn Sie keine haben, erstellen Sie eine semantische Konfiguration für Ihren Index.

   

4. Geben Sie eine Abfrage ein, z. B. „historic hotel with good food“, und wählen Sie Suchen aus.

5. Alternativ können Sie JSON-Ansicht auswählen und Definitionen in den Abfrage-Editor einfügen:

   

   Das Folgende ist ein JSON-Text, den Sie in die Ansicht einfügen können:

    {
        "queryType": "semantic",
        "search": "historic hotel with good food",
        "semanticConfiguration": "my-semantic-config",
        "answers": "extractive|count-3",
        "captions": "extractive|highlight-true",
        "highlightPreTag": "<strong>",
        "highlightPostTag": "</strong>",
        "select": "HotelId,HotelName,Description,Category",
        "count": true
    }
   

REST-API

Verwenden Sie Dokumente durchsuchen, um die Anforderung zu formulieren.

Die Antwort enthält automatisch eine @search.rerankerScore. Wenn die Antwort Beschriftungen oder Antworten enthalten soll, fügen Sie der Anforderung Beschriftungen und Antworten hinzu.

Im folgenden Beispiel in diesem Abschnitt wird der Index hotels-sample-index verwendet, um die semantische Rangfolge mit semantischen Antworten und Beschriftungen zu veranschaulichen.

1. Fügen Sie die folgende Anforderung als Vorlage in einen Webclient ein. Ersetzen Sie den Dienstnamen und den Indexnamen durch gültige Werte.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2023-11-01      
   {
       "queryType": "semantic",
       "search": "newer hotel near the water with a great restaurant",
       "semanticConfiguration": "my-semantic-config",
       "answers": "extractive|count-3",
       "captions": "extractive|highlight-true",
       "highlightPreTag": "<strong>",
       "highlightPostTag": "</strong>",
       "select": "HotelId,HotelName,Description,Category",
       "count": true
   }
   

2. Legen Sie „queryType“ auf „semantic“ fest.

   In anderen Abfragen wird der queryType verwendet, um den Abfrageparser anzugeben. In der semantischen Rangfolge ist er auf „semantic“ festgelegt. Im Feld „search“ können Sie Abfragen angeben, die der einfachen Syntax entsprechen.

3. Legen Sie „search“ auf eine Volltextsuchabfrage basierend auf der einfachen Syntax fest. Die semantische Rangfolge stellt eine Erweiterung der Volltextsuche dar. Dieser Parameter ist zwar nicht erforderlich, aber wenn er NULL ist, erhalten Sie nicht das erwartete Ergebnis.

4. Legen Sie „semanticConfiguration“ auf eine vordefinierte semantische Konfiguration fest, die in Ihren Index eingebettet ist.

5. Geben Sie mit „answers“ an, ob semantische Antworten in das Ergebnis einbezogen werden sollen. Zurzeit ist extractive der einzige gültige Wert für diesen Parameter. Antworten können so konfiguriert werden, dass maximal zehn Ergebnisse zurückgegeben werden. Der Standardwert ist 1. Dieses Beispiel zeigt drei Antworten: extractive|count-3.

   Antworten sind nicht bei jeder Anforderung garantiert. Um eine Antwort zu erhalten, muss die Abfrage wie eine Frage aussehen, und der Inhalt muss Text enthalten, der wie eine Antwort aussieht.

6. Legen Sie „captions“ fest, um anzugeben, ob semantische Beschriftungen in das Ergebnis einbezogen werden sollen. Zurzeit ist extractive der einzige gültige Wert für diesen Parameter. Beschriftungen können so konfiguriert werden, dass Ergebnisse mit oder ohne Hervorhebungen zurückgegeben werden. Standardmäßig werden Hervorhebungen zurückgegeben. Im folgenden Beispiel werden Beschriftungen ohne Hervorhebungen zurückgegeben: extractive|highlight-false.

   Die Grundlage für Beschriftungen und Antworten sind die Felder, auf die in der semantischen Konfiguration verwiesen wird. Für diese Felder gilt ein kombinierter Grenzwert im Bereich von 2.000 Token oder ca. 20.000 Zeichen. Wenn Sie von einer Tokenanzahl ausgehen, die diesen Grenzwert übersteigt, empfiehlt sich ggf. ein Datenblockerstellungsschritt mithilfe des Textaufteilungsskills. Dieser Ansatz führt zu einer Abhängigkeit von einer KI-Anreicherungspipeline und von Indexern.

7. Legen Sie „highlightPreTag“ und „highlightPostTag“ fest, wenn Sie die standardmäßige Hervorhebungsformatierung außer Kraft setzen möchten, die auf Beschriftungen angewandt wird.

   Beschriftungen stellen eine Hervorhebung der Formatierung für Schlüsselpassagen im Dokument dar, die die Antwort zusammenfassen. Der Standardwert ist <em>. Wenn Sie den Formatierungstyp angeben möchten (beispielsweise gelber Hintergrund), können Sie „highlightPreTag“ und „highlightPostTag“ festlegen.

8. Legen Sie „select“ fest, um anzugeben, welche Felder in der Antwort zurückgegeben werden, und „count“, um die Anzahl der Übereinstimmungen im Index zurückzugeben. Diese Parameter verbessern die Qualität der Anforderung und die Lesbarkeit der Antwort.

9. Senden Sie die Anforderung, um die Abfrage auszuführen und Ergebnisse zurückzugeben.

.NET SDK

Verwenden Sie „QueryType“ oder „SemanticQuery“, um die semantische Rangfolge für eine semantische Abfrage aufzurufen. Das folgende Beispiel stammt vom Azure SDK-Team.

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");

Auswertung der Antwort

Nur die 50 besten Treffer aus den anfänglichen Ergebnissen können in eine semantische Rangfolge gebracht werden. Eine Antwort umfasst genau wie bei anderen Abfragen entweder alle als abrufbar markierten Felder oder nur Felder, die im Auswahlparameter aufgeführt sind. Eine Antwort enthält die ursprüngliche Relevanzbewertung und eventuell auch eine Anzahl oder Batchergebnisse, je nachdem, wie Sie die Anforderung formuliert haben.

Bei der semantischen Rangfolge enthält die Antwort mehr Elemente: eine neue Relevanzbewertung mit semantischer Rangfolge, eine optionale Beschriftung im Nur-Text-Format und mit Hervorhebungen sowie eine optionale Antwort. Wenn Ihre Ergebnisse diese zusätzlichen Elemente nicht enthalten, ist Ihre Abfrage möglicherweise falsch konfiguriert. Überprüfen Sie als ersten Schritt zur Problembehandlung die semantische Konfiguration, um sicherzustellen, dass sie sowohl in der Indexdefinition als auch in der Abfrage angegeben ist.

In einer Client-App können Sie die Suchseite so strukturieren, dass sie eine Beschriftung als Beschreibung der Übereinstimmung und nicht den gesamten Inhalt eines bestimmten Felds enthält. Dieser Ansatz ist hilfreich, wenn einzelne Felder für die Seite mit den Suchergebnissen zu umfangreich sind.

Die Antwort auf die oben stehende Beispielabfrage gibt den folgenden Treffer als beste Übereinstimmung zurück. Beschriftungen werden im Nur-Text-Format und mit Hervorhebungen zurückgegeben, da die captions-Eigenschaft festgelegt wurde. Antworten werden im Beispiel ausgelassen, da für diese Abfrage und den Korpus keine Antworten bestimmt werden konnten.

"@odata.count": 35,
"@search.answers": [],
"value": [
    {
        "@search.score": 1.8810667,
        "@search.rerankerScore": 1.1446577133610845,
        "@search.captions": [
            {
                "text": "Oceanside Resort. Luxury. New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
                "highlights": "<strong>Oceanside Resort.</strong> Luxury. New Luxury Hotel. Be the first to stay.<strong> Bay</strong> views from every room, location near the pier, rooftop pool, waterfront dining & more."
            }
        ],
        "HotelName": "Oceanside Resort",
        "Description": "New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
        "Category": "Luxury"
    },
  ...
]

Nächste Schritte

Die semantische Rangfolge kann in Hybridabfragen verwendet werden, die die Schlüsselwortsuche und die Vektorsuche in einer einzelnen Anforderung und einer einheitlichen Antwort kombinieren.

Hybridabfrage mit semantischer Rangfolge