Udostępnij za pośrednictwem


Szybki start: tworzenie aplikacji demonstracyjnej w witrynie Azure Portal

W tym przewodniku Szybki start usługi Azure AI Search użyjesz kreatora tworzenie aplikacji demonstracyjnej witryny Azure Portal, aby wygenerować aplikację internetową w stylu "localhost", która będzie uruchamiana w przeglądarce. W zależności od konfiguracji wygenerowana aplikacja działa przy pierwszym użyciu z połączeniem tylko do odczytu na żywo z indeksem w usłudze wyszukiwania. Aplikacja domyślna może zawierać pasek wyszukiwania, obszar wyników, filtry paska bocznego i obsługę typów.

Aplikacja demonstracyjna może pomóc w wizualizacji sposobu działania indeksu w aplikacji klienckiej, ale nie jest przeznaczona dla scenariuszy produkcyjnych. Aplikacje produkcyjne powinny obejmować zabezpieczenia, obsługę błędów i logikę hostingu, która nie zapewnia aplikacji demonstracyjnej.

Wymagania wstępne

Przed rozpoczęciem należy spełnić następujące 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 ramach bieżącej subskrypcji. W tym przewodniku Szybki start możesz skorzystać z bezpłatnej usługi.

  • Microsoft Edge (najnowsza wersja) lub Google Chrome.

  • Indeks wyszukiwania używany jako podstawa wygenerowanej aplikacji.

    Ten przewodnik Szybki start używa wbudowanych danych przykładowych i indeksu nieruchomości, ponieważ zawiera on obrazy miniatur (kreator obsługuje dodawanie obrazów do strony wyników). Aby utworzyć indeks używany w tym ćwiczeniu, uruchom Kreatora importu danych , wybierając źródło danych realestate-us-sample .

    strona źródła danych dla przykładowych danych

Gdy indeks jest gotowy do użycia, przejdź do następnego kroku.

Uruchamianie kreatora

  1. Zaloguj się w witrynie Azure Portal przy użyciu danych konta Azure.

  2. Znajdź usługę wyszukiwania i na stronie Przegląd z linków na środku strony wybierz pozycję Indeksy.

  3. Wybierz pozycję realestate-us-sample-index z listy istniejących indeksów.

  4. Na stronie indeksu u góry wybierz pozycję Utwórz aplikację demonstracyjną, aby uruchomić kreatora.

  5. Na pierwszej stronie kreatora wybierz pozycję Włącz współużytkowanie zasobów między źródłami (CORS), aby dodać obsługę mechanizmu CORS do definicji indeksu. Ten krok jest opcjonalny, ale lokalna aplikacja internetowa nie będzie łączyć się z indeksem zdalnym bez niego.

Konfigurowanie wyników wyszukiwania

Kreator udostępnia podstawowy układ renderowanych wyników wyszukiwania, który zawiera miejsce na obraz miniatury, tytuł i opis. Tworzenie kopii zapasowych każdego z tych elementów jest polem w indeksie, które dostarcza dane.

  1. W obszarze Miniatura wybierz pole miniatury w indeksie realestate-us-sample . Ten przykład obejmuje miniatury obrazów w postaci obrazów adresowanych przez adres URL przechowywanych w polu nazywanym miniaturą. Jeśli indeks nie ma obrazów, pozostaw to pole puste.

  2. W polu Tytuł wybierz pole, które przekazuje unikatowość każdego dokumentu. W tym przykładzie identyfikator listy jest rozsądnym wyborem.

  3. W polu Opis wybierz pole zawierające szczegółowe informacje, które mogą pomóc komuś zdecydować, czy kliknąć do tego konkretnego dokumentu.

    konfigurowanie wyników dla przykładowych danych

Dodawanie paska bocznego

Usługa wyszukiwania obsługuje nawigację aspektową, która jest często renderowana jako pasek boczny. Aspekty są oparte na polach możliwych do filtrowania i tworzenia aspektów, jak wyrażono w schemacie indeksu.

W usłudze Azure AI Search nawigacja aspektowa to skumulowane środowisko filtrowania. W kategorii wybranie wielu filtrów powoduje rozwinięcie wyników (na przykład wybranie seattle i Bellevue w obrębie miasta). W różnych kategoriach wybranie wielu filtrów powoduje zawężenie wyników.

Napiwek

