Wdrażanie wystąpienia aplikacji Spring PetClinic z obsługą sztucznej inteligencji w usłudze Azure Container Apps

Z tego artykułu dowiesz się, jak używać usług Azure OpenAI Service i Azure Container Apps do tworzenia interfejsu języka naturalnego dla przykładowej aplikacji Spring PetClinic.

Aby uzyskać informacje na temat szczegółów architektury tej aplikacji, zobacz Przykład java PetClinic AI w temacie Container Apps overview (Omówienie usługi Container Apps).

Kwestie wymagające rozważenia

• Czas wdrożenia: aplikacja z obsługą sztucznej inteligencji wdrożona w tym artykule wymaga serii połączonych usług do działania. Czas wdrażania może potrwać do 15 minut. Zaplanuj odpowiednio czas podczas pracy z tym samouczkiem.

• Dostępność modelu: przykładowa aplikacja korzysta z modułów wdrażania gpt-4o i text-embedding-ada-002, które mogą być niedostępne we wszystkich regionach świadczenia usługi Azure.

  Aby uzyskać więcej informacji na temat dostępności, zobacz Modele usługi Azure OpenAI Service i wybierz żądany region wdrażania. Aby uzyskać najlepsze wyniki, rozważ użycie jednego z następujących regionów: Wschodnie stany USA, Wschodnie stany USA 2, Północno-środkowe stany USA, Południowo-środkowe stany USA, Szwecja Środkowe, Zachodnie stany USA lub Zachodnie stany USA 3.

Wymagania wstępne

• Subskrypcja platformy Azure. Utwórz je bezpłatnie.
• Contributor i User Access Administrator role lub Owner rola. Aby uzyskać więcej informacji, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal.
• Konto usługi GitHub.
• Najnowsza wersja narzędzia git.
• Microsoft Build of Open JDK, wersja 17 lub nowsza.
• Interfejs wiersza polecenia dla deweloperów platformy Azure.
• Interfejs wiersza polecenia platformy Azure.
• Maven.

Ustawienia

1. Sklonuj przykładową aplikację na maszynę przy użyciu następującego polecenia:

   git clone https://github.com/Azure-Samples/spring-petclinic-ai.git
   

2. Przejdź do folderu spring-petclinic-ai , używając następującego polecenia:

   cd spring-petclinic-ai
   

3. Jeśli jeszcze go nie masz, zainstaluj containerapp rozszerzenie dla interfejsu wiersza polecenia platformy Azure przy użyciu następującego polecenia:

   az extension add --name containerapp --upgrade
   

4. Bezpiecznie zaloguj się do konta platformy Azure przy użyciu następującego polecenia:

   az auth login  
   

   To polecenie otwiera stronę internetową, na której można wprowadzić poświadczenia platformy Azure w celu uwierzytelnienia.

Wdróż

1. Automatycznie wdróż aplikację przy użyciu następującego polecenia:

   azd up
   

2. Po wyświetleniu monitu wprowadź ciąg my-first-ai jako nazwę środowiska.

   Następnie wprowadź wartości dla Azure Subscription i Azure location, podstawiając rzeczywiste wartości dla <..> symboli zastępczych w następujących monitach:

   ? Enter a new environment name: my-first-ai
   ? Select an Azure Subscription to use: <SUBSCRIPTION>
   ? Select an Azure location to use: <REGION>
   

   Po podaniu wszystkich wymaganych wartości może być konieczne odczekenie ponad 15 minut na wdrożenie aplikacji.

   Po zakończeniu wdrażania zobaczysz dane wyjściowe podobne do następujących, aby powiadomić o pomyślnym wdrożeniu:

   (✓) Done: Resource group: rg-my-first-ai (5.977s)
   (✓) Done: Virtual Network: vnet-my-first-ai (7.357s)
   (✓) Done: Container Registry: crb36onby7z5ooc (25.742s)
   (✓) Done: Azure OpenAI: openai-my-first-ai (25.324s)
   (✓) Done: Azure AI Services Model Deployment: openai-my-first-ai/text-embedding-ada-002 (42.909s)
   (✓) Done: Azure AI Services Model Deployment: openai-my-first-ai/gpt-4o (44.21s)
   (✓) Done: Container Apps Environment: aca-env-my-first-ai (3m1.361s)
   (✓) Done: Container App: petclinic-ai (22.701s)
   
   INFO: Deploy finish succeed!
   INFO: App url: petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io
   
   Packaging services (azd package)
   
   (✓) Done: Packaging service petclinic-ai
   
   Deploying services (azd deploy)
   
   (✓) Done: Deploying service petclinic-ai
   - Endpoint: https://petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io/
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 17 minutes 40 seconds.
   

3. Znajdź adres URL aplikacji.

   Sprawdź dane wyjściowe i znajdź komunikat o powodzeniu wdrożenia i skopiuj adres URL do schowka.

   Komunikat o powodzeniu przypomina następujące dane wyjściowe:

   INFO: Deploy finish succeed!
   INFO: App url: https://petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io
   

Wypróbuj aplikację

1. Wyświetl aplikację w przeglądarce internetowej przy użyciu adresu URL skopiowanego na końcu ostatniej sekcji.

2. Możesz wchodzić w interakcję z czatbotem za pośrednictwem monitów, takich jak następujące:

   • Wyświetl listę wszystkich zarejestrowanych właścicieli zwierząt domowych.
   • Dodaj nowego właściciela zwierzaka o nazwie Steve.
   • Zmień nazwę Steve'a na Stevena.
   • Dodaj zwierzę o nazwie Spot.
   • Wyświetl listę wszystkich weterynarzy w systemie.

Na poniższej ilustracji przedstawiono wynik z prośbą aplikacji o dodanie nowego właściciela zwierzaka do systemu:

Aktualizacje

Podczas eksperymentowania z przykładem, jeśli chcesz wdrożyć zmiany w aplikacji, możesz użyć następujących poleceń, aby opublikować zmiany:

azd package
azd deploy

Czyszczenie zasobów

Jeśli planujesz kontynuować pracę z kolejnymi samouczkami, możesz zachować te zasoby. Gdy zasoby nie będą już potrzebne, usuń grupę zasobów, która również usunie jej zasoby.

az group delete --name rg-first-ai