Quickstart: Azure OpenAI integreren

Artikel
11/06/2024

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.

Dit artikel is van toepassing op: ❎ Basic/Standard ✅ Enterprise

In deze quickstart ziet u hoe u Azure OpenAI integreert met toepassingen die zijn geïmplementeerd in het Azure Spring Apps Enterprise-plan.

Met Azure OpenAI kunnen uw toepassingen profiteren van grootschalige, generatieve AI-modellen met uitgebreide kennis van taal en code om nieuwe redenerings- en begripsmogelijkheden mogelijk te maken.

In de volgende video ziet u hoe Azure Spring Apps Gebruikmaakt van Azure OpenAI om intelligente toepassingen te bouwen:

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Toegang verleend aan Azure OpenAI. Zie Toegang tot De Azure OpenAI-service aanvragen voor meer informatie.
Inzicht in en voldoen aan de sectie Vereisten van het Enterprise-plan in Azure Marketplace.
De Azure CLI versie 2.45.0 of hoger.
Git.
jq
De Azure Spring Apps Enterprise-abonnementsextensie. Gebruik de volgende opdracht om eerdere versies te verwijderen en de nieuwste Enterprise-abonnementsextensie te installeren. Als u de extensie eerder hebt geïnstalleerd, verwijdert u deze spring-cloud om te voorkomen dat de configuratie en versie niet overeenkomen.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Voer de stappen in Het bouwen en implementeren van apps in Azure Spring Apps uit met behulp van het Enterprise-abonnement.

Azure OpenAI inrichten

Als u AI wilt toevoegen aan de toepassing, maakt u een Azure OpenAI-account en implementeert u taalmodellen. In de volgende stappen wordt beschreven hoe u een Azure OpenAI-account inricht en taalmodellen implementeert met behulp van de Azure CLI:

Gebruik de volgende opdracht om een Azure OpenAI-account te maken:

az cognitiveservices account create \
    --resource-group <resource-group-name> \
    --name <open-ai-service-name> \
    --location <region> \
    --kind OpenAI \
    --sku s0 \
    --custom-domain <open-ai-service-name>

Gebruik de volgende opdrachten om de modelimplementaties voor text-embedding-ada-002 en gpt-35-turbo-16k in uw Azure OpenAI-service-exemplaar te maken:

az cognitiveservices account deployment create \
    --resource-group <resource-group-name> \
    --name <open-ai-service-name> \
    --deployment-name text-embedding-ada-002 \
    --model-name text-embedding-ada-002 \
    --model-version "2"  \
    --model-format OpenAI \
    --sku-name "Standard" \
    --sku-capacity 1

az cognitiveservices account deployment create \
    --resource-group <resource-group-name> \
    --name <open-ai-service-name> \
    --deployment-name gpt-35-turbo-16k \
    --model-name gpt-35-turbo-16k \
    --model-version "0613"  \
    --model-format OpenAI \
    --sku-name "Standard" \
    --sku-capacity 1

Assist Service implementeren in Azure Spring Apps

Gebruik de volgende stappen om de Assist Service-toepassing te maken, configureren en implementeren in Azure Spring Apps.

Gebruik de volgende opdracht om de nieuwe AI-service te maken: assist-service

az spring app create \
    --resource-group <resource-group-name> \
    --name assist-service \
    --service <Azure-Spring-Apps-service-instance-name> \
    --instance-count 1 \
    --memory 1Gi

Gebruik de volgende opdracht om Spring Cloud Gateway te configureren met de Assist-serviceroute:

az spring gateway route-config create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name assist-routes \
    --app-name assist-service \
    --routes-file azure-spring-apps-enterprise/resources/json/routes/assist-service.json

Gebruik de volgende opdracht om de basis-URL van het REST API-eindpunt voor de Azure OpenAI-service op te halen:

export SPRING_AI_AZURE_OPENAI_ENDPOINT=$(az cognitiveservices account show \
    --name <open-ai-service-name> \
    --resource-group <resource-group-name> \
    | jq -r .properties.endpoint)

Gebruik de volgende opdracht om de primaire API-sleutel op te halen:

export SPRING_AI_AZURE_OPENAI_APIKEY=$(az cognitiveservices account keys list \
    --name <open-ai-service-name> \
    --resource-group <resource-group-name> \
    | jq -r .key1)

Gebruik de volgende opdracht om de Assist Service-toepassing te implementeren:

az spring app deploy 
    --resource-group <resource-group-name> \
    --name assist-service \
    --service <Azure-Spring-Apps-service-instance-name> \
    --source-path apps/acme-assist \
    --build-env BP_JVM_VERSION=17 \
    --env \
        SPRING_AI_AZURE_OPENAI_ENDPOINT=${SPRING_AI_AZURE_OPENAI_ENDPOINT} \
        SPRING_AI_AZURE_OPENAI_APIKEY=${SPRING_AI_AZURE_OPENAI_APIKEY} \
        SPRING_AI_AZURE_OPENAI_MODEL=gpt-35-turbo-16k \
        SPRING_AI_AZURE_OPENAI_EMBEDDINGMODEL=text-embedding-ada-002

Test nu de Fitness Store-toepassing in de browser. Selecteer VRAAG OM FITASSIST om te communiceren met de Assist-servicetoepassing.
Voer in FitAssist een fiets in voor een woon-werkverkeer en bekijk de uitvoer die is gegenereerd door de Assist Service-toepassing:

Resources opschonen

Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Als u de resourcegroep niet meer nodig hebt, verwijdert u deze. Hierdoor worden ook de resources in de resourcegroep verwijderd. Als u de resourcegroep wilt verwijderen met behulp van Azure CLI, gebruikt u de volgende opdrachten:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Volgende stappen

Ga door naar een van de volgende optionele quickstarts:

Delen via