Pełny schemat indeksu można wyświetlić w portalu. Wyszukaj link Definicja indeksu (JSON) na stronie przeglądu każdego indeksu. Pola kwalifikujące się do nawigacji aspektowej mają atrybuty "filterable: true" i "facetable: true".

  1. W kreatorze wybierz kartę Pasek boczny w górnej części strony. W indeksie zostanie wyświetlona lista wszystkich pól, które są przypisywane jako możliwe do filtrowania i tworzenia aspektów.

  2. Zaakceptuj bieżący wybór pól aspektowych i przejdź do następnej strony.

Dodawanie głowicy typowej

Funkcje typeahead są dostępne w postaci autouzupełniania i sugestii dotyczących zapytań. Kreator obsługuje sugestie dotyczące zapytań. Na podstawie danych wejściowych naciśnięcia dostarczonych przez użytkownika usługa wyszukiwania zwraca listę "ukończonych" ciągów zapytania, które można wybrać jako dane wejściowe.

Sugestie są włączone dla określonych definicji pól. Kreator udostępnia opcje konfigurowania ilości informacji zawartych w sugestii.

Poniższy zrzut ekranu przedstawia opcje w kreatorze, w połączeniu ze stroną renderowaną w aplikacji. Możesz zobaczyć, jak są używane opcje pól i jak "Pokaż nazwę pola" jest używana do dołączania lub wykluczania etykiet w sugestii.

Konfiguracja sugestii dotyczących zapytań

Dodawanie sugestii

Sugestie odnoszą się do automatycznych monitów dotyczących zapytań dołączonych do pola wyszukiwania. Usługa Azure AI Search obsługuje dwa: autouzupełnianie częściowo wprowadzonego terminu wyszukiwania oraz sugestie dotyczące listy rozwijanej potencjalnych pasujących dokumentów.

Kreator obsługuje sugestie, a pola, które mogą udostępniać sugerowane wyniki, pochodzą z Suggesters konstrukcji w indeksie:

  "suggesters": [
    {
      "name": "sg",
      "searchMode": "analyzingInfixMatching",
      "sourceFields": [
        "number",
        "street",
        "city",
        "region",
        "postCode",
        "tags"
      ]
    }
  ]
  1. W kreatorze wybierz kartę Sugestie w górnej części strony. Zobaczysz listę wszystkich pól wyznaczonych w schemacie indeksu jako dostawców sugestii.

  2. Zaakceptuj bieżące zaznaczenie i przejdź do następnej strony.

Tworzenie, pobieranie i wykonywanie

  1. Wybierz pozycję Utwórz aplikację demonstracyjną w dolnej części strony, aby wygenerować plik HTML.

  2. Po wyświetleniu monitu wybierz pozycję Pobierz aplikację , aby pobrać plik.

  3. Otwórz plik i wybierz przycisk Wyszukaj . Ta akcja wykonuje zapytanie, które może być pustym zapytaniem (*), które zwraca dowolny zestaw wyników. Strona powinna wyglądać podobnie do poniższego zrzutu ekranu. Wprowadź termin i użyj filtrów, aby zawęzić wyniki.

Indeks bazowy składa się z fikcyjnych, wygenerowanych danych, które zostały zduplikowane w dokumentach, a opisy czasami nie są zgodne z obrazem. Podczas tworzenia aplikacji na podstawie własnych indeksów można oczekiwać bardziej spójnego środowiska.

Uruchom aplikację

Czyszczenie zasobów

Jeśli pracujesz w ramach własnej subskrypcji, dobrym pomysłem po zakończeniu projektu jest sprawdzenie, czy dalej 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.

Zasoby można znaleźć w portalu i zarządzać nimi, korzystając z linku Wszystkie zasoby lub Grupy zasobów w okienku nawigacji po lewej stronie.

Pamiętaj, że bezpłatna usługa jest ograniczona do trzech indeksów, indeksatorów i źródeł danych. Możesz usunąć poszczególne elementy w portalu, aby pozostać w limicie.

Następne kroki

Aplikacja demonstracyjna jest przydatna do tworzenia prototypów, ponieważ można symulować środowisko użytkownika końcowego bez konieczności pisania kodu JavaScript lub frontonu, ale zbliżając się do weryfikacji koncepcji we własnym projekcie, zapoznaj się z jednym z przykładów kodu kompleksowego, który jest bliżej facsimile aplikacji real-word: