Samouczek: dodawanie usługi Foundry IQ (Wyszukiwanie AI platformy Azure) do aplikacji internetowej C# w usłudze Azure Container Apps

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.

Zrzut ekranu przedstawiający przykładową aplikację z wynikami wyszukiwania dla psa z aspektami autora i języka oraz kontrolkami stronicowania.

Ś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ć.

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