Samouczek: dodawanie Wyszukiwanie AI platformy Azure do aplikacji internetowej w języku C# w Azure Container Apps

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.

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 interfejsu wiersza polecenia dewelopera Azure (azd) i tożsamości zarządzanej jako domyślnej metody uwierzytelniania dla Wyszukiwanie AI platformy Azure.

W tym samouczku nauczysz się następujących rzeczy:

• Wdróż Wyszukiwanie AI platformy Azure i automatycznie inicjuj indeks za pomocą interfejsu wiersza polecenia dewelopera Azure.
• 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.
• Sugestie — wyświetla sugestie podczas wpisywania w pasku wyszukiwania.
• Aspekty i filtry — udostępnia strukturę nawigacji aspektowej, która filtruje według autora lub języka.
• Wyniki stronicowane — udostępnia kontrolki stronicowania umożliwiające przechodzenie między stronami 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 usługi Azure Functions w języku C# (warstwa biznesowa), hostowany w kontenerze w usłudze Azure Container Apps, wywołujący interfejs API usługi Wyszukiwanie AI platformy Azure 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 Wyszukiwanie AI platformy Azure, 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 tworzy wszystkie zasoby platformy Azure, w tym Wyszukiwanie AI platformy Azure, dzięki czemu nie musisz tworzyć ich wcześniej.

• .NET 9 lub nowsza wersja
• Usługa Git
• Visual Studio Code
• Rozszerzenie C# Dev Tools dla programu 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.

1. W terminalu Bash sklonuj przykładową aplikację na komputerze lokalnym.

   git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
   

2. W tym samym terminalu Bash przejdź do katalogu repozytorium tego przykładu wyszukiwania.

   cd azure-search-static-web-app
   

3. Uż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 .
   

Następny krok

Wdrażanie aplikacji w usłudze Azure Container Apps