Criar e implantar um recurso do Azure OpenAI no Microsoft Foundry Models

Pré-requisitos

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

Criar um recurso

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

Identificar o recurso

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

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

   

3. Na página Criar Azure OpenAI, forneça as seguintes informações para os campos na guia Informações básicas:

   Campo	Descrição
   Subscrição	A assinatura do Azure usada no aplicativo de integração do Serviço OpenAI do Azure.
   Grupo de recursos	O grupo de recursos do Azure para conter o recurso do OpenAI do Azure. Você pode criar um novo grupo ou usar um grupo já existente.
   Região	O local de sua instância. Locais diferentes podem introduzir latência, mas não afetam a disponibilidade de tempo de execução do seu recurso.
   Nome	Um nome descritivo para o recurso do Azure OpenAI, como MyOpenAIResource.
   Tipo de preço	O nível 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 do OpenAI do Azure

   

4. Selecione Próximo.

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, configure a segurança de rede para seu recurso de Foundry Tools.
• Opção 3: Desabilitado, nenhuma rede pode acessar esse recurso. Você pode configurar conexões de ponto de extremidade privadas que serão a forma exclusiva de acessar esse recurso.

Dependendo da opção selecionada, pode ser 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 apenas redes específicas

A segunda opção permite que você identifique redes específicas que podem acessar seu recurso. Ao selecionar essa opção, a página é atualizada para incluir os seguintes campos obrigatórios:

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

Opção 3: Desabilitar acesso à rede

A terceira opção permite que você desabilite o acesso da rede ao seu recurso. Quando você seleciona essa opção, a página é atualizada para incluir a tabela de ponto de extremidade privado.

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

Confirme a configuração e crie o recurso

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

2. Selecione Avançar para passar para a etapa final do processo: Revisar + enviar.

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

4. O portal do Azure exibe uma notificação quando o novo recurso está disponível. Selecione e acesse 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. Certifique-se de que o botão New Foundry está desativado. Estas etapas referem-se à Fábrica (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, pode ser oferecida a opção de atualizar o recurso do 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 obter uma lista de modelos disponíveis por região, veja tabela Resumo de modelos e disponibilidade por região.

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 no seu código para chamar o modelo usando as bibliotecas do cliente e as APIs REST.
   Tipo de implantação	Padrão, Global-Batch, Global-Standard, Provisionado-Gerenciado. 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 seu 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 houver capacidade extra disponível.

   Importante

   Ao acessar o modelo pela API, você precisa consultar o nome da implantação em vez do nome do modelo subjacente nas chamadas à API, que é uma das principais diferenças entre o OpenAI e o Azure OpenAI. O OpenAI requer apenas o nome do modelo. O 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. Em última análise, os nomes de suas implantações 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 da sua nova implantação. Quando a implantação é concluída, o estado de provisionamento do modelo muda para Concluído.

Pré-requisitos

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

Fazer logon na CLI do Azure

Entre na CLI do Azure ou selecione Abrir Cloudshell nas etapas a seguir.

Criar um grupo de recursos do Azure

Para criar um recurso do Azure OpenAI, você precisa de um grupo de recursos do Azure. Ao criar um novo recurso por meio da CLI do Azure, você também pode criar um novo grupo de recursos ou instruir o Azure a usar um grupo existente. O exemplo a seguir mostra como criar um novo grupo de recursos chamado OAIResourceGroup com o comando az criar grupo. 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 criar conta para criar um recurso do Azure OpenAI no grupo de recursos. No exemplo a seguir, você cria um recurso chamado MyOpenAIResource no grupo de recursos OAIResourceGroup. Ao testar 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 do 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

Depois de criar o recurso, você pode usar comandos diferentes para encontrar informações úteis sobre o Azure OpenAI na instância do 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. Nesse exemplo, direcionamos a saída do comando através do processador JSON jq para localizar o valor .properties.endpoint.

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

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

Obtenha a chave primária da API

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

Ao testar 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 modelo gpt-4o e dá a ela o nome MyModel. Ao testar 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 ou sku-capacity, e 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, GlobalStandard, e ProvisionedManaged. Saiba mais sobre as opções de tipo de implantação.

Excluir um modelo de seu recurso

Você pode excluir modelos implantados do recurso com o comando az cognitiveservices account deployment delete. No exemplo a seguir, você exclui um modelo chamado MyModel. Ao testar 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 excluir conta.

Se você não for continuar a usar os recursos criados nesses exercícios, execute o seguinte comando para excluir seu grupo de recursos. Certifique-se de atualizar 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 do Azure. Crie um gratuitamente.
• PowerShell do Azure. Para obter mais informações, veja Como instalar o Azure PowerShell.
• Permissões de acesso para criar recursos do Azure OpenAI e implantar modelos.

Entre no Azure PowerShell

Entre no Azure PowerShell ou selecione Abrir Cloudshell nas etapas a seguir.

Criar um grupo de recursos do Azure

Para criar um recurso do Azure OpenAI, você precisa de um grupo de recursos do Azure. Ao criar um novo recurso por meio do Azure PowerShell, você também pode criar um novo grupo de recursos ou instruir o 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 do Azure OpenAI no grupo de recursos. No exemplo a seguir, você cria um recurso chamado MyOpenAIResource no grupo de recursos OAIResourceGroup. Ao testar 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 do Azure <subscriptionID>.

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

Recuperar informações sobre o recurso

Depois de criar o recurso, você pode usar comandos diferentes para encontrar informações úteis sobre o Azure OpenAI na instância do 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. Nesse exemplo, direcionamos a saída do comando por meio do cmdlet Select-Object para localizar o valor endpoint.

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

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

Obtenha a chave primária da API

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

Ao testar 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 modelo gpt-4o e dá a ela o nome MyModel. Ao testar 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 ou sku-capacity, e 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 propriedade Name da variável $sku 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 de seu recurso

Você pode excluir qualquer modelo implantado do seu recurso com o comando Remove-AzCognitiveServicesAccountDeployment. No exemplo a seguir, você exclui um modelo chamado MyModel. Ao testar 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 quiser limpar após esses exercícios, você pode remover seu recurso do Azure OpenAI excluindo o recurso por meio do Azure PowerShell. 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 for continuar a usar os recursos criados nesses exercícios, execute o seguinte comando para excluir seu grupo de recursos. Certifique-se de atualizar o código de exemplo para usar seus valores para o grupo de recursos e o recurso.

Remove-AzCognitiveServicesAccount -Name MyOpenAIResource -ResourceGroupName OAIResourceGroup