Share via


快速入門:整合 Azure OpenAI

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱,但在我們努力更新資產,例如螢幕快照、影片和圖表時,您會在某些地方看到舊名稱一段時間。

本文適用於:❌ 基本/標準✔️企業

本快速入門說明如何整合 Azure OpenAI 與部署在 Azure Spring Apps 企業版方案上的應用程式。

Azure OpenAI 可讓應用程式利用對語言和程式代碼有深入瞭解的大型、產生式 AI 模型,以啟用新的推理和理解功能。

下列影片顯示 Azure Spring Apps 如何使用 Azure OpenAI 來建置智慧型手機應用程式:


必要條件

布建 Azure OpenAI

若要將 AI 新增至應用程式,請建立 Azure OpenAI 帳戶並部署語言模型。 下列步驟說明如何使用 Azure CLI 布建 Azure OpenAI 帳戶和部署語言模型:

  1. 使用下列命令來建立 Azure OpenAI 帳戶:

    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>   
    
  2. 使用下列命令,在 Azure OpenAI 服務實例中建立 text-embedding-ada-002gpt-35-turbo-16k 的模型部署:

    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 部署至 Azure Spring Apps

使用下列步驟來建立、設定及部署 Assist Service 應用程式至 Azure Spring Apps。

  1. 使用下列命令來建立新的 AI 服務: 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
    
  2. 使用下列命令設定 Spring Cloud Gateway 與 Assist Service 路由:

    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
    
  3. 使用下列命令來擷取 Azure OpenAI 服務的 REST API 端點基底 URL:

    export SPRING_AI_AZURE_OPENAI_ENDPOINT=$(az cognitiveservices account show \
        --name <open-ai-service-name> \
        --resource-group <resource-group-name> \
        | jq -r .properties.endpoint)
    
  4. 使用下列命令來擷取主要 API 金鑰:

    export SPRING_AI_AZURE_OPENAI_APIKEY=$(az cognitiveservices account keys list \
        --name <open-ai-service-name> \
        --resource-group <resource-group-name> \
        | jq -r .key1)
    
  5. 使用下列命令來部署 Assist Service 應用程式:

    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
    
  6. 現在,在瀏覽器中測試 Fitness Store 應用程式。 選取 [ASK TO FITASSIST ] 來與 [輔助服務] 應用程式交談。

    Screenshot that shows the ASK TO FITASSIST button.

  7. FitAssist 中,輸入 我需要自行車,以便通勤工作 ,並觀察輔助服務應用程式所產生的輸出:

    Screenshot that shows the 'I need a bike for a commute to work' query and the response from the Fitness Store assistant.

清除資源

如果您打算繼續使用後續的快速入門和教學課程,您可能會想要保留這些資源。 若不再需要,請刪除資源群組,以刪除資源群組中的資源。 若要使用 Azure CLI 刪除資源群組,請使用下列命令:

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

下一步

繼續進行下列任一選擇性快速入門: