Criar e implantar um Azure OpenAI no recurso Microsoft Foundry Models (clássico)

Pré-requisitos

• Uma assinatura Azure. Crie um gratuitamente.
• Permissões de acesso para criar recursos Azure OpenAI e implantar modelos.

Criar um recurso

As etapas a seguir mostram como criar um recurso Azure OpenAI no portal do Azure.

Identificar o recurso

1. Entre com sua assinatura Azure no portal do Azure.

2. Selecione Criar um recurso e pesquisar o Azure OpenAI. Ao localizar o serviço, selecione Criar.

   

3. Na página Create Azure OpenAI, forneça as seguintes informações para os campos na guia Basics:

   Campo	Descrição
   Assinatura	A assinatura Azure utilizada em seu aplicativo de entrada do Azure OpenAI.
   Grupo de recursos	O grupo de recursos do Azure para conter seu recurso Azure OpenAI. Você pode criar um novo grupo ou usar um grupo pré-existente.
   Região	O local de sua instância. Locais diferentes podem introduzir latência, mas não afetam a disponibilidade de runtime do recurso.
   Nome	Um nome descritivo para o recurso Azure OpenAI, como MyOpenAIResource.
   Tipo de preço	A camada de preço do recurso. Atualmente, somente a camada Standard está disponível para o Azure OpenAI. Para obter mais informações sobre preços, visite a página de preços Azure OpenAI

   

4. Selecione Avançar.

Configurar a segurança de rede

A guia Rede apresenta três opções para o tipo de segurança:

• Opção 1: todas as redes, incluindo a Internet, podem acessar esse recurso.
• Opção 2: Redes selecionadas, configurar a segurança de rede para o recurso Foundry Tools.
• Opção 3: Desabilitada, nenhuma rede pode acessar esse recurso. Você pode configurar conexões de ponto de extremidade privado que serão a maneira exclusiva de acessar esse recurso.

Dependendo da opção selecionada, talvez seja necessário fornecer informações adicionais.

Opção 1: Permitir todas as redes

A primeira opção permite que todas as redes, incluindo a Internet, acessem seu recurso. Essa opção é a configuração padrão. Nenhuma configuração extra é necessária para essa opção.

Opção 2: permitir somente redes específicas

A segunda opção permite identificar redes específicas que podem acessar seu recurso. Quando você seleciona essa opção, a página é atualizada para incluir os seguintes campos necessários:

A seção Firewall fornece um campo de intervalo de endereços opcional que você pode usar para definir as configurações de firewall para o recurso.

Opção 3: Desabilitar o acesso à rede

A terceira opção permite desabilitar o acesso à rede ao recurso. Quando você seleciona essa opção, a página é atualizada para incluir a tabela de Private endpoint.

Como opção, você pode adicionar um ponto de extremidade privado para acesso ao seu recurso. Selecione Adicionar ponto de extremidade privado e conclua a configuração do ponto de extremidade.

Confirmar a configuração e criar o recurso

1. Selecione Avançar e configure quaisquer Tags para o seu recurso, conforme desejado.

2. Selecione Avançar para ir para o estágio final no processo: Examinar + enviar.

3. Confirme as configurações e selecione Criar.

4. O portal Azure exibe uma notificação quando o novo recurso está disponível. Selecione Ir para o recurso.

   

Implantar um modelo

Antes de gerar texto ou inferência, você precisa implantar um modelo. Você pode selecionar um dos vários modelos disponíveis no portal do Foundry.

Para implantar um modelo, siga estas etapas:

1. Entre no Microsoft Foundry. Verifique se a opção New Foundry está desativada. Essas etapas referem-se ao Foundry (clássico).

   

2. Na seção Continuar compilando com o Foundry , selecione Exibir todos os recursos.

3. Localize e selecione seu recurso.

   Importante

   Nesta etapa, você pode ter a opção de atualizar seu recurso Azure OpenAI para o Foundry. Confira a comparação entre os dois tipos de recurso e os detalhes sobre a atualização e a reversão de recursos nesta página. Selecione Cancelar para continuar sem a atualização do tipo de recurso. Como alternativa, selecione Avançar.

   Consulte informações adicionais sobre o recurso Foundry neste artigo.

