Compartilhar via

Início Rápido: Configurar seu primeiro recurso do Foundry

Neste início rápido, você criará um recurso do Microsoft Foundry e verificará o acesso.

Saiba como criar e gerenciar um recurso do Foundry. É o principal tipo de recurso do Azure para criar, implantar e gerenciar modelos e aplicativos de IA generativos, incluindo agentes no Azure.

Um recurso do Azure é necessário para usar e gerenciar serviços no Azure. Ele define o escopo para configurar o acesso, a segurança, como rede, cobrança e monitoramento.

O recurso do Foundry é a próxima versão e a renomeação do antigo "Foundry Tools". Ele fornece o ambiente do aplicativo para hospedar seus agentes, implantações de modelo, avaliações e muito mais.

Um recurso foundry pode organizar o trabalho para vários casos de uso e normalmente é compartilhado entre uma equipe de desenvolvedores que trabalham em casos de uso em um domínio de dados ou de negócios semelhante. Os projetos atuam como pastas para agrupar o trabalho relacionado.

Diagrama mostrando o recurso Foundry que contém vários projetos, cada um com implantações e conexões.

Observação

Somente o projeto padrão está disponível no portal do Foundry (novo). Use o portal do Foundry (clássico) para interagir com todos os outros projetos em um recurso do Foundry.

Procurando definir o Foundry com configurações de segurança avançadas? Consulte as opções avançadas de criação do Foundry

Criar seu primeiro recurso

Para criar seu primeiro recurso, com configurações básicas do Azure, siga as etapas abaixo usando o portal do Azure, a CLI do Azure ou o PowerShell.

Pré-requisitos

  • Uma assinatura válida do Azure; crie uma gratuitamente.
  • Função RBAC do Azure para criar recursos. Você precisa de uma das seguintes funções atribuídas em sua assinatura ou grupo de recursos do Azure:
    • Contributor
    • Proprietário
    • Uma função personalizada com permissão Microsoft.CognitiveServices/accounts/write

Criar um novo recurso do Microsoft Foundry

Se sua organização exigir configurações personalizadas do Azure, como nomes alternativos, controles de segurança ou rótulos de custo, talvez seja necessário usar o portal do Azure ou opções de modelo para atender à conformidade da Azure Policy da sua organização.

O recurso Foundry está listado na Foundry>Foundry no portal do Azure. O tipo de API é AIServices. Procure o logotipo, conforme mostrado aqui:

Captura de tela do recurso Foundry no portal do Azure.

Dica

O portal da Foundry fornece uma maneira de criar um novo recurso do Foundry com configurações básicas, padrão já definidas.

Para criar um recurso do Foundry no portal do Azure, siga estas instruções:

  1. Selecione este link de recursos do Foundry: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. Na página Criar, forneça as seguintes informações:

    Detalhes do projeto Descrição
    Assinatura Selecione uma das suas assinaturas do Azure disponíveis.
    Grupo de recursos O grupo de recursos do Azure que conterá o recurso Foundry. Você pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
    Região A localização da instância da Ferramenta do Foundry. Locais diferentes podem introduzir latência, mas não têm impacto sobre a disponibilidade de runtime do seu recurso.
    Nome Um nome descritivo para o recurso Foundry. Por exemplo, MyAIServicesResource.

  3. Defina as outras configurações do recurso conforme o necessário, leia e aceite as condições (conforme aplicável) e selecione Examinar + criar.

Dica

Se sua assinatura não permitir que você crie um recurso do Foundry, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando o portal do Azure, o comando do PowerShell ou um comando da CLI do Azure. Se você não for o proprietário da assinatura, peça a alguém com a função de Proprietário ou Administrador para concluir o registro para você ou solicite que os privilégios de /register/action sejam concedidos à sua conta.

Limpar os recursos

Se você quiser limpar e remover um recurso do Foundry, poderá excluir o recurso ou o grupo de recursos. Excluir o grupo de recursos também exclui outros recursos contidos nele.

  1. No portal do Azure, expanda o menu à esquerda para abrir o menu de serviços e escolha Grupo de Recursos para exibir a lista dos seus grupos de recursos.
  2. Localize o grupo de recursos que contém o recurso a ser excluído.
  3. Se você quiser excluir o grupo de recursos inteiro, selecione o nome dele. Na próxima página, selecione Excluir grupo de recursos e confirme.
  4. Se você quiser excluir apenas o recurso Foundry, selecione o grupo de recursos para ver todos os recursos dentro dele. Na próxima página, selecione o recurso que deseja excluir, selecione o menu de reticências dessa linha e selecione Excluir.

Use este início rápido para criar um recurso do Foundry usando comandos da CLI (Interface Command-Line) do Azure .

Pré-requisitos

  • Uma assinatura válida do Azure: crie uma gratuitamente.
  • A CLI do Azure versão 2.0 ou posterior.
  • Função RBAC do Azure para criar recursos. Você precisa de uma das seguintes funções atribuídas em sua assinatura ou grupo de recursos do Azure:
    • Contributor
    • Proprietário
    • Uma função personalizada com permissão Microsoft.CognitiveServices/accounts/write

Instalar a CLI do Azure e entrar

Instale a CLI do Azure. Para entrar em sua instalação local da CLI, execute o comando az login:

az login

Criar um novo grupo de recursos

Antes de criar um recurso do Foundry, você deve ter um grupo de recursos do Azure para conter o recurso. Quando você cria um novo recurso, tem a opção de criar um grupo de recursos ou usar um existente. Este artigo mostra como criar um grupo de recursos.

Para criar um recurso, você precisará de um dos locais do Azure disponíveis para a sua assinatura. Você pode obter uma lista de locais disponíveis com o comando az account list-locations. A maioria das Ferramentas de Foundry pode ser acessada de vários locais. Escolha o mais próximo a você ou veja quais locais estão disponíveis para o serviço.

Importante

  • Lembre-se da localização do Azure, pois você precisará dele ao chamar os recursos do Microsoft Foundry.
  • A disponibilidade de algumas Ferramentas de Fundição pode variar de acordo com a região. Para obter mais informações, confira Produtos do Azure por região.
az account list-locations --query "[].{Region:name}" --out table

Depois de ter o local do Azure, crie um grupo de recursos na CLI do Azure usando o comando az group create. No exemplo a seguir, substitua o local do Azure westus2 por um dos locais do Azure disponíveis para a sua assinatura.

az group create --name ai-services-resource-group --location westus2

Criar um recurso do Foundry

Para criar e assinar um novo recurso do Foundry, use o comando az cognitiveservices account create . Esse comando adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você criou anteriormente. Ao criar seu novo recurso, você precisará saber o tipo de serviço que deseja usar, juntamente com seu tipo de preço (ou SKU) e um local do Azure.

Importante

Azure fornece vários tipos de recursos para Foundry Tools. Certifique-se de criar um com o kind de AIServices.

Você pode criar um recurso do Foundry nomeado foundry-multi-service-resource com o comando abaixo.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Dica

Se sua assinatura não permitir que você crie um recurso do Foundry, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando o portal do Azure, o comando do PowerShell ou um comando da CLI do Azure. Se você não for o proprietário da assinatura, peça a alguém com a função de Proprietário ou Administrador para concluir o registro para você ou solicite que os privilégios de /register/action sejam concedidos à sua conta.

Obter o uso atual de cota para o seu recurso

Use o comando az cognitiveservices account list-usage para obter o uso do seu recurso.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Limpar os recursos

Se você quiser limpar e remover um recurso do Foundry, poderá excluí-lo ou o grupo de recursos. Excluir o grupo de recursos também exclui outros recursos contidos nele.

Para remover o grupo de recursos e seus recursos associados, use o az group delete command.

az group delete --name ai-services-resource-group

Use este início rápido para criar um recurso do Foundry usando comandos do Azure PowerShell .

Pré-requisitos

  • Uma assinatura válida do Azure: crie uma gratuitamente.
  • Azure PowerShell versão 5.0 ou posterior.
  • Função RBAC do Azure para criar recursos. Você precisa de uma das seguintes funções atribuídas em sua assinatura ou grupo de recursos do Azure:
    • Contributor
    • Proprietário
    • Uma função personalizada com permissão Microsoft.CognitiveServices/accounts/write

Instale o Azure PowerShell e entre

Instale o Azure PowerShell. Para entrar, execute o comando Connect-AzAccount :

Connect-AzAccount

Criar um novo grupo de recursos do Microsoft Foundry

Antes de criar um recurso do Foundry, você deve ter um grupo de recursos do Azure para conter o recurso. Quando você cria um novo recurso, tem a opção de criar um grupo de recursos ou usar um existente. Este artigo mostra como criar um grupo de recursos.

Para criar um recurso, você precisará de um dos locais do Azure disponíveis para a sua assinatura. Você pode recuperar uma lista de locais disponíveis com o comando Get-AzLocation. A maioria das Ferramentas de Foundry pode ser acessada de vários locais. Escolha o mais próximo a você ou veja quais locais estão disponíveis para o serviço.

Importante

  • Lembre-se do local do Azure, pois você precisará dele ao chamar os recursos do Foundry.
  • A disponibilidade de algumas Ferramentas de Fundição pode variar de acordo com a região. Para obter mais informações, confira Produtos do Azure por região.
Get-AzLocation | Select-Object -Property Location, DisplayName

Depois de ter o local do Azure, crie um novo grupo de recursos no Azure PowerShell usando o comando New-AzResourceGroup. No exemplo a seguir, substitua o local do Azure westus2 por um dos locais do Azure disponíveis para a sua assinatura.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Criar um recurso do Foundry

Para criar e assinar um novo recurso do Foundry, use o comando New-AzCognitiveServicesAccount . Esse comando adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você criou anteriormente. Ao criar o recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado e um local do Azure:

Importante

Azure fornece vários tipos de recursos para Foundry Tools. Certifique-se de criar um com o Type (tipo) de AIServices.

Você pode criar um recurso do Foundry nomeado foundry-multi-service-resource com o comando abaixo.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Dica

Se sua assinatura não permitir que você crie um recurso do Foundry, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando o portal do Azure, o comando do PowerShell ou um comando da CLI do Azure. Se você não for o proprietário da assinatura, peça a alguém com a função de Proprietário ou Administrador para concluir o registro para você ou solicite que os privilégios de /register/action sejam concedidos à sua conta.

Obter o uso atual de cota para o seu recurso

Use o comando Get-AzCognitiveServicesAccountUsage para obter o uso para seu recurso.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Limpar os recursos

Se você quiser limpar e remover um recurso do Foundry, poderá excluí-lo ou o grupo de recursos. Excluir o grupo de recursos também exclui outros recursos contidos nele.

Para remover o grupo de recursos e os recursos associados, use o comando Remove-AzResourceGroup.

Remove-AzResourceGroup -Name ai-services-resource-group

Acessar seu recurso

Com seu primeiro recurso criado, você pode acessá-lo por meio do portal do Foundry para criação de protótipos de UX, SDK do Foundry para desenvolvimento ou por meio do portal do Azure para gerenciamento administrativo.

Verificar sua configuração

Você pode verificar se o recurso está configurado corretamente usando o SDK de Projetos de IA do Azure para se conectar e listar projetos. Este exemplo mínimo confirma a autenticação e o acesso.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Saída esperada: Successfully connected. Found X projects. em que X é o número de projetos em seu recurso.

Referências:

Conceder ou obter permissões de desenvolvedor

O RBAC (Controle de Acesso Baseado em Função) do Azure diferencia permissões entre ações de gerenciamento e desenvolvimento. Para compilar com o Foundry, sua conta de usuário deve receber permissões de desenvolvedor ("ações de dados"). Você pode usar uma das funções internas do RBAC ou usar uma função RBAC personalizada.

As funções internas de desenvolvedor do RBAC do Azure para Foundry incluem:

Função Descrição
Gerenciador de Projetos de IA do Azure Concede permissões de desenvolvimento e permissões de gerenciamento de projeto. Pode convidar outros usuários para colaborar em um projeto como 'Usuário de IA do Azure'.
Usuário de IA do Azure Concede permissões de desenvolvimento.
Proprietário da conta de IA do Azure Concede acesso total para gerenciar projetos e contas de IA. Pode convidar outros usuários para colaborar em um projeto como 'Usuário de IA do Azure'.
Proprietário da IA do Azure Concede acesso total a projetos e contas de IA gerenciados e cria e desenvolve com projetos.

Observação

A função Proprietário de IA do Azure estará disponível para atribuir no portal do Azure e do Foundry em breve.

Diagrama das funções internas no Foundry.

Para empresas maiores com requisitos estritos de acesso baseado em função, recomendamos utilizar a função de Usuário da IA do Azure com as permissões de desenvolvedor de privilégios mínimos. Para empresas menores que desejam que seus desenvolvedores se autoatendirem dentro de sua organização, recomendamos utilizar a função de Proprietário de IA do Azure para permissões de desenvolvedor, bem como permissões de criação de recursos.

Somente usuários autorizados, normalmente a assinatura do Azure ou o proprietário do grupo de recursos, podem atribuir uma função por meio do [portal do Azure](link para o portal do Azure) ou [Portal do Foundry por meio do Admin](Link para o portal do Foundry). Saiba mais sobre o controle de acesso baseado em função.

Importante

As funções de Proprietário e Colaborador do Azure incluem apenas permissões de gerenciamento e não permissões de desenvolvimento. As permissões de desenvolvimento são necessárias para construir com todas as capacidades no Foundry.

Comence a construir no seu primeiro projeto

Com as permissões configuradas, agora você está pronto para começar a criar o Foundry. No portal do Foundry, abra ou crie seu primeiro projeto. Os projetos organizam o trabalho de personalização do agente e do modelo no Foundry e você pode criar vários no mesmo recurso.

Explore alguns dos serviços que vêm agrupados com seu recurso:

Serviço Descrição
Ícone da Foundry Serviço do Foundry Agent Combine o poder dos modelos de IA generativa com ferramentas que permitem que os agentes acessem e interajam com fontes de dados do mundo real.
Ícone da Foundry Inferência de Modelo do Azure Executa a inferência de modelo para modelos principais no catálogo de modelos do Foundry.
Ícone do Azure OpenAI em Foundry Models Azure OpenAI Execute uma ampla variedade de tarefas de linguagem natural.
Ícone da Segurança do conteúdo Segurança de Conteúdo Uma Ferramenta de Fundição que detecta conteúdo indesejado.
Ícone da Inteligência de Documentos Inteligência de Documentos Transforme documentos em soluções inteligentes baseadas em dados.
Ícone da Linguagem Linguagem Criar aplicativos com recursos líderes do setor de reconhecimento de linguagem natural.
Ícone de Fala Fala Conversão de fala em texto, conversão de texto em fala, tradução e reconhecimento de locutor.
Ícone do Tradutor Tradutor Use tecnologia de tradução com tecnologia de IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados.

Próximas etapas

  • Last updated on