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

W tym szybkim wprowadzeniu dowiesz się, jak używać Eksploratora wyszukiwania, wbudowanego narzędzia do zapytań w portalu Azure do uruchamiania zapytań względem indeksu Azure AI Search. Użyj tego narzędzia, aby przetestować zapytanie lub wyrażenie filtru lub potwierdzić, czy zawartość istnieje w indeksie.

Ten przewodnik Szybki start używa istniejącego indeksu do zademonstrowania Eksploratora wyszukiwania.

Wymagania wstępne

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

• Usługa wyszukiwania sztucznej inteligencji platformy Azure. Utwórz usługę lub znajdź istniejącą usługę w bieżącej subskrypcji. Możesz skorzystać z bezpłatnej usługi w ramach szybkiego startu.

• W tym szybkim starcie używany jest indeks "hotels-sample." Postępuj zgodnie z instrukcjami w tym przewodniku Szybki start , aby utworzyć indeks.

Uruchamianie Eksploratora wyszukiwania

1. Zaloguj się do witryny Azure Portal i wybierz usługę wyszukiwania.

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 przewodniku Szybki start: wyszukiwanie wektorów w witrynie Azure Portal. Instrukcja szybkiego startu korzysta z przykładowych danych tekstowych, 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.

Uruchamianie nieokreślonego zapytania

W Eksploratorze wyszukiwania żądania POST są formułowane wewnętrznie przy użyciu Documents - Search Post (REST API), z odpowiedziami zwracanymi 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. Gdy wyszukiwanie jest puste, 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, jest przydatne do symulacji zapytań tworzonych przez użytkownika i wysyłanych z aplikacji niestandardowej do usługi Azure AI Search. 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. Wartość @search.score to ocena istotności obliczona dla dopasowania przy użyciu domyślnego algorytmu punktacji.

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

Wyniki

Możesz użyć Ctrl-F, aby wyszukać w wynikach określone terminy 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

Usługa Azure AI Search zwraca 50 najlepszych dopasowań w oparciu o rangę wyszukiwania. Indeks hotels-sample zawiera tylko 50 hoteli, więc używamy mniejszej liczby, aby zilustrować stronicowanie. 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. Oceny wyszukiwania zmniejszają się, im głębiej zaglądasz do wyników wyszukiwania.

{
   "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 odnalezienia 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źć frazy w wynikach wyszukiwania.

• Wyrażenia zapytań i filtrów są wyrażane w składni implementowanej przez usługę Azure AI Search. 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

Gdy pracujesz we własnej subskrypcji, dobrym pomysłem na końcu projektu jest określenie, czy nadal potrzebujesz utworzonych zasobów. Uruchomione zasoby mogą generować koszty. Zasoby możesz usuwać pojedynczo lub jako grupę zasobów, usuwając cały zestaw zasobów.

W witrynie Azure Portal możesz znaleźć zasoby i zarządzać nimi, wybierając pozycję Wszystkie zasoby lub Grupy zasobów w okienku po lewej stronie.

Pamiętaj, że bezpłatna usługa wyszukiwania jest ograniczona do trzech indeksów, trzech indeksatorów i trzech źródeł danych. Aby zachować limit, możesz usunąć te elementy indywidualnie w portalu Azure.

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 (interfejs API REST) jest szczególnie przydatne w przypadku nauki i eksploracji.