4. Selecione Implantações na seção Recursos Compartilhados no painel esquerdo. (Caso você tenha atualizado para o Foundry na etapa anterior, selecione Modelos + pontos de extremidade da seção Meus ativos no painel esquerdo.)

5. Selecione + Implantar modelo>Implantar modelo base para abrir a janela de implantação.

6. Selecione o modelo desejado e selecione Confirmar. Para ver uma lista de modelos disponíveis por região, consulte Disponibilidade por região dos Modelos do Foundry vendidos pelo Azure.

7. Na próxima janela, configure os seguintes campos:

   Campo	Descrição
   Nome da implantação	Escolha um nome com cuidado. O nome da implantação é usado em seu código para chamar o modelo usando as bibliotecas de cliente e as APIs REST.
   Tipo de implantação	Standard, Global-Batch, Global-Standard, Provisioned-Managed. Saiba mais sobre as opções de tipo de implantação.
   Detalhes da implantação (opcional)	Você pode definir configurações avançadas opcionais, conforme necessário para o recurso. - Para o Filtro de Conteúdo, atribua um filtro de conteúdo à sua implantação. – Para o Limite de Taxa de Tokens por Minuto, ajuste os Tokens por Minuto (TPM) para definir o limite de taxa efetivo para sua implantação. Você pode modificar esse valor a qualquer momento usando o menu Cotas . A Cota Dinâmica permite que você aproveite mais cota quando a capacidade extra estiver disponível.

   Importante

   Ao acessar o modelo por meio da API, você precisa se referir ao nome da implantação em vez do nome do modelo subjacente em chamadas à API, que é uma das diferenças chave entre o OpenAI e Azure OpenAI. O OpenAI requer apenas o nome do modelo. Azure OpenAI sempre requer o nome da implantação, mesmo ao usar o parâmetro de modelo. Em nossa documentação, geralmente temos exemplos em que os nomes de implantação são representados como idênticos aos nomes de modelo para ajudar a indicar qual modelo funciona com um ponto de extremidade de API específico. Por fim, seus nomes de implantação podem seguir qualquer convenção de nomenclatura que seja melhor para seu caso de uso.

8. Selecione Implantar.

9. Detalhes da Implantação mostram todas as informações sobre sua nova implantação. Quando a implantação for concluída, o estado de provisionamento do modelo será alterado para Bem-sucedido.

Pré-requisitos

• Uma assinatura Azure. Crie um gratuitamente.
• Permissões de acesso para criar recursos Azure OpenAI e implantar modelos.
• CLI do Azure Para obter mais informações, consulte Como instalar o CLI do Azure.

Entre no CLI do Azure

Sign in no CLI do Azure ou selecione Open Cloudshell nas etapas a seguir.

Criar um grupo de recursos Azure

Para criar um recurso Azure OpenAI, você precisa de um grupo de recursos Azure. Ao criar um novo recurso por meio do CLI do Azure, você também pode criar um novo grupo de recursos ou instruir Azure a usar um grupo existente. O exemplo a seguir mostra como criar um novo grupo de recursos chamado OAIResourceGroup com o comando az group create . O grupo de recursos é criado na localização leste dos EUA.

az group create \
--name OAIResourceGroup \
--location eastus

Criar um recurso

Use o comando az cognitiveservices account create para criar um recurso Azure OpenAI no grupo de recursos. No exemplo a seguir, você cria um recurso chamado MyOpenAIResource no grupo de recursos OAIResourceGroup . Ao experimentar o exemplo, atualize o código para usar os valores desejados para o grupo de recursos e o nome do recurso, juntamente com sua ID de assinatura Azure <subscriptionID>.

az cognitiveservices account create \
--name MyOpenAIResource \
--resource-group OAIResourceGroup \
--location eastus \
--kind OpenAI \
--sku s0 \
--subscription <subscriptionID>
--custom-domain MyOpenAIResource
--yes

Recuperar informações sobre o recurso

Após criar o recurso, você pode usar diferentes comandos para encontrar informações úteis sobre sua instância do Azure OpenAI no Microsoft Foundry Models. Os exemplos a seguir demonstram como recuperar a URL base do ponto de extremidade da API REST e as chaves de acesso para o novo recurso.

Obter a URL do ponto de extremidade

Use o comando az cognitiveservices account show para recuperar a URL base do ponto de extremidade da API REST para o recurso. Neste exemplo, direcionamos a saída do comando por meio do processador JSON jq para localizar o .properties.endpoint valor.

Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo <de recursos myResourceGroupName> e o recurso <myResourceName>.

az cognitiveservices account show \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
| jq -r .properties.endpoint

Obter a chave de API primária

Para recuperar as chaves de acesso para o recurso, use o comando de lista de chaves de conta az cognitiveservices . Neste exemplo, direcionamos a saída do comando por meio do processador JSON jq para localizar o .key1 valor.

Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos e o recurso.

az cognitiveservices account keys list \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
| jq -r .key1

Implantar um modelo

Para implantar um modelo, use o comando az cognitiveservices account deployment create. No exemplo a seguir, você implanta uma instância do gpt-4o modelo e dá-lhe o nome MyModel. Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos e o recurso. Você não precisa alterar os valores model-version, model-format, sku-capacity ou sku-name.

az cognitiveservices account deployment create \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
--deployment-name MyModel \
--model-name gpt-4o \
--model-version "2024-11-20"  \
--model-format OpenAI \
--sku-capacity "1" \
--sku-name "Standard"

--sku-name aceita os seguintes tipos de implantação: Standard, GlobalBatch, GlobalStandarde ProvisionedManaged. Saiba mais sobre as opções de tipo de implantação.

Excluir um modelo do seu recurso

Você pode excluir qualquer modelo implantado do seu recurso com o comando az cognitiveservices account deployment delete. No exemplo a seguir, você exclui um modelo chamado MyModel. Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos, o recurso e o modelo implantado.

az cognitiveservices account deployment delete \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
--deployment-name MyModel

Excluir um recurso

Se quiser limpar após esses exercícios, você pode remover seu recurso do Azure OpenAI excluindo o recurso por meio do CLI do Azure. Você também pode excluir o grupo de recursos. Se você optar por excluir o grupo de recursos, todos os recursos contidos no grupo também serão excluídos.

Para remover o grupo de recursos e seus recursos associados, use o comando az cognitiveservices account delete .

Se você não quiser continuar a usar os recursos criados nesses exercícios, execute o comando a seguir para excluir o grupo de recursos. Atualize o código de exemplo para usar seus valores para o grupo de recursos e o recurso.

az cognitiveservices account delete \
--name <myResourceName> \
--resource-group  <myResourceGroupName>

Pré-requisitos

• Uma assinatura Azure. Crie um gratuitamente.
• Azure PowerShell. Para obter mais informações, consulte Como instalar o Azure PowerShell.
• Permissões de acesso para criar recursos Azure OpenAI e implantar modelos.

Entre no Azure PowerShell

Sign in para Azure PowerShell ou selecione Open Cloudshell nas etapas a seguir.

Criar um grupo de recursos Azure

Para criar um recurso Azure OpenAI, você precisa de um grupo de recursos Azure. Ao criar um novo recurso por meio de Azure PowerShell, você também pode criar um novo grupo de recursos ou instruir Azure a usar um grupo existente. O exemplo a seguir mostra como criar um novo grupo de recursos chamado OAIResourceGroup com o comando New-AzResourceGroup . O grupo de recursos é criado na localização leste dos EUA.

New-AzResourceGroup -Name OAIResourceGroup -Location eastus

Criar um recurso

Use o comando New-AzCognitiveServicesAccount para criar um recurso Azure OpenAI no grupo de recursos. No exemplo a seguir, você cria um recurso chamado MyOpenAIResource no grupo de recursos OAIResourceGroup . Ao experimentar o exemplo, atualize o código para usar os valores desejados para o grupo de recursos e o nome do recurso, juntamente com sua ID de assinatura Azure <subscriptionID>.

New-AzCognitiveServicesAccount -ResourceGroupName OAIResourceGroup -Name MyOpenAIResource -Type OpenAI -SkuName S0 -Location eastus

Recuperar informações sobre o recurso

Após criar o recurso, você pode usar diferentes comandos para encontrar informações úteis sobre sua instância do Azure OpenAI no Microsoft Foundry Models. Os exemplos a seguir demonstram como recuperar a URL base do ponto de extremidade da API REST e as chaves de acesso para o novo recurso.

Obter a URL do ponto de extremidade

Use o comando Get-AzCognitiveServicesAccount para recuperar a URL base do ponto de extremidade da API REST para o recurso. Neste exemplo, direcionamos a saída do comando por meio do cmdlet Select-Object para localizar o endpoint valor.

Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo <myResourceGroupName> de recursos e o recurso <myResourceName>.

Get-AzCognitiveServicesAccount -ResourceGroupName OAIResourceGroup -Name MyOpenAIResource |
  Select-Object -Property endpoint

Obter a chave de API primária

Para recuperar as chaves de acesso do recurso, use o comando Get-AzCognitiveServicesAccountKey . Neste exemplo, direcionamos a saída do comando por meio do cmdlet Select-Object para localizar o Key1 valor.

Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos e o recurso.

Get-AzCognitiveServicesAccountKey -Name MyOpenAIResource -ResourceGroupName OAIResourceGroup |
  Select-Object -Property Key1

Implantar um modelo

Para implantar um modelo, use o comando New-AzCognitiveServicesAccountDeployment . No exemplo a seguir, você implanta uma instância do gpt-4o modelo e dá-lhe o nome MyModel. Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos e o recurso. Você não precisa alterar os valores model-version, model-format, sku-capacity ou sku-name.

$model = New-Object -TypeName 'Microsoft.Azure.Management.CognitiveServices.Models.DeploymentModel' -Property @{
    Name = 'gpt-4o'
    Version = '2024-11-20'
    Format = 'OpenAI'
}

$properties = New-Object -TypeName 'Microsoft.Azure.Management.CognitiveServices.Models.DeploymentProperties' -Property @{
    Model = $model
}

$sku = New-Object -TypeName "Microsoft.Azure.Management.CognitiveServices.Models.Sku" -Property @{
    Name = 'Standard'
    Capacity = '1'
}

New-AzCognitiveServicesAccountDeployment -ResourceGroupName OAIResourceGroup -AccountName MyOpenAIResource -Name MyModel -Properties $properties -Sku $sku

A Name propriedade da $sku variável aceita os seguintes tipos de implantação: Standard, GlobalBatch, GlobalStandard, e ProvisionedManaged. Saiba mais sobre as opções de tipo de implantação.

Excluir um modelo do seu recurso

Você pode excluir qualquer modelo implantado do recurso com o comando Remove-AzCognitiveServicesAccountDeployment . No exemplo a seguir, você exclui um modelo chamado MyModel. Ao experimentar o exemplo, atualize o código para usar seus valores para o grupo de recursos, o recurso e o modelo implantado.

Remove-AzCognitiveServicesAccountDeployment -ResourceGroupName OAIResourceGroup -AccountName MyOpenAIResource -Name MyModel

Excluir um recurso

Se você quiser fazer uma limpeza após esses exercícios, poderá remover o recurso Azure OpenAI usando o Azure PowerShell para excluí-lo. Você também pode excluir o grupo de recursos. Se você optar por excluir o grupo de recursos, todos os recursos contidos no grupo também serão excluídos.

Para remover o grupo de recursos e seus recursos associados, use o comando Remove-AzCognitiveServicesAccount .

Se você não quiser continuar a usar os recursos criados nesses exercícios, execute o comando a seguir para excluir o grupo de recursos. Atualize o código de exemplo para usar seus valores para o grupo de recursos e o recurso.

Remove-AzCognitiveServicesAccount -Name MyOpenAIResource -ResourceGroupName OAIResourceGroup