Guia de início rápido: crie seu primeiro recurso do AI Foundry

Saiba como criar e gerenciar um recurso do AI Foundry. É o principal tipo de recurso para projetar, implantar e gerenciar aplicativos e agentes de IA generativa. Ele fornece acesso ao serviço de agente, modelos que são hospedados usando um modelo de hospedagem sem servidor, avaliações e serviço Azure OpenAI. Este é o tipo de recurso recomendado para a maioria dos aplicativos criados no Azure AI Foundry.

O Azure AI Foundry é a próxima versão e renomeação dos antigos 'Serviços de IA do Azure'. Todos os seus recursos anteriores são suportados, incluindo modelos dos Serviços de IA do Azure para recursos de Fala, Visão e Linguagem. Os novos recursos incluem a API do AI Foundry, que permite acessar o serviço do Agente e as Avaliações, projetos como pastas para organizar seu trabalho e conexões para integração com outros serviços do Azure.

Quer usar o AI Foundry com configurações de segurança avançadas? Veja as opções avançadas de criação do AI Foundry

Pretende utilizar as competências do Azure AI Search? Consulte o recurso multisserviços clássico do Azure AI.

Pré-requisitos

• Uma assinatura válida do Azure - Crie uma gratuitamente.

Criar um novo recurso do Azure AI Foundry

O portal do Azure AI Foundry fornece uma maneira de criar um novo recurso do Azure com configurações básicas e padrão. Se a sua organização necessitar de configurações personalizadas do Azure, como nomes alternativos, controlos de segurança ou etiquetas de custo, poderá ter de utilizar o portal do Azure ou as opções de modelo para estar em conformidade com a conformidade com a Política do Azure da sua organização.

O recurso multisserviço do Azure AI Foundry está listado em AI Foundry>AI Foundry no portal. O tipo de API é AIServices. Procure o logotipo, tal como é mostrado aqui.

Importante

O Azure fornece mais de um tipo de recurso chamado serviços de IA do Azure. Certifique-se de selecionar o que está listado em AI Foundry>AI Foundry com o logotipo, como mostrado anteriormente.

Para criar um recurso AI Foundry, siga estas instruções:

Sugestão

Se você precisar criar um projeto do Foundry ou um recurso de projeto baseado em hub, também poderá usar o portal do Azure Foundry para criar o recurso. Para obter mais informações, consulte os seguintes artigos:

• Crie um projeto do Azure AI Foundry.
• Crie um projeto baseado no hub de IA do Azure.

1. Selecione este link para criar um recurso do AI Foundry : https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

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

   Detalhes do projeto	Descrição
   Subscrição	Selecione uma das suas subscrições do Azure disponíveis.
   Grupo de recursos	O grupo de recursos do Azure que conterá seu recurso do Azure AI Foundry. Você pode criar um novo grupo ou adicioná-lo a um grupo preexistente.
   Região	O local da sua instância de serviço de IA do Azure. Locais diferentes podem introduzir latência, mas não têm impacto na disponibilidade de tempo de execução do seu recurso.
   Nome	Um nome descritivo para seu recurso do Azure AI Foundry. Por exemplo, MyAIServicesResource.

3. Configure outras definições para o seu recurso conforme for necessário, leia e aceite as condições (se aplicável), e depois selecione Rever + criar.

Sugestão

Se sua assinatura não permitir que você crie um recurso do AI 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 peça que os privilégios /register/action sejam concedidos à sua conta.

Limpeza de recursos

Se quiser limpar e remover um recurso do AI Foundry, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

1. No portal do Azure, expanda o menu no lado esquerdo para abrir o menu de serviços e escolha Grupos de Recursos para exibir a lista de seus grupos de recursos.
2. Localize o grupo de recursos que contém o recurso a ser excluído.
3. Se quiser excluir todo o grupo de recursos, selecione o nome do grupo de recursos. Na página seguinte, selecione Excluir grupo de recursos e confirme.
4. Se você quiser excluir apenas o recurso do Azure AI Foundry, selecione o grupo de recursos para ver todos os recursos dentro dele. Na página seguinte, 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 AI Foundry usando comandos da Interface Command-Line do Azure (CLI).

Pré-requisitos

• Uma assinatura válida do Azure - Crie uma gratuitamente.
• Azure CLI

Instalar a CLI do Azure e entrar

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

az login

Criar um novo grupo de recursos

Antes de criar um recurso do AI Foundry, você deve ter um grupo de recursos do Azure para conter o recurso. Ao criar um novo recurso, você pode criar um novo grupo de recursos ou usar um existente. Este artigo mostra como criar um novo grupo de recursos.

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

Importante

• Lembre-se de seu local do Azure, pois você precisará dele ao chamar os recursos do Azure AI Foundry.
• A disponibilidade de alguns serviços de IA do Azure pode variar de acordo com a região. Para obter mais informações, consulte Produtos do Azure por região.

az account list-locations --query "[].{Region:name}" --out table

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

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

Criar um recurso AI Foundry

Para criar e assinar um novo recurso do Azure AI Foundry, use o comando az cognitiveservices account create . Este comando adiciona um novo recurso faturável ao grupo de recursos criado anteriormente. Ao criar seu novo recurso, você precisará saber o tipo de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure.

Importante

O Azure fornece mais de um tipo de recurso para os serviços de IA do Azure. Certifique-se de criar um com o kind de AIServices.

Você pode criar um recurso AI 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

Sugestão

Se sua assinatura não permitir que você crie um recurso do AI 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 peça que os privilégios /register/action sejam concedidos à sua conta.

Obter o uso atual da cota para 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

Limpeza de recursos

Se você quiser limpar e remover um recurso do AI Foundry, você pode excluí-lo ou o grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

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 AI Foundry usando comandos do Azure PowerShell .

Pré-requisitos

• Uma assinatura válida do Azure - Crie uma gratuitamente.
• Azure PowerShell.

Instalar o Azure PowerShell e entrar

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

Connect-AzAccount

Criar um novo grupo de recursos do Azure AI Foundry

Antes de criar um recurso do AI Foundry, você deve ter um grupo de recursos do Azure para conter o recurso. Ao criar um novo recurso, você pode criar um novo grupo de recursos ou usar um existente. Este artigo mostra como criar um novo grupo de recursos.

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

Importante

• Lembre-se de seu local do Azure, pois você precisará dele ao chamar os recursos do Azure AI Foundry.
• A disponibilidade de alguns serviços de IA do Azure pode variar de acordo com a região. Para obter mais informações, consulte Produtos do Azure por região.

Get-AzLocation | Select-Object -Property Location, DisplayName

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

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

Criar um recurso AI Foundry

Para criar e assinar um novo recurso do Azure AI Foundry, use o comando New-AzCognitiveServicesAccount . Este comando adiciona um novo recurso faturável ao grupo de recursos criado anteriormente. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure:

Importante

O Azure fornece mais de um tipo de recurso para os serviços de IA do Azure. Certifique-se de criar um com o Type (tipo) de AIServices.

Você pode criar um recurso AI 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

Sugestão

Se sua assinatura não permitir que você crie um recurso do AI 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 peça que os privilégios /register/action sejam concedidos à sua conta.

Obter o uso atual da cota para seu recurso

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

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

Limpeza de recursos

Se você quiser limpar e remover um recurso do AI Foundry, você pode excluí-lo ou o grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

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

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

Projeto padrão

No AI Foundry, os projetos fornecem acesso a APIs de desenvolvedor e atuam como pastas para organizar seu trabalho. Um projeto padrão é criado para você quando você cria seu recurso no portal do Azure ou no Portal do Azure AI Foundry. O projeto padrão tem um conceito único - ele fornece compatibilidade retroativa com as APIs de programador que são suportadas ao nível do recurso pai. Normalmente, esses são Serviços de IA e APIs do Azure OpenAI para personalização de modelo. As APIs mais recentes, incluindo Agentes e Avaliações, podem ser acessadas a partir de qualquer projeto. Para obter mais informações, consulte Tipos de projetos.

Seu recurso AI Foundry pode ou não estar associado a um projeto AI Foundry:

• Se seus recursos do AI Foundry foram criados usando a CLI do Azure, PowerShell, modelo Bicep, Terraform ou SDKs. Nesses casos, o recurso AI Foundry por padrão não está associado a um projeto. Você pode criar um projeto mais tarde como recurso secundário.
• Se o seu recurso AI Foundry foi criado como uma conexão. Por exemplo, quando você tenta implantar um modelo que não está disponível na região do seu recurso atual do AI Foundry.
• Um projeto pode ser criado no portal do Azure AI Foundry e automaticamente associado como dependente de um novo recurso do AI Foundry.
• Um recurso do AI Foundry pode ter sido criado no portal do AI Foundry, mas como um recurso dependente de um hub do Azure AI Foundry. Nesse caso, o recurso é automaticamente associado ao projeto criado no hub.

