Hinzufügen der semantischen Rangfolge zu Abfragen in Azure KI-Suche

Sie können die semantische Rangfolge auf Textabfragen, Hybridabfragen und Vektorabfragen anwenden, wenn Ihre Suchdokumente Zeichenfolgenfelder enthalten und die Vektorabfrage eine Textdarstellung im Suchdokument aufweist.

In diesem Artikel wird erläutert, wie Der semantische Rangfolger für Abfragen aufgerufen wird. Es wird davon ausgegangen, dass Sie die neuesten stabilen oder Vorschau-APIs verwenden. Hilfe zu älteren Versionen finden Sie unter Migrieren von Semantikbewertungscode.

Voraussetzungen

Hinweis

Beschriftungen und Antworten werden aus Text im Suchdokument extrahiert. Das semantische Subsystem verwendet maschinelles Leseverständnis, um Inhalte zu erkennen, die die Merkmale einer Beschriftung oder Antwort aufweisen, aber keine neuen Sätze oder Ausdrücke verfassen, außer im Falle einer Abfrageumschreibung. Aus diesem Grund funktionieren Inhalte, die Erklärungen oder Definitionen enthalten, am besten für die semantische Rangfolge. Wenn Sie Chat-Stil-Interaktion mit generierten Antworten wünschen, siehe Agentic-Abruf oder Abruf augmented Generation (RAG).

Auswählen eines Clients

Sie können eines der folgenden Tools und SDKs verwenden, um eine Abfrage zu erstellen, die die semantische Rangfolge verwendet:

Vermeiden von Features, die die Relevanzbewertung umgehen

Einige Abfragefunktionen umgehen die Relevanzbewertung, wodurch sie nicht mit der semantischen Rangfolge kompatibel sind. Wenn Ihre Abfragelogik die folgenden Features enthält, können Sie Ihre Ergebnisse nicht semantisch bewerten:

  • Eine Abfrage mit search=* oder eine leere Suchzeichenfolge, wie eine reine Filterabfrage, funktioniert nicht, da es keine Grundlage gibt, die semantische Relevanz zu messen, und daher die Suchbewertungen null sind. Die Abfrage muss Begriffe oder Ausdrücke bereitstellen, die während der Verarbeitung ausgewertet werden können und die zu Suchdokumenten führen, die nach Relevanz bewertet werden. Bewertete Ergebnisse sind Eingaben für den semantischen Rangierer.

  • Das Sortieren (orderBy-Klauseln) für bestimmte Felder überschreibt die Suchpunktzahlen und einen semantischen Score. Da die Semantikbewertung 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

Standardmäßig verwenden Abfragen keine semantische Rangfolge. Um die semantische Rangfolge zu verwenden, können zwei verschiedene Parameter verwendet werden. Jeder Parameter unterstützt einen anderen Satz von Abfrageformaten.

Alle semantischen Abfragen, unabhängig davon, ob sie durch search plus queryType oder durch semanticQuery angegeben werden, müssen reiner Text sein und dürfen nicht leer sein. Wie Sie aus der folgenden Tabelle sehen können, unterstützt der queryType-semantic Parameter eine Teilmenge von Abfrageformaten.

Parameter Nur-Text-Suche Syntax für einfache Textsuche Syntax der Volltextsuche Vektorsuche Hybridsuche Semantische Antworten und Beschriftungen
queryType-semantic 1 ✅ ❌ ❌ ❌ ✅ ✅
semanticQuery="<your plain text query>" 2 ✅ ✅ ✅ ✅ ✅ ✅

1queryType=semantic kann explizite simple oder full Werte nicht unterstützen, da der queryType-Parameter semantic verwendet wird. Das effektive Abfrageverhalten ist die Standardeinstellung des einfachen Parsers.

2 Der semanticQuery Parameter kann für alle Abfragetypen verwendet werden. Es wird jedoch nicht im Azure Portal Search Explorer unterstützt.

Unabhängig vom ausgewählten Parameter sollte der Index Textfelder mit umfangreichen semantischen Inhalten und einer semantischen Konfiguration enthalten.

Der Such-Explorer enthält Optionen für die semantische Rangfolge. Denken Sie daran, dass Sie den Parameter semanticQuery im Azure-Portal nicht festlegen können.

  1. Wechseln Sie zum Suchdienst im Azure-Portal.

  2. Öffnen Sie einen Suchindex, und wählen Sie den Such-Explorer 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.

    Screenshot mit Abfrageoptionen im Such-Explorer.

  4. Geben Sie eine Abfrage ein, z. B. "Historisches Hotel mit gutem Essen", und wählen Sie "Suchen" aus.

  5. Alternativ können Sie die JSON-Ansicht auswählen und Definitionen in den Abfrage-Editor einfügen. Das Azure-Portal unterstützt die Verwendung von semanticQuery nicht. Das Festlegen queryType auf "semantic" ist erforderlich:

    Screenshot mit JSON-Abfragesyntax im Azure portal.

    JSON-Beispiel zum Festlegen des Abfragetyps auf semantisch, den Sie in die Ansicht einfügen können.

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

Auswerten der Antwort

Nur die 50 besten Treffer aus den anfänglichen Ergebnissen können in eine semantische Rangfolge gebracht werden. Wie bei allen Abfragen besteht eine Antwort aus allen Feldern, die als abrufbar gekennzeichnet sind, oder nur aus den im select Parameter aufgeführten Feldern. Eine Antwort enthält die ursprüngliche Relevanzbewertung und kann auch eine Anzahl oder Batchergebnisse enthalten, je nachdem, wie Sie die Anforderung formuliert haben.

In der semantischen Rangfolge verfügt die Antwort über weitere Elemente: eine neue semantisch bewertete Relevanzbewertung, eine optionale Beschriftung in Nur-Text und mit Hervorhebungen und einer optionalen Antwort. Wenn Ihre Ergebnisse diese zusätzlichen Elemente nicht enthalten, ist die 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 anstelle des gesamten Inhalts eines bestimmten Felds enthält. Dieser Ansatz ist nützlich, wenn einzelne Felder für die Suchergebnisseite zu umfangreich sind.

Die Antwort für die oben genannte Beispielabfrage ("interessantes Hotel mit Restaurant vor Ort und gemütliche Lobby oder freigegebener Bereich") gibt drei Antworten ("answers": "extractive|count-e"). Untertitel werden zurückgegeben, da die Eigenschaft "captions" gesetzt ist, sowohl in Klartext- als auch in hervorgehobenen Versionen. Wenn eine Antwort nicht bestimmt werden kann, wird sie von der Antwort weggelassen. Aus Platzgründen zeigt dieses Beispiel nur die drei Antworten und die drei höchsten Bewertungsergebnisse aus der Abfrage.

{
  "@odata.count": 29,
  "@search.answers": [
    {
      "key": "24",
      "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "score": 0.9340000152587891
    },
    {
      "key": "40",
      "text": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport.",
      "highlights": "Only 8 miles from Downtown. <strong>On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, </strong>All non-smoking<strong> hotel.</strong> Only 15 miles from airport.",
      "score": 0.9210000038146973
    },
    {
      "key": "38",
      "text": "Nature is Home on the beach. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "highlights": "Nature is Home on the beach. Explore the shore by day, and then come home to our<strong> shared living space </strong>to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "score": 0.9200000166893005
    }
  ],
  "value": [
    {
      "@search.score": 3.2328331,
      "@search.rerankerScore": 2.575303316116333,
      "@search.captions": [
        {
          "text": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
          "highlights": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our<strong> penthouse </strong>suites offer views for miles and the rooftop<strong> plaza </strong>is open to all guests from sunset to 10 p.m. Enjoy a<strong> complimentary continental breakfast in the lobby, </strong>and free Wi-Fi<strong> throughout </strong>the hotel."
        }
      ],
      "HotelId": "50",
      "HotelName": "Head Wind Resort",
      "Description": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
      "Category": "Suite"
    },
    {
      "@search.score": 0.632956,
      "@search.rerankerScore": 2.5425150394439697,
      "@search.captions": [
        {
          "text": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
          "highlights": "Every stay starts with a warm cookie. Amenities like the<strong> Counting Sheep sleep experience, </strong>our<strong> Wake-up glorious breakfast buffet and spacious workout facilities </strong>await."
        }
      ],
      "HotelId": "34",
      "HotelName": "Lakefront Captain Inn",
      "Description": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
      "Category": "Budget"
    },
    {
      "@search.score": 3.7076726,
      "@search.rerankerScore": 2.4554927349090576,
      "@search.captions": [
        {
          "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
          "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance."
        }
      ],
      "HotelId": "24",
      "HotelName": "Uptown Chic Hotel",
      "Description": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "Category": "Suite"
    },
   . . .
  ]
}

Erwartete Arbeitslasten

Für die semantische Rangfolge sollten Sie davon ausgehen, dass ein Suchdienst bis zu 10 gleichzeitige Abfragen pro Replikat unterstützt.

Der Dienst drosselt semantische Ranking-Anfragen, wenn das Datenvolumen zu hoch ist. Eine Fehlermeldung, die diese Ausdrücke enthält, deutet darauf hin, dass der Dienst seine Kapazität für das semantische Ranking erreicht hat.

Error in search query: Operation returned an invalid status 'Partial Content'`
@search.semanticPartialResponseReason`
CapacityOverloaded

Wenn Sie konsistente Durchsatzanforderungen nahe, bei oder höher als diese Ebene erwarten, erstellen Sie bitte ein Supportticket, damit wir für Ihren Workload ermöglichen können.

Nächste Schritte

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

Hybridabfrage mit semantischer Rangfolge

  • Last updated on