Hızlı Başlangıç: Azure OpenAI'yi tümleştirme

2025-04-10

Not

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış planı 30 Eylül 2024'te emeklilik dönemine girdi ve Mart 2025 sonuna kadar tamamen kapatılacak. Daha fazla bilgi için Azure Spring Apps Standart tüketimlerini ve ayrılmış planlarını Azure Container Apps'e geçirme başlıklı makaleye bakın.

Bu makale şunlar için geçerlidir: ❎ Temel/Standart ✅ Kurumsal

Bu hızlı başlangıçta, Azure OpenAI'yi Azure Spring Apps Kurumsal planında dağıtılan uygulamalarla tümleştirme adımları gösterilmektedir.

Azure OpenAI, uygulamalarınızın yeni akıl yürütme ve kavrama özelliklerine olanak tanımak için dil ve kod hakkında ayrıntılı bilgi edinerek büyük ölçekli, üretken yapay zeka modellerinden yararlanmasını sağlar.

Aşağıdaki videoda Azure Spring Apps'in akıllı uygulamalar oluşturmak için Azure OpenAI'yi nasıl kullandığı gösterilmektedir:

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Azure OpenAI'ye erişim izni verildi. Daha fazla bilgi için bkz . Azure OpenAI Hizmetine Erişim İsteme.
Azure Market'da Kurumsal planın Gereksinimler bölümünü anlayın ve yerine getirin.
Azure CLI sürüm 2.45.0 veya üzeri.
Git.
jq
Azure Spring Apps Kurumsal plan uzantısı. Önceki sürümleri kaldırmak ve en son Kurumsal plan uzantısını yüklemek için aşağıdaki komutu kullanın. Uzantıyı spring-cloud daha önce yüklediyseniz yapılandırma ve sürüm uyuşmazlıklarını önlemek için uzantıyı kaldırın.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Kurumsal planı kullanarak Uygulamaları derleme ve Azure Spring Apps'e dağıtma bölümünde yer alan adımları tamamlayın.

Azure OpenAI sağlama

Uygulamaya yapay zeka eklemek için bir Azure OpenAI hesabı oluşturun ve dil modellerini dağıtın. Aşağıdaki adımlarda, Azure CLI kullanarak Azure OpenAI hesabı sağlama ve dil modellerini dağıtma adımları açıklanmaktadır:

Azure OpenAI hesabı oluşturmak için aşağıdaki komutu kullanın:

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>

Azure OpenAI hizmet örneğinizde text-embedding-ada-002 ve gpt-35-turbo-16k için model dağıtımlarını oluşturmak için aşağıdaki komutları kullanın:

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

Azure Spring Apps'e Yardım Hizmeti dağıtma

Yardım Hizmeti uygulamasını oluşturmak, yapılandırmak ve Azure Spring Apps'e dağıtmak için aşağıdaki adımları kullanın.

Yeni yapay zeka hizmetini assist-serviceoluşturmak için aşağıdaki komutu kullanın:

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

Spring Cloud Gateway'i Yardım Hizmeti yolu ile yapılandırmak için aşağıdaki komutu kullanın:

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

Azure OpenAI hizmetinin REST API uç nokta temel URL'sini almak için aşağıdaki komutu kullanın:

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

Birincil API anahtarını almak için aşağıdaki komutu kullanın:

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

Yardım Hizmeti uygulamasını dağıtmak için aşağıdaki komutu kullanın:

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

Şimdi Tarayıcıda Fitness Mağazası uygulamasını test edin. Yardım Hizmeti uygulamasıyla sohbet etmek için FITASSIST'E SORUN'a tıklayın.
FitAssist'te "İşe gidip gelmek için bisiklete ihtiyacım var" yazın ve Assist Service uygulaması tarafından oluşturulan çıktıyı gözlemleyin.

Kaynakları temizleme

Sonraki hızlı başlangıçlar ve öğreticilerle çalışmaya devam etmek istiyorsanız, bu kaynakları yerinde bırakmak isteyebilirsiniz. Artık gerekli olmadığında kaynak grubunu silin; bu da kaynak grubundaki kaynakları siler. Azure CLI kullanarak kaynak grubunu silmek için aşağıdaki komutları kullanın:

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

Sonraki adımlar

Aşağıdaki isteğe bağlı hızlı başlangıçlardan herhangi birine geçin:

Aracılığıyla paylaş