Serviços suportados com um recurso AI Foundry

O recurso AI Foundry permite o acesso aos seguintes serviços de IA do Azure com um único conjunto de credenciais. Alguns serviços estão disponíveis através do recurso AI Foundry e do recurso de serviço único.

Sugestão

Recomendamos sempre que possível usar o recurso AI Foundry (onde o tipo de API é AIServices) para acessar vários serviços de IA do Azure com um único conjunto de credenciais. Para serviços não disponíveis por meio do recurso AI Foundry (como Face e Visão Personalizada), você pode, alternativamente, criar um recurso de serviço único.

Serviço	Descrição	Tipo (via API)
Azure AI Foundry Agent Service	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.	AIServices
Inferência de modelo de IA do Azure	Executa a inferência de modelo para modelos emblemáticos no catálogo de modelos do Azure AI Foundry.	AIServices
Azure OpenAI	Execute uma grande variedade de tarefas de linguagem natural.	AIServices OpenAI
Segurança de conteúdo	Um serviço de IA que deteta conteúdos indesejados.	AIServices ContentSafety
Visão Personalizada	Personalize o reconhecimento de imagens para o seu negócio.	CustomVision.Prediction (Apenas previsão) CustomVision.Training (Apenas formação)
Inteligência Documental	Transforme documentos em soluções inteligentes orientadas por dados.	AIServices FormRecognizer
Rosto	Detete e identifique pessoas e emoções em imagens.	Face
Idioma	Crie aplicativos com recursos de compreensão de linguagem natural líderes do setor.	AIServices TextAnalytics
Discurso	Conversão de fala em texto, de texto em fala, tradução e reconhecimento de oradores.	AIServices Speech
Translator	Use a tecnologia de tradução baseada em IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados de extinção.	AIServices TextTranslation
Visão	Analise conteúdo em imagens e vídeos.	AIServices (Formação e Previsão) ComputerVision

Recurso de serviços múltiplos de IA do Azure para capacidades de Pesquisa de IA do Azure

As habilidades do Azure AI Search não dão suporte ao recurso AI Foundry, conforme descrito anteriormente neste artigo. Você deve criar um tipo diferente de recurso multisserviço para as habilidades do Azure AI Search.

O recurso multisserviço que pode usar com as habilidades do Azure AI Search está listado em AI Foundry>nos serviços clássicos de IA>e na conta multisserviço de serviços do Azure AI (clássica) no portal. Procure o logotipo, tal como é mostrado aqui.

Para criar um recurso multisserviço para as habilidades do Azure AI Search, siga estas instruções:

1. Selecione este link para criar um recurso de conta multisserviço (clássico) de serviços de IA do Azure : https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

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

   Detalhes do projeto	Descrição
   Subscrição	Selecione uma das suas subscrições do Azure disponíveis.
   Grupo de recursos	O grupo de recursos do Azure que conterá seu recurso de conta multisserviço de serviços de IA do Azure. Você pode criar um novo grupo ou adicioná-lo a um grupo preexistente.
   Região	O local da sua instância de conta multisserviço de serviços de IA do Azure. Locais diferentes podem introduzir latência, mas não têm impacto na disponibilidade de tempo de execução do seu recurso.
   Nome	Um nome descritivo para o recurso de conta multisserviço dos serviços de IA do Azure. Por exemplo, MyCognitiveServicesResource.
   Nível de preços	O custo da sua conta multisserviço de serviços de IA do Azure depende das opções que escolher e da sua utilização. Para obter mais informações, consulte os detalhes de preços da API .

3. Configure outras definições para o seu recurso conforme for necessário, leia e aceite as condições (se aplicável), e depois selecione Rever + criar.

Sugestão

Se sua assinatura não permitir que você crie um recurso do AI 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 peça que os privilégios /register/action sejam concedidos à sua conta.

Preços

Os níveis de preços (e o valor cobrado) baseiam-se no número de transações que você envia usando suas informações de autenticação. Cada nível de preços especifica:

• Número máximo de transações permitidas por segundo (TPS).
• Funcionalidades do serviço habilitadas na camada de preços.
• Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Conteúdo relacionado

• Vá para a página do hub de serviços de IA do Azure.
• Experimente os serviços de IA no portal do Azure AI Foundry.