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

Note

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

Z tego przewodnika Szybki start dowiesz się, jak używać eksploratora Search wbudowanego narzędzia zapytań w portalu Azure do uruchamiania zapytań względem indeksu Wyszukiwanie AI platformy Azure. Użyj tego narzędzia, aby przetestować zapytanie lub wyrażenie filtru lub potwierdzić, czy zawartość istnieje w indeksie.

Ten przewodnik w ramach szybkiego startu wykorzystuje istniejący indeks, aby zademonstrować Eksplorator 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. W tym przewodniku Szybki start możesz skorzystać z bezpłatnej usługi.

• Ten szybki start korzysta z indeksu hotels-sample. Postępuj zgodnie z instrukcjami w tym samouczku szybkiego startu, 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 do zapytań za pomocą widoku obrazu, co wymaga użycia obsługiwanej pary wektoryzator-algorytm. 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. Szybki start opiera się na 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.

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, dlatego użyj własnego osądu.

Uruchamianie nieokreślonego zapytania

W Eksploratorze wyszukiwania żądania POST są tworzone wewnętrznie przy użyciu Documents - Search Post (REST API), a odpowiedzi zwracane są 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 otrzymać 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 domyślnie zwraca 50 najlepszych dopasowań, więc liczba może wskazywać na więcej dopasowań w indeksie niż zwracanych 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 @search.score jest obliczana dla dopasowania używając domyślnego algorytmu oceny.

{
    "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 50 pierwszych dopasowań na podstawie rangi wyszukiwania. Indeks hotels-sample zawiera tylko 50 hoteli, więc używamy mniejszej wartości liczbowej, aby zobrazować 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. Wyniki ocen wyszukiwania zmniejszają się w miarę zagłębiania się w wyniki wyszukiwania.

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

Wyniki

Wyrażenia filtrowania (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 szybkiego startu 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 obejmują wszystkie pola przypisane jako 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, zakładając użycie indeksu hotels-sample, możesz wprowadzić "activities 'outdoor pool' restaurant OR continental breakfast", a następnie użyć Ctrl-F, aby znaleźć terminy 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 można opcjonalnie używać pełnej Lucene do 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ą generować koszty.

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 (API REST) jest szczególnie przydatne do uczenia się i eksploracji.

Szybki start: wyszukiwanie pełnotekstowe