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 tworzy witrynę internetową, która przeszukuje katalog książek i wdraża witrynę internetową w 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.
• Integrowanie zapytań wyszukiwania, sugestii, aspektów, stronicowania i wyszukiwania 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 jako typ użytkownika 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 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 wyszukiwaniem. Wywołuje interfejs API.	/azure-search-static-web-app/client
api	Interfejs API Azure Functions języka C# (warstwa biznesowa) hostowany w kontenerze w Azure Container Apps, który wywołuje interfejs API 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 jest uruchamiane automatycznie przez punkt zaczepienia postprovision .	/azure-search-static-web-app/bulk-insert
infra	Bicep infrastruktury używanej przez azd program 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 aprowizuje wszystkie zasoby Azure, w tym Wyszukiwanie AI platformy Azure, więc nie trzeba ich wcześniej tworzyć.

• .NET 9 lub nowszych
• Usługa Git
• Visual Studio Code
• Rozszerzenie C# Dev Tools dla programu Visual Studio Code
• interfejs wiersza polecenia dewelopera Azure (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 pliki aplikacji i infrastruktury z lokalnego repozytorium, kompiluje kontenery, aprowizuje zasoby Azure i wdraża klienta i interfejs API w celu Azure Container Apps.

1. W terminalu powłoki Bash sklonuj przykładową aplikację na komputer lokalny.

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

2. W tym samym terminalu powłoki Bash przejdź do katalogu repozytorium dla 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