Quickstart: Azure OpenAI integreren

Artikel
02/01/2024

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

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: