Distribuera en AI-aktiverad instans av Spring PetClinic i Azure Container Apps

I den här artikeln får du lära dig hur du använder Azure OpenAI Service och Azure Container Apps för att skapa ett naturligt språkgränssnitt för Spring PetClinic-exempelprogrammet.

Information om arkitekturen för det här programmet finns i Java PetClinic AI-exempel i Container Apps-översikten.

Att tänka på

• Distributionstid: Det AI-aktiverade programmet som distribueras i den här artikeln kräver en serie anslutna tjänster för att fungera. Distributionstiderna kan ta upp till 15 minuter att slutföra. Planera din tid i enlighet med detta när du går igenom den här självstudien.

• Modelltillgänglighet: Exempelprogrammet använder Azure OpenAI Service-distributionsmoduler gpt-4o och text-embedding-ada-002, som kanske inte är tillgängliga i alla Azure-regioner.

  Mer information om tillgänglighet finns i Azure OpenAI Service-modeller och välj önskad distributionsregion. För bästa resultat bör du överväga att använda någon av följande regioner: USA, östra, USA, östra 2, USA, norra centrala, USA, södra centrala, Sverige, centrala, USA, västra eller USA, västra 3.

Förutsättningar

• En Azure-prenumeration. Skapa en kostnadsfritt..
• Contributor roller User Access Administrator eller Owner rollen. Mer information finns i Tilldela Azure-roller med hjälp av Azure-portalen.
• Ett GitHub-konto.
• Den senaste versionen av git.
• Microsoft Build of Open JDK, version 17 eller senare.
• Azure Developer CLI.
• Azure CLI.
• Maven.

Ställ in

1. Klona exempelprogrammet till datorn med hjälp av följande kommando:

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

2. Navigera till mappen spring-petclinic-ai med hjälp av följande kommando:

   cd spring-petclinic-ai
   

3. Om du inte redan har det installerar containerapp du tillägget för Azure CLI med hjälp av följande kommando:

   az extension add --name containerapp --upgrade
   

4. Logga in på ditt Azure-konto på ett säkert sätt med hjälp av följande kommando:

   az auth login  
   

   Det här kommandot öppnar en webbsida där du kan ange dina Azure-autentiseringsuppgifter för att autentisera.

Distribuera

1. Distribuera programmet automatiskt med hjälp av följande kommando:

   azd up
   

2. När du uppmanas till det anger du my-first-ai som miljönamn.

   Därefter anger du värden för Azure Subscription och Azure location, som ersätter dina faktiska värden för <..> platshållarna i följande frågor:

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

   När du har angett alla nödvändiga värden kan du behöva vänta upp till 15 minuter innan programmet distribueras.

   När distributionen är klar visas utdata som liknar följande för att meddela dig om en lyckad distribution:

   (✓) 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. Leta upp programmets URL.

   Granska utdata och leta reda på meddelandet om att distributionen lyckades och kopiera URL:en till Urklipp.

   Meddelandet om lyckat resultat liknar följande utdata:

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

Prova ditt program

1. Visa programmet i en webbläsare med den URL som du kopierade i slutet av det sista avsnittet.

2. Du kan interagera med chattroboten via frågor som följande:

   • Visa en lista över alla registrerade husdjursägare.
   • Lägg till en ny djurägare med namnet Steve.
   • Ändra Steves namn till Steven.
   • Lägg till ett husdjur med namnet Spot.
   • Visa en lista över alla veterinärer i systemet.

Följande bild visar resultatet av att be programmet att lägga till en ny husdjursägare i systemet:

Uppdateringar

När du experimenterar med exemplet kan du använda följande kommandon för att publicera ändringarna om du vill distribuera ändringar till programmet:

azd package
azd deploy

Rensa resurser

Om du planerar att fortsätta arbeta med efterföljande självstudier kanske du vill behålla dessa resurser. När du inte längre behöver resurserna tar du bort resursgruppen, som även tar bort dess resurser.

az group delete --name rg-first-ai