Szybki start: uruchamianie zapytań w portalu Azure przy użyciu Eksploratora wyszukiwania

W tym przewodniku szybkiego startu dowiesz się, jak używać eksploratora Search, wbudowanego narzędzia zapytań w portalu Azure, do uruchamiania zapytań na indeks Wyszukiwanie AI platformy Azure. Użyj tego narzędzia, aby przetestować zapytanie lub wyrażenie filtru lub potwierdzić, czy zawartość istnieje w indeksie.

Ten szybki start używa istniejącego indeksu do zademonstrowania eksploratora wyszukiwania.

Wymagania wstępne

• Konto Azure z aktywną subskrypcją. Utwórz bezpłatne konto.

• Usługa Wyszukiwanie AI platformy Azure. Utwórz usługę lub znajdź istniejącą usługę w bieżącej subskrypcji. Dla tego szybkiego startu możesz użyć bezpłatnej usługi.

• W tym szybkim przewodniku wykorzystano indeks hotels-sample. Postępuj zgodnie z instrukcjami w tym Krótkim przewodniku, aby utworzyć indeks.

Uruchamianie Eksploratora wyszukiwania

1. Przejdź do usługi wyszukiwania w portalu Azure.

2. W okienku po lewej stronie wybierz pozycję Przegląd.

3. Na pasku poleceń wybierz pozycję Eksplorator wyszukiwania.

   

   Alternatywnie wybierz kartę Eksplorator wyszukiwania na stronie indeksu.

Wykonywanie zapytań na trzy sposoby

Istnieją trzy podejścia do wykonywania zapytań w Eksploratorze wyszukiwania:

• Widok zapytania zawiera domyślny pasek wyszukiwania. Akceptuje puste zapytanie lub zapytanie bez tekstu z wartościami logicznymi, takimi jak ocean view + parking.

• Widok obrazu zawiera okno do przeglądania lub przeciągania i upuszczania plików PNG, JPG lub JPEG. Jeśli indeks nie ma wektoryzatora obrazów i równoważnej umiejętności, ten widok jest niedostępny.

• Widok JSON obsługuje sparametryzowane zapytania. Filtry, kolejność, wybór, liczba, pola wyszukiwania i wszystkie inne parametry muszą być ustawione w widoku JSON.

  

Przykład: Zapytanie dotyczące obrazu

Eksplorator wyszukiwania akceptuje obrazy jako dane wejściowe zapytania za pomocą widoku obrazu, co wymaga użycia obsługiwanej pary umiejętności wektoryzatora. Aby uzyskać więcej informacji, zobacz Konfigurowanie wektoryzatora w indeksie wyszukiwania.

Indeks hotels-sample nie jest skonfigurowany do wektoryzacji obrazów. Jeśli chcesz uruchamiać zapytania dotyczące obrazów, utwórz indeks zgodnie z opisem w Quickstart: wyszukiwanie wektorów w portalu Azure. Przewodnik szybkiego startu wymaga danych przykładowych w formie tekstowej, więc musisz używać dokumentów zawierających obrazy.

Aby uruchomić zapytanie dotyczące obrazu, wybierz lub przeciągnij obraz do obszaru wyszukiwania, a następnie wybierz pozycję Wyszukaj. Eksplorator wyszukiwania wektoryzuje obraz i wysyła wektor do aparatu wyszukiwania na potrzeby wykonywania zapytań. Aparat wyszukiwania zwraca dokumenty, które są wystarczająco podobne do obrazu wejściowego, do określonej k liczby wyników.

Przykłady: zapytania JSON

Poniżej przedstawiono przykłady zapytań JSON, które można uruchomić przy użyciu Eksploratora wyszukiwania. Aby postępować zgodnie z tymi przykładami, przejdź do widoku JSON. Możesz wkleić każdy przykład JSON do obszaru tekstu.

Wskazówka

Widok JSON obsługuje funkcję IntelliSense na potrzeby uzupełniania nazw parametrów. Umieść kursor w widoku JSON i wprowadź znak spacji, aby wyświetlić listę wszystkich parametrów zapytania. Możesz również wprowadzić literę, na przykład s, aby wyświetlić tylko parametry zapytania rozpoczynające się od tej litery.

Funkcja IntelliSense nie wyklucza nieprawidłowych parametrów, więc użyj swojej najlepszej oceny.

Uruchamianie nieokreślonego zapytania

W Eksploratorze wyszukiwania żądania POST są formułowane wewnętrznie przy użyciu Documents - Search Post (REST API), a odpowiedzi są zwracane jako szczegółowe dokumenty JSON.

Aby zapoznać się z zawartością, wykonaj puste wyszukiwanie, wybierając pozycję Wyszukaj bez podanych terminów. Puste wyszukiwanie jest przydatne jako pierwsze zapytanie, ponieważ zwraca całe dokumenty, aby można było przejrzeć kompozycję dokumentu. W przypadku pustego wyszukiwania nie ma wyników wyszukiwania, a dokumenty są zwracane w dowolnej kolejności ("@search.score": 1 dla wszystkich dokumentów). Domyślnie 50 dokumentów jest zwracanych na żądanie wyszukiwania.

Dodaj "count": true, aby uzyskać liczbę dopasowań znalezionych w indeksie. Przy pustym wyszukiwaniu liczba jest całkowitą liczbą dokumentów w indeksie. W kwalifikowanym wyszukiwaniu jest to liczba dokumentów pasujących do danych wejściowych zapytania. Pamiętaj, że usługa zwraca domyślnie dopasowania top-50, więc liczba może wskazywać więcej dopasowań w indeksie niż zwracane w wynikach.

Równoważna składnia pustego wyszukiwania to * lub "search": "*".

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

Wyniki

Uruchamianie zapytania o dowolny tekst

Wyszukiwanie w dowolnej formie z operatorami lub bez operatorów jest przydatne do symulowania zapytań zdefiniowanych przez użytkownika wysyłanych z aplikacji niestandardowej do Wyszukiwanie AI platformy Azure. Tylko pola przypisywane jako możliwe do wyszukiwania w indeksie są skanowane pod kątem dopasowań.

Nie potrzebujesz widoku JSON dla zapytania bez tekstu, ale udostępniamy go w formacie JSON w celu zapewnienia spójności z innymi przykładami w tym artykule.

Zwróć uwagę, że po podaniu kryteriów wyszukiwania, takich jak terminy zapytania lub wyrażenia, ranga wyszukiwania wchodzi w grę. W poniższym przykładzie przedstawiono wyszukiwanie bezpłatnego tekstu. Ocena istotności to wynik obliczony dla dopasowania przy użyciu @search.score.

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

Wyniki

Możesz użyć Ctrl-F do wyszukiwania w wynikach pod kątem określonych terminów zainteresowania.

Ogranicz pola w wynikach wyszukiwania

Dodaj "select" , aby ograniczyć wyniki do jawnie nazwanych pól, aby uzyskać bardziej czytelne dane wyjściowe w Eksploratorze wyszukiwania. Tylko pola przypisane jako możliwe do pobrania w indeksie mogą być wyświetlane w wynikach.

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

Wyniki

Zwraca następną partię wyników

Wyszukiwanie AI platformy Azure zwraca pięćdziesiąt najlepszych dopasowań na podstawie kryteriów rankingowych wyszukiwania. Indeks hotels-sample zawiera tylko 50 hoteli, więc używamy mniejszej liczby do zilustrowania paginacji. Aby uzyskać następny zestaw pasujących dokumentów, dołącz "top": 20 i "skip": 10 zwiększ zestaw wyników do 20 dokumentów (wartość domyślna to 50, wartość maksymalna to 1000), pomijając pierwsze 10 dokumentów. Możesz sprawdzić klucz dokumentu (HotelId), aby zidentyfikować dokument.

Pamiętaj, że musisz podać kryteria wyszukiwania, takie jak termin zapytania lub wyrażenie, aby uzyskać sklasyfikowane wyniki. Z każdym kolejnym poziomem wyników wyszukiwania oceny jakości wyszukiwania maleją.

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

Wyniki

Wyrażenia filtru (większe niż, mniejsze niż, równe)

Użyj parametru , filter aby określić kryteria dołączania lub wykluczania. Pole musi być przypisywane jako możliwe do filtrowania w indeksie. W tym przykładzie wyszukiwane są oceny większe niż cztery:

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

Wyniki

Sortowanie wyników

Dodaj orderby do sortowania wyników według innego pola oprócz wyniku wyszukiwania. Pole musi być przypisywane jako sortowalne w indeksie. W sytuacjach, gdy filtrowana wartość jest identyczna (na przykład ta sama cena), zamówienie jest dowolne, ale można dodać więcej kryteriów do dokładniejszego sortowania. Oto przykładowe wyrażenie, którego można użyć do przetestowania tego elementu:

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

Wyniki

Wnioski

W tym przewodniku Szybki start użyto Eksploratora wyszukiwania do wykonywania zapytań dotyczących indeksu przy użyciu interfejsu API REST.

• Wyniki są zwracane jako pełne dokumenty JSON, dzięki czemu można wyświetlić konstrukcję i zawartość każdego dokumentu w całości. Parametr select w wyrażeniu zapytania ogranicza zwracane pola.

• Wyniki wyszukiwania składają się ze wszystkich pól oznaczonych jako możliwe do pobrania w indeksie. Wybierz kartę Pola , aby przejrzeć atrybuty.

• Wyszukiwanie słów kluczowych, podobnie jak to, co można wprowadzić w komercyjnej przeglądarce internetowej, jest przydatne do testowania środowiska użytkownika końcowego. Na przykład przy założeniu indeksu hotels-sample możesz wprowadzić wartość "activities 'outdoor pool' restaurant OR continental breakfast", a następnie użyć Ctrl-F, aby znaleźć słowa w wynikach wyszukiwania.

• Wyrażenia zapytań i filtrów są wyrażane w składni implementowanej przez Wyszukiwanie AI platformy Azure. Wartość domyślna to prosta składnia, ale opcjonalnie można używać pełnej Lucene w przypadku bardziej zaawansowanych zapytań. Wyrażenia filtru są wyrażane w składni OData.

Czyszczenie zasobów

Jeśli pracujesz we własnej subskrypcji, dobrym pomysłem jest zakończenie projektu przez usunięcie zasobów, których już nie potrzebujesz. Zasoby, które pozostają uruchomione, mogą kosztować pieniądze.

W portalu Azure wybierz pozycję Wszystkie zasoby lub Grupy zasobów w okienku po lewej stronie, aby znaleźć zasoby i zarządzać nimi. Zasoby można usunąć pojedynczo lub usunąć grupę zasobów, aby jednocześnie usunąć wszystkie zasoby.

Jeśli używasz bezpłatnej usługi wyszukiwania, pamiętaj, że masz ograniczenie do trzech indeksów, indeksatorów i źródeł danych. Możesz usunąć poszczególne elementy w portalu, aby pozostać w limicie.

Następny krok

Aby dowiedzieć się więcej na temat struktur zapytań i składni, użyj klienta REST do tworzenia wyrażeń zapytań korzystających z większej liczby części interfejsu API REST. Dokumenty - wyszukiwanie postów (REST API) jest szczególnie przydatne do nauki i eksploracji.

Szybki start: wyszukiwanie pełnotekstowe