Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ten samouczek pokazuje, jak utworzyć witrynę internetową, która przeszukuje katalog książek, i wdrożyć ją w usłudze Azure Container Apps. Wdrożenie używa Azure Developer CLI (azd) i tożsamości zarządzanej jako domyślnej metody uwierzytelniania dla Foundry IQ.
W tym samouczku nauczysz się następujących rzeczy:
- Wdróż Foundry IQ i automatycznie zainicjuj indeks danymi za pomocą Azure Developer CLI.
- Zintegruj zapytania wyszukiwania, sugestie, filtry aspektowe, stronicowanie i wyszukiwanie dokumentów w aplikacji C#.
- Wdróż aplikację w Azure Container Apps przy użyciu tożsamości zarządzanej jako domyślna metoda uwierzytelniania.
Co robi próbka?
Ta przykładowa witryna internetowa zapewnia dostęp do katalogu 10 000 książek. Wykaz można przeszukiwać, wprowadzając tekst na pasku wyszukiwania. Podczas wprowadzania tekstu witryna internetowa używa funkcji sugestii indeksu wyszukiwania do automatycznego uzupełniania tekstu.
Po zakończeniu zapytania w witrynie internetowej zostanie wyświetlona lista książek z częścią ich szczegółów. Możesz wybrać książkę, aby wyświetlić jej pełne szczegóły, które są przechowywane w indeksie wyszukiwania.
Środowisko wyszukiwania obejmuje:
- Wyszukiwanie — udostępnia funkcje wyszukiwania dla aplikacji.
- Sugerowanie — udostępnia sugestie, gdy użytkownik wpisuje tekst na pasku wyszukiwania.
- Fasety i filtry — udostępnia strukturę nawigacji fasetowej, 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 dokumentu — 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 składniki:
| Aplikacja | Cel | lokalizacja repozytorium GitHub |
|---|---|---|
client |
Aplikacja React (warstwa prezentacji) do wyświetlania książek z funkcją wyszukiwania. Wywołuje interfejs API. | /azure-search-static-web-app/client |
api |
Interfejs API Azure Functions języka C# (warstwa biznesowa), hostowany w kontenerze na platformie Azure Container Apps, który wywołuje Foundry IQ API za pomocą zestawu SDK .NET. | /azure-search-static-web-app/api |
bulk-insert |
.NET projekt, który tworzy indeks i ładuje dokumenty. Wdrożenie azd uruchamia to automatycznie za pomocą hooka postprovision. |
/azure-search-static-web-app/bulk-insert |
infra |
Infrastruktura Bicep używana przez azd do wdrażania Foundry IQ, Azure Container Apps i zasobów pomocniczych. |
Azure-Samples/azure-search-static-web-app |
Konfigurowanie środowiska projektowego
Zainstaluj następujące oprogramowanie dla lokalnego środowiska deweloperskiego. Polecenie azd up aprowizuje wszystkie zasoby Azure, w tym IQ usługi Foundry, więc nie trzeba ich wcześniej tworzyć.
- .NET 9 lub nowsza
- Git
- Visual Studio Code
- Rozszerzenie C# Dev Tools dla Visual Studio Code
-
Azure Developer CLI (
azd) - Docker Desktop lub inne środowisko uruchomieniowe kontenera zgodne z platformą Docker
Ten samouczek nie uruchamia lokalnego interfejsu API Azure Functions. Jeśli chcesz uruchomić go lokalnie, zainstaluj narzędzia Azure Functions Core Tools.
Klonowanie przykładu wyszukiwania za pomocą narzędzia Git
Przykład można wdrożyć z klonu lokalnego. Polecenie azd up odczytuje z lokalnego repozytorium pliki aplikacji i infrastruktury, kompiluje kontenery, aprowizuje zasoby platformy Azure i wdraża aplikację kliencką oraz API do usługi Azure Container Apps.
W terminalu Bash sklonuj przykładową aplikację na komputerze lokalnym.
git clone https://github.com/Azure-Samples/azure-search-static-web-app.gitW tym samym terminalu Bash przejdź do katalogu repozytorium tego przykładu wyszukiwania.
cd azure-search-static-web-appUżyj polecenia Visual Studio Code ,
code .aby otworzyć repozytorium. O ile nie określono inaczej, należy wykonać pozostałe zadania w Visual Studio Code.code .