1 — Omówienie dodawania wyszukiwania do witryny internetowej przy użyciu języka Python
W tym samouczku utworzysz witrynę internetową, aby przeszukać katalog książek, a następnie wdrożyć witrynę internetową w statycznej aplikacji internetowej platformy Azure.
Co robi przykład?
Ta przykładowa witryna internetowa zapewnia dostęp do katalogu 10 000 książek. Użytkownik może przeszukiwać wykaz, wprowadzając tekst na pasku wyszukiwania. Gdy użytkownik wprowadza tekst, witryna internetowa używa funkcji sugerowanej indeksu wyszukiwania do ukończenia tekstu. Po zakończeniu zapytania zostanie wyświetlona lista książek z częścią szczegółów. Użytkownik może wybrać książkę, aby wyświetlić wszystkie szczegóły, przechowywane w indeksie wyszukiwania książki.
Środowisko wyszukiwania obejmuje:
- Wyszukiwanie — udostępnia funkcje wyszukiwania dla aplikacji.
- Sugerowanie — udostępnia sugestie, gdy użytkownik wpisuje na pasku wyszukiwania.
- Aspekty i filtry — udostępnia strukturę nawigacji aspektowej, która filtruje według autora lub języka.
- Wyniki podzielone na strony — udostępnia kontrolki stronicowania służące do przewijania wyników.
- Wyszukiwanie dokumentów — wyszukuje dokument według identyfikatora, aby pobrać całą jego zawartość dla strony szczegółów.
Jak jest zorganizowana próbka?
Przykładowy kod zawiera następujące elementy:
Aplikacja | Przeznaczenie | GitHub Repozytorium Lokalizacja |
---|---|---|
Klient | Aplikacja React (warstwa prezentacji) do wyświetlania książek z wyszukiwaniem. Wywołuje aplikację funkcji platformy Azure. | /search-website-functions-v4/client |
Serwer | Aplikacja funkcji platformy Azure (warstwa biznesowa) — wywołuje interfejs API wyszukiwania sztucznej inteligencji platformy Azure przy użyciu zestawu SDK języka Python | /search-website-functions-v4/api |
Wstawianie zbiorcze | Plik języka Python umożliwiający utworzenie indeksu i dodanie do niego dokumentów. | /search-website-functions-v4/bulk-upload |
Konfigurowanie środowiska projektowego
Zainstaluj następujące elementy dla lokalnego środowiska deweloperskiego.
- Python 3.9
- Usługa Git
- Program Visual Studio Code i następujące rozszerzenia
- Statyczna aplikacja internetowa platformy Azure
- Użyj zintegrowanego terminalu na potrzeby operacji wiersza polecenia.
- Opcjonalne:
- Ten samouczek nie uruchamia interfejsu API funkcji platformy Azure lokalnie, ale jeśli zamierzasz uruchomić go lokalnie, musisz zainstalować narzędzia azure-functions-core-tools.
Rozwidlenie i sklonowanie przykładu wyszukiwania za pomocą narzędzia git
Tworzenie rozwidlenia przykładowego repozytorium ma kluczowe znaczenie dla wdrożenia statycznej aplikacji internetowej. Aplikacje internetowe określają akcje kompilacji i zawartość wdrożenia na podstawie własnej lokalizacji rozwidlenia usługi GitHub. Wykonywanie kodu w statycznej aplikacji internetowej jest zdalne, a statyczne aplikacje internetowe platformy Azure odczytane z kodu w rozwidlonym przykładzie.
W witrynie GitHub rozwidlenie przykładowego repozytorium.
Ukończ proces rozwidlenia w przeglądarce internetowej przy użyciu konta usługi GitHub. W tym samouczku używany jest rozwidlenie w ramach wdrożenia do statycznej aplikacji internetowej platformy Azure.
W terminalu powłoki bash pobierz przykładową aplikację na komputer lokalny.
Zastąp
YOUR-GITHUB-ALIAS
element aliasem usługi GitHub.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-python-samples.git
W programie Visual Studio Code otwórz folder lokalny sklonowanego repozytorium. Pozostałe zadania są wykonywane z programu Visual Studio Code, chyba że określono.
Tworzenie grupy zasobów dla zasobów platformy Azure
W programie Visual Studio Code otwórz pasek Działania i wybierz ikonę platformy Azure.
Zaloguj się do platformy Azure, jeśli jeszcze nie zalogowałeś się.
W sekcji Zasoby wybierz pozycję Dodaj (+), a następnie wybierz pozycję Utwórz grupę zasobów.
Wprowadź nazwę grupy zasobów, na przykład
cognitive-search-demo-rg
.Wprowadź region:
- W polu Node.js wybierz pozycję
West US 2
. Jest to zalecany region dla wersji zapoznawczej modelu programowania funkcji platformy Azure (PM) w wersji 4. - W przypadku języków C# i Python zalecamy następujące regiony, które są obsługiwane przez usługę Azure Static Web Apps w następujący sposób:
West US 2
, ,East US 2
West Europe
, ,Central US
East Asia
- W polu Node.js wybierz pozycję
Użyj tej grupy zasobów dla wszystkich zasobów utworzonych w tym samouczku. Grupa zasobów udostępnia jednostkę logiczną do zarządzania zasobami, w tym ich usuwanie po zakończeniu.