Wdrażanie aplikacji Wyszukiwanie AI platformy Azure 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. Stanowi również podstawę Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy do wielokrotnego wykorzystania, z uwzględnieniem uprawnień, dla agentów w portalu Microsoft Foundry.

Wdróż witrynę internetową z obsługą wyszukiwania, aby Azure Container Apps przy użyciu interfejsu wiersza polecenia dewelopera Azure (azd). To wdrożenie obejmuje klienta React, interfejsu API .NET, Wyszukiwanie AI platformy Azure, tożsamości zarządzanej i pomocniczych zasobów Azure.

Wdrożenie używa tożsamości zarządzanej jako domyślnej metody uwierzytelniania dla Wyszukiwanie AI platformy Azure. Możesz wyrazić zgodę na uwierzytelnianie oparte na kluczach, ustawiając wartość USE_KEYLESS_AUTH na przed false wdrożeniem.

Zaloguj się do Azure

1. W Visual Studio Code otwórz terminal w katalogu głównym repozytorium, na przykład azure-search-static-web-app.

2. Zaloguj się do Azure przy użyciu azd.

   azd auth login
   

3. Jeśli zostanie wyświetlony monit przeglądarki, ukończ przepływ logowania przy użyciu konta Azure, którego używasz na potrzeby tego samouczka.

Tworzenie środowiska azd

• azd Tworzenie środowiska. Zastąp YOUR-ENVIRONMENT-NAME ciąg krótką nazwą identyfikującą to wdrożenie samouczka.

  azd env new YOUR-ENVIRONMENT-NAME
  

(Opcjonalnie) Konfigurowanie uwierzytelniania opartego na kluczach

Domyślną metodą uwierzytelniania jest tożsamość zarządzana, więc większość środowisk może pominąć tę sekcję. Wykonaj tę sekcję tylko wtedy, gdy środowisko wymaga kluczy interfejsu API.

Ustaw opcję USE_KEYLESS_AUTH na false.

azd env set USE_KEYLESS_AUTH false

Jeśli nie ustawisz USE_KEYLESS_AUTHustawienia , wdrożenie używa tożsamości zarządzanej. Infrastruktura Bicep przyznaje tożsamości aplikacji kontenera dostęp do płaszczyzny danych Wyszukiwanie AI platformy Azure.

Wdrażanie za pomocą narzędzia azd w górę

1. Uruchom program azd up z katalogu głównego repozytorium.

   azd up
   

2. Po wyświetleniu monitu wybierz subskrypcję Azure i lokalizację zasobów.

3. Poczekaj na azd aprowizację infrastruktury, skompiluj kontenery, wypchnij obrazy i wdróż usługi w celu Azure Container Apps.

4. Przejrzyj dane wyjściowe po wdrożeniu. Dane wyjściowe obejmują w pełni kwalifikowane nazwy domen klienta i serwera (FQDN) dla wdrożenia Azure Container Apps.

   AZURE_CLIENT_URL: <client-container-app-fqdn>
   AZURE_SERVER_URL: <server-container-app-fqdn>
   SEARCH_SERVICE_NAME: <search-service-name>
   

   AZURE_CLIENT_URL Użyj wartości , aby otworzyć witrynę internetową. Aplikacja kliencka wywołuje aplikację serwera za pośrednictwem punktu końcowego skonfigurowanego podczas wdrażania.

   Wdrożenie spowodowało również utworzenie usługi Wyszukiwanie AI platformy Azure i automatyczne załadowanie good-books indeksu postprovision za pośrednictwem haka w przykładowym repozytorium.

Korzystanie z wyszukiwania w witrynie internetowej usługi Container Apps

1. Otwórz nazwę FQDN klienta z danych wyjściowych azd up w przeglądarce.

2. Na pasku wyszukiwania witryny internetowej wprowadź zapytanie wyszukiwania, takie jak code. Funkcja autouzupełniania sugeruje dopasowywanie tytułów książek.

3. Wybierz sugestię lub kontynuuj wprowadzanie własnego zapytania. Wybierz klawisz Enter po zakończeniu zapytania wyszukiwania.

4. Przejrzyj wyniki, a następnie wybierz książkę, aby wyświetlić więcej szczegółów.

Troubleshooting

Jeśli aplikacja internetowa nie jest wdrażana lub nie działa, użyj poniższej listy, aby określić i rozwiązać problem:

• Czy ukończono azd up ?

  azd up Przejrzyj dane wyjściowe dla pierwszego nieudanego kroku aprowizacji, kompilacji lub wdrożenia. Jeśli wdrażanie zostanie zatrzymane podczas aprowizacji, sprawdź uprawnienia subskrypcji i wybrany region. Jeśli wdrożenie zostanie zatrzymane podczas kompilacji kontenera lub kroków wdrażania, uruchom azd up ponownie po rozwiązaniu zgłoszonego problemu.

• Czy można otworzyć punkt końcowy klienta?

  AZURE_CLIENT_URL Otwórz wartość z danych wyjściowychazd up. Jeśli strona nie zostanie załadowana, przejdź do portalu Azure, otwórz aplikację kontenera klienta i przejrzyj jej stan poprawek i dzienniki.

• Czy klient może wywołać punkt końcowy serwera?

  Otwórz narzędzia deweloperskie przeglądarki i przejrzyj wywołania sieciowe z aplikacji klienckiej. Jeśli wywołania interfejsu API nie powiedzą się, upewnij się, że aplikacja kontenera serwera jest uruchomiona i że aplikacja kliencka odebrała nazwę FQDN serwera podczas wdrażania.

• Czy serwer może wykonywać zapytania Wyszukiwanie AI platformy Azure?

  Jeśli wyszukiwanie zwraca błędy, przejrzyj dzienniki aplikacji kontenera serwera. W przypadku tożsamości zarządzanej upewnij się, że tożsamość ma Wyszukiwanie AI platformy Azure dostęp do płaszczyzny danych. W przypadku uwierzytelniania opartego na kluczach upewnij się, że ustawiono wartość USE_KEYLESS_AUTH przed false wdrożeniem i że wygenerowane środowisko kontenera zawiera konfigurację usługi wyszukiwania.

Uprzątnij zasoby

Użyj azd down --purge polecenia , aby usunąć zasoby Azure utworzone w tym samouczku. Flaga --purge trwale usuwa zasoby, które obsługują usuwanie nietrwałe, zamiast pozostawiać je w stanie możliwego do odzyskania dla okresu przechowywania. Czyszczenie pozwala uniknąć konfliktów nazewnictwa w przypadku ponownego wdrożenia tego samouczka później.

1. W katalogu głównym repozytorium uruchom polecenie czyszczenia.

   azd down --purge
   

2. Przejrzyj zasoby, które azd są wyświetlane.

3. Gdy pojawi się monit, potwierdź usunięcie.

Jeśli utworzono usługę Wyszukiwanie AI platformy Azure poza azd wdrożeniem, przejdź do usługi wyszukiwania w portalu Azure i wybierz pozycję Usuń w górnej części strony.

Następny krok

Eksplorowanie kodu integracji wyszukiwania