Guia de início rápido: integrar o Azure OpenAI

Artigo
10/01/2024

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a:❌ Basic/Standard ✔️ Enterprise

Este guia de início rápido mostra como integrar o Azure OpenAI com aplicativos implantados no plano Azure Spring Apps Enterprise.

O Azure OpenAI permite que as suas aplicações tirem partido de modelos de IA generativos em grande escala com conhecimentos profundos de linguagem e código para permitir novas capacidades de raciocínio e compreensão.

O vídeo a seguir mostra como o Azure Spring Apps usa o Azure OpenAI para criar aplicativos inteligentes:

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
Acesso concedido ao Azure OpenAI. Para obter mais informações, consulte Solicitar acesso ao Serviço OpenAI do Azure.
Compreenda e cumpra a secção Requisitos do plano Enterprise no Azure Marketplace.
A CLI do Azure versão 2.45.0 ou superior.
Git.
JQ
A extensão do plano do Azure Spring Apps Enterprise. Use o comando a seguir para remover versões anteriores e instalar a extensão de plano Enterprise mais recente. Se você instalou spring-cloud a extensão anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Conclua as etapas em Criar e implantar aplicativos no Azure Spring Apps usando o plano Enterprise.

Provisionar o Azure OpenAI

Para adicionar IA ao aplicativo, crie uma conta do Azure OpenAI e implante modelos de linguagem. As etapas a seguir descrevem como provisionar uma conta do Azure OpenAI e implantar modelos de linguagem usando a CLI do Azure:

Use o seguinte comando para criar uma conta do 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>

Use os seguintes comandos para criar as implantações de modelo para text-embedding-ada-002 e gpt-35-turbo-16k em sua instância de serviço do Azure OpenAI:

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

Implantar o Serviço de Assistência no Azure Spring Apps

Use as etapas a seguir para criar, configurar e implantar o aplicativo Assist Service no Azure Spring Apps.

Use o seguinte comando para criar o novo serviço de IA, 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

Use o seguinte comando para configurar o Spring Cloud Gateway com a rota do 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

Use o seguinte comando para recuperar a URL base do ponto de extremidade da API REST para o serviço Azure OpenAI:

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

Use o seguinte comando para recuperar a chave de API primária:

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

Use o seguinte comando para implantar o aplicativo 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

Agora, teste o aplicativo Fitness Store no navegador. Selecione ASK TO FITASSIST para conversar com o aplicativo Assist Service.
No FitAssist, digite Preciso de uma bicicleta para um deslocamento para o trabalho e observe a saída que foi gerada pelo aplicativo Assist Service:

Clean up resources (Limpar recursos)

Se você planeja continuar trabalhando com guias de início rápido e tutoriais subsequentes, convém deixar esses recursos no lugar. Quando não for mais necessário, exclua o grupo de recursos, que exclui os recursos do grupo de recursos. Para excluir o grupo de recursos usando a CLI do Azure, use os seguintes comandos:

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

Próximos passos

Continue para qualquer um dos seguintes inícios rápidos opcionais:

Partilhar via