Schnellstart: Verwenden des Such-Explorers zum Ausführen von Abfragen im Azure-Portal

In dieser Schnellstartanleitung erfahren Sie, wie Sie Search-Explorer, ein integriertes Abfragetool im Azure-Portal zum Ausführen von Abfragen für einen Azure KI-Suche Index verwenden. Verwenden Sie dieses Tool, um einen Abfrage- oder Filterausdruck zu testen oder zu überprüfen, ob Inhalt im Index vorhanden ist.

In dieser Schnellstartanleitung wird ein vorhandener Index verwendet, um den Such-Explorer zu veranschaulichen.

Voraussetzungen

Such-Explorer starten

  1. Wechseln Sie zum Suchdienst im Azure-Portal.

  2. Wählen Sie im linken Bereich die Option "Übersicht" aus.

  3. Wählen Sie auf der Befehlsleiste den Such-Explorer aus.

    Screenshot des Befehls

    Alternativ können Sie auf der Indexseite die Registerkarte "Such-Explorer " auswählen.

Drei Abfragemethoden

Es gibt drei Ansätze zum Abfragen im Such-Explorer:

  • Die Abfrageansicht stellt eine Standardmäßige Suchleiste bereit. Sie akzeptiert eine leere Abfrage oder eine Freitextabfrage mit Booleans, zum Beispiel ocean view + parking.

  • Die Bildansicht bietet ein Fenster zum Durchsuchen oder Ablegen von PNG-, JPG- oder JPEG-Dateien. Sofern Ihr Index nicht über einen Bildvektorizer und eine entsprechende Fähigkeit verfügt, ist diese Ansicht nicht verfügbar.

  • Die JSON-Ansicht unterstützt parametrisierte Abfragen. Filter, Reihenfolge, Auswahl, Anzahl, SearchFields und alle anderen Parameter müssen in der JSON-Ansicht festgelegt werden.

    Screenshot der drei Ansichten zum Abfragen im Such-Explorer.

Beispiel: Bildabfrage

Der Such-Explorer akzeptiert Bilder als Abfrageeingaben über die Bildansicht, was erfordert, dass Sie ein unterstütztes Vektorisierer-Fähigkeitspaar verwenden. Weitere Informationen finden Sie unter Konfigurieren eines Vektorizers in einem Suchindex.

Der Hotels-Beispielindex ist nicht für die Bildvektorisierung konfiguriert. Wenn Sie Bildabfragen ausführen möchten, erstellen Sie einen Index wie in Quickstart: Vektorsuche im Azure Portal beschrieben. Die Schnellstartanleitung basiert auf textbasierten Beispieldaten, daher müssen Sie Dokumente verwenden, die Bilder enthalten.

Wenn Sie eine Bildabfrage ausführen möchten, wählen Sie ein Bild aus, oder ziehen Sie es in den Suchbereich, und wählen Sie dann "Suchen" aus. Der Such-Explorer vektorisiert das Bild und sendet den Vektor zur Abfrageausführung an die Suchmaschine. Die Suchmaschine gibt Dokumente zurück, die dem Eingabebild ausreichend ähnlich sind, bis zur angegebenen k Anzahl von Ergebnissen.

Screenshot der Suchergebnisse für die Bildsuche.

Beispiele: JSON-Abfragen

Im Folgenden finden Sie Beispiele für JSON-Abfragen, die Sie mit dem Such-Explorer ausführen können. Um diesen Beispielen zu folgen, wechseln Sie zur JSON-Ansicht. Sie können jedes JSON-Beispiel in den Textbereich einfügen.

Tipp

Die JSON-Ansicht unterstützt IntelliSense, um Parameternamen automatisch zu vervollständigen. Platzieren Sie den Cursor in der JSON-Ansicht, und geben Sie ein Leerzeichen ein, um eine Liste aller Abfrageparameter anzuzeigen. Sie können auch einen Buchstaben wie s eingeben, um nur die Abfrageparameter anzuzeigen, die mit diesem Buchstaben beginnen.

IntelliSense schließt ungültige Parameter nicht aus, verwenden Sie daher Ihr bestes Urteil.

Ausführen einer nicht angegebenen Abfrage

Im Such-Explorer werden POST-Anforderungen intern mithilfe der Documents - Search Post (REST-API) formuliert, wobei Antworten als detaillierte JSON-Dokumente zurückgegeben werden.

Führen Sie für einen ersten Blick auf Inhalte eine leere Suche aus, indem Sie "Suchen " ohne bereitgestellte Begriffe auswählen. Eine leere Suche ist als erste Abfrage nützlich, da sie ganze Dokumente zurückgibt, damit Sie die Dokumentkomposition überprüfen können. Bei einer leeren Suche gibt es keine Suchbewertung, und Dokumente werden in beliebiger Reihenfolge ("@search.score": 1 für alle Dokumente) zurückgegeben. Standardmäßig werden 50 Dokumente pro Suchanforderung zurückgegeben.

Fügen Sie "count": true hinzu, um die Anzahl der in einem Index gefundenen Übereinstimmungen abzurufen. Bei einer leeren Suche ist die Anzahl die Gesamtzahl der Dokumente im Index. Bei einer qualifizierten Suche ist es die Anzahl der Dokumente, die der Abfrageeingabe entsprechen. Denken Sie daran, dass der Dienst standardmäßig die höchsten 50 Übereinstimmungen zurückgibt, sodass die Anzahl möglicherweise mehr Übereinstimmungen im Index angibt, als in den Ergebnissen zurückgegeben wird.

Entsprechende Syntax für eine leere Suche ist * oder "search": "*".

{
   "search": "*",
   "count": true
}

Ergebnisse

Screenshot eines Zählbeispiels.

Ausführen einer Freitextabfrage

Die Freiformsuche mit oder ohne Operatoren ist nützlich, um benutzerdefinierte Abfragen zu simulieren, die von einer benutzerdefinierten App an Azure KI-Suche gesendet werden. Nur Felder, die im Index als durchsuchbar gekennzeichnet sind, werden auf Treffer durchsucht.

Sie benötigen die JSON-Ansicht nicht für eine Freitextabfrage, aber wir stellen sie in JSON für Konsistenz mit anderen Beispielen in diesem Artikel bereit.

Beachten Sie, dass der Suchrang eine Rolle spielt, wenn Sie Suchkriterien wie Abfragebegriffe oder Ausdrücke bereitstellen. Im folgenden Beispiel wird eine Freitextsuche veranschaulicht. Der @search.score ist ein Relevanzscore, der für den Match unter Verwendung des Standardbewertungsalgorithmus berechnet wurde.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Ergebnisse

Sie können Ctrl-F verwenden, um innerhalb der Ergebnisse nach bestimmten Interessenbedingungen zu suchen.

Screenshot eines Beispiels für eine Freitextabfrage.

Einschränken von Feldern in Suchergebnissen

Fügen Sie "select" hinzu, um Die Ergebnisse auf die explizit benannten Felder für eine besser lesbare Ausgabe im Such-Explorer zu beschränken. Nur Felder, die im Index als abrufbar zugeschrieben werden können, können in Ergebnissen angezeigt werden.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Ergebnisse

Screenshot des Beispiels zum Einschränken von Feldern in Suchergebnissen.

Nächste Ergebnismenge liefern

Azure KI-Suche die top-50 Übereinstimmungen basierend auf dem Suchrang zurückgibt. Der Hotels-Beispielindex hat nur 50 Hotels, daher nutzen wir eine kleinere Zahl, um die Seitennummerierung darzustellen. Um den nächsten Satz übereinstimmender Dokumente abzurufen, hängen Sie "top": 20 und "skip": 10 an, um das Resultset auf 20 Dokumente zu erweitern (der Standardwert ist 50, maximal 1000), und überspringen Sie die ersten 10 Dokumente. Sie können den Dokumentschlüssel (HotelId) überprüfen, um ein Dokument zu identifizieren.

Denken Sie daran, dass Sie Suchkriterien bereitstellen müssen, z. B. einen Abfragebegriff oder -ausdruck, um bewertete Ergebnisse zu erhalten. Suchbewertungen verringern sich, je tiefer Sie in die Suchergebnisse eintauchen.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Ergebnisse

Screenshot des Beispiels zum Zurückgeben des nächsten Batches von Suchergebnissen.

Filterausdrücke (größer als, kleiner als, gleich)

Verwenden Sie den filter Parameter, um Einschluss- oder Ausschlusskriterien anzugeben. Das Feld muss im Index als filterbar markiert werden. In diesem Beispiel wird nach Bewertungen gesucht, die größer als vier sind:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Ergebnisse

Screenshot eines Filterbeispiels.

Sortieren von Ergebnissen

Fügen Sie orderby hinzu, um Ergebnisse nach einem anderen Feld neben der Suchbewertung zu sortieren. Das Feld muss im Index als sortierbar angegeben werden. In Situationen, in denen der gefilterte Wert identisch ist (z. B. der gleiche Preis), ist die Reihenfolge beliebig, Sie können aber weitere Kriterien für eine tiefere Sortierung hinzufügen. Hier ist ein Beispielausdruck, den Sie zum Testen verwenden können:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Ergebnisse

Screenshot eines Sortierbeispiels.

Erkenntnisse

In dieser Schnellstartanleitung haben Sie den Such-Explorer zum Abfragen eines Indexes mithilfe der REST-API verwendet.

  • Ergebnisse werden als ausführliche JSON-Dokumente zurückgegeben, sodass Sie die Konstruktion und den Inhalt jedes Dokuments vollständig anzeigen können. Der select Parameter in einem Abfrageausdruck beschränkt, welche Felder zurückgegeben werden.

  • Suchergebnisse bestehen aus allen Feldern, die im Index als abrufbar gekennzeichnet sind. Wählen Sie die Registerkarte "Felder " aus, um Attribute zu überprüfen.

  • Die Stichwortsuche ist ähnlich wie die Eingabe in einem kommerziellen Webbrowser hilfreich, um eine Endbenutzererfahrung zu testen. Zum Beispiel, wenn Sie den Hotels-Beispielindex annehmen, können Sie "activities 'outdoor pool' restaurant OR continental breakfast" eingeben und dann Ctrl-F verwenden, um Begriffe in den Suchergebnissen zu finden.

  • Abfrage- und Filterausdrücke werden in einer von Azure KI-Suche implementierten Syntax formuliert. Der Standardwert ist eine einfache Syntax, Sie können aber optional vollständige Lucene für leistungsfähigere Abfragen verwenden. Filterausdrücke werden in einer OData-Syntax formuliert.

Bereinigen von Ressourcen

Wenn Sie in Ihrem eigenen Abonnement arbeiten, ist es ratsam, ein Projekt abzuschließen, indem Sie die nicht mehr benötigten Ressourcen entfernen. Ressourcen, die weiterlaufen, können Ihnen Geld kosten.

Wählen Sie im Azure Portal All resources or Resource groups aus dem linken Bereich aus, um Ressourcen zu suchen und zu verwalten. Sie können Ressourcen einzeln löschen oder die Ressourcengruppe löschen, um alle Ressourcen gleichzeitig zu entfernen.

Wenn Sie einen kostenlosen Suchdienst verwenden, denken Sie daran, dass Sie auf drei Indizes, Indexer und Datenquellen beschränkt sind. Sie können einzelne Elemente im Portal löschen, um unter dem Grenzwert zu bleiben.

Nächster Schritt

Wenn Sie mehr über Abfragestrukturen und -syntax erfahren möchten, verwenden Sie einen REST-Client, um Abfrageausdrücke zu erstellen, die weitere Teile der REST-API verwenden. Documents – Search Post (REST-API) ist besonders hilfreich beim Lernen und Erforschen.

Schnellstart: Volltextsuche

  • Last updated on