Krok 1. Omówienie dodawania wyszukiwania do witryny internetowej przy użyciu platformy .NET
Ten samouczek tworzy witrynę internetową do wyszukiwania w katalogu książek, a następnie wdraża 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 foldery:
Aplikacja | Purpose | 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 .NET (warstwa biznesowa) — wywołuje interfejs API wyszukiwania sztucznej inteligencji platformy Azure przy użyciu zestawu SDK platformy .NET | /search-website-functions-v4/api |
Wstawianie zbiorcze | Plik .NET w celu utworzenia indeksu i dodania do niego dokumentów. | /search-website-functions-v4/bulk-insert |
Konfigurowanie środowiska projektowego
Zainstaluj następujące oprogramowanie dla lokalnego środowiska deweloperskiego.
- .NET 6 lub nowszy
- 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 usługa Azure Static Web Apps odczytuje kod z rozwidlenia przykładu.
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ę rozwidlenia na komputer lokalny.
Zastąp
YOUR-GITHUB-ALIAS
element aliasem usługi GitHub.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples
W tym samym terminalu powłoki Bash przejdź do rozwidlenia repozytorium dla tego przykładu wyszukiwania w witrynie internetowej:
cd azure-search-dotnet-samples
Użyj polecenia programu Visual Studio Code,
code .
aby otworzyć rozwidlenie repozytorium. Pozostałe zadania są wykonywane z programu Visual Studio Code, chyba że określono.code .
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 przypadku 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 przypadku 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.