Een exemplaar met AI-functionaliteit van Spring PetClinic implementeren in Azure Container Apps

In dit artikel leert u hoe u Azure OpenAI Service en Azure Container Apps gebruikt om een interface voor natuurlijke taal te maken voor de Spring PetClinic-voorbeeldtoepassing.

Zie het Java PetClinic AI-voorbeeld in het overzicht van Container Apps voor meer informatie over de architectuur van deze toepassing.

Overwegingen

• Implementatietijd: De ai-toepassing die in dit artikel is geïmplementeerd, vereist een reeks verbonden services om te werken. Het kan 15 minuten duren voordat de implementatietijden zijn voltooid. Plan uw tijd dienovereenkomstig tijdens het uitvoeren van deze zelfstudie.

• Beschikbaarheid van modellen: de voorbeeldtoepassing maakt gebruik van Azure OpenAI Service-implementatiemodulesgpt-4o en text-embedding-ada-002, die mogelijk niet beschikbaar zijn in alle Azure-regio's.

  Zie Azure OpenAI Service-modellen voor meer informatie over beschikbaarheid en selecteer de gewenste implementatieregio. Voor de beste resultaten kunt u een van de volgende regio's gebruiken: VS - oost, VS - oost 2, VS - noord-centraal, VS - zuid-centraal, Zweden - centraal, VS - west of VS - west 3.

Vereisten

• Een Azure-abonnement. Maak er gratis een.
• Contributor en User Access Administrator rollen, of de Owner rol. Zie voor meer informatie Azure-rollen toewijzen met behulp van de Azure-portal.
• Een GitHub-account.
• De nieuwste versie van Git.
• De Microsoft Build van Open JDK, versie 17 of hoger.
• Azure Developer CLI-.
• Azure CLI.
• Maven.

Instellingen

1. Kloon de voorbeeldtoepassing naar uw computer met behulp van de volgende opdracht:

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

2. Navigeer naar de map spring-petclinic-ai met behulp van de volgende opdracht:

   cd spring-petclinic-ai
   

3. Als u deze nog niet hebt, installeert u de containerapp extensie voor de Azure CLI met behulp van de volgende opdracht:

   az extension add --name containerapp --upgrade
   

4. Meld u veilig aan bij uw Azure-account met behulp van de volgende opdracht:

   az auth login  
   

   Met deze opdracht opent u een webpagina waar u uw Azure-referenties kunt invoeren om te verifiëren.

Implementeren

1. Implementeer de toepassing automatisch met behulp van de volgende opdracht:

   azd up
   

2. Wanneer u hierom wordt gevraagd, voert u my-first-ai in voor de naam van de omgeving.

   Voer daarna waarden in voor Azure Subscription en Azure locationvervang de werkelijke waarden voor de <..> tijdelijke aanduidingen in de volgende prompts:

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

   Nadat u alle vereiste waarden hebt opgegeven, moet u mogelijk maximaal 15 minuten wachten totdat de toepassing is geïmplementeerd.

   Wanneer de implementatie is voltooid, ziet u uitvoer die lijkt op het volgende om u op de hoogte te stellen van een geslaagde implementatie:

   (✓) 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. Zoek de toepassings-URL.

   Controleer de uitvoer en zoek het bericht over het slagen van de implementatie en kopieer de URL naar het klembord.

   Het bericht met succes lijkt op de volgende uitvoer:

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

Uw toepassing uitproberen

1. Bekijk de toepassing in een webbrowser met behulp van de URL die u hebt gekopieerd aan het einde van de laatste sectie.

2. U kunt de chatbot gebruiken via prompts als volgt:

   • Vermeld alle geregistreerde eigenaren van huisdieren.
   • Voeg een nieuwe huisdiereigenaar toe met de naam Steve.
   • Wijzig Steve's naam in Steven.
   • Voeg een huisdier toe met de naam Spot.
   • Vermeld alle dierenartsen in uw systeem.

In de volgende afbeelding ziet u het resultaat van het vragen van de toepassing om een nieuwe huisdiereigenaar toe te voegen aan het systeem:

Actualisaties

Als u experimenteert met het voorbeeld, kunt u, als u wijzigingen in de toepassing wilt implementeren, de volgende opdrachten gebruiken om uw wijzigingen te publiceren:

azd package
azd deploy

Resources opschonen

Als u van plan bent om door te gaan met de volgende zelfstudies, kunt u deze resources behouden. Wanneer u de resources niet meer nodig hebt, verwijdert u de resourcegroep, die ook de bijbehorende resources verwijdert.

az group delete --name rg-first-ai