你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：集成 Azure OpenAI

项目
10/02/2024

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。建议转换到 Azure 容器应用。有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。建议转换到 Azure 容器应用。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于： ❎ 基本计划/标准计划 ✅ 企业计划

本快速入门介绍如何在 Azure Spring Apps 企业计划中将 Azure OpenAI 与部署的应用程序集成。

Azure OpenAI 使应用程序能够利用大规模的生成式 AI 模型以及对语言和代码的深入理解，来实现新的推理和理解功能。

以下视频演示了 Azure Spring Apps 如何使用 Azure OpenAI 生成智能应用程序：

先决条件

具有活动订阅的 Azure 帐户。免费创建帐户。
授予对 Azure OpenAI 的访问权限。有关详细信息，请参阅请求访问 Azure OpenAI 服务。
了解并满足 Azure 市场中企业计划的要求部分。
Azure CLI 版本 2.45.0 或更高版本。
Git。
jq
Azure Spring Apps 企业计划扩展。使用以下命令删除以前的版本，并安装最新的企业计划扩展。如果以前安装了 spring-cloud 扩展，请卸载它以避免配置和版本不匹配。
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
完成使用企业计划生成应用并将其部署到 Azure Spring Apps 中的步骤。

预配 Azure OpenAI

若要将 AI 添加到应用程序，请创建 Azure OpenAI 帐户并部署语言模型。以下步骤说明如何使用 Azure CLI 预配 Azure OpenAI 帐户和部署语言模型：

使用以下命令创建 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>

使用以下命令在 Azure OpenAI 服务实例中创建 text-embedding-ada-002 和 gpt-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。

使用以下命令创建新的 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

使用以下命令为 Spring Cloud 网关配置 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

使用以下命令检索 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)

使用以下命令检索主 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)

使用以下命令部署 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

现在，在浏览器中测试 Fitness Store 应用程序。选择“向 FITASSIST 提问”以便与 Assist Service 应用程序对话。
在“FitAssist”中，输入“我需要一辆上下班用的自行车”，然后观察 Assist Service 应用程序生成的输出：

清理资源

如果打算继续使用后续的快速入门和教程，则可能需要保留这些资源。如果不再需要资源组，可以将其删除，这将删除资源组中的资源。若要使用 Azure CLI 删除资源组，请使用以下命令：

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

后续步骤

继续学习以下任一可选快速入门：

通过