Como criar e gerenciar um hub do Azure AI Foundry

No portal do Azure AI Foundry, os hubs fornecem o ambiente para uma equipe colaborar e organizar o trabalho e ajudá-lo como um líder de equipe ou administrador de TI a definir centralmente as configurações de segurança e controlar o uso e os gastos. Você pode criar e gerenciar um hub no portal do Azure ou no portal do Azure AI Foundry e, em seguida, seus desenvolvedores podem criar projetos a partir do hub.

Neste artigo, você aprenderá a criar e gerenciar um hub no portal do Azure AI Foundry com as configurações padrão para que você possa começar rapidamente. Você precisa personalizar a segurança ou os recursos dependentes do hub? Em seguida, use o Portal do Azure ou as opções de modelo.

Dica

Se você for um desenvolvedor individual e não um administrador, um líder de desenvolvimento ou parte de um esforço maior que exija um hub, você poderá criar um projeto diretamente do portal do Azure AI Foundry sem criar um hub primeiro. Para saber mais, confira Criar um projeto.

Se você for um administrador ou líder de desenvolvimento e gostaria de criar seu hub do Azure AI Foundry usando um modelo, confira os artigos sobre como usar o Bicep ou o Terraform.

Criar um hub no portal do Azure AI Foundry

Para criar um novo hub, você precisa da função Proprietário ou Colaborador no grupo de recursos ou em um hub existente. Se você não conseguir criar um hub devido a permissões, entre em contato com o administrador. Se sua organização estiver usando Azure Policy, não crie o recurso no portal do Azure AI Foundry. Em vez disso, crie o hub no portal do Azure.

Observação

Um hub no portal do Azure AI Foundry é um local único onde você gerencia tudo o que seu projeto de IA precisa, como segurança e recursos, para que você possa desenvolver e testar mais rapidamente. Para saber mais sobre como os hubs podem ajudá-lo, consulte o artigo de Visão geral de hubs e projetos.

Para criar um hub no Azure AI Foundry, siga estas etapas:

1. Acesse o Azure AI Foundry e entre com sua conta do Azure.

2. Se você ainda não estiver em um projeto, selecione um. Não importa qual é selecionado. Se você não tem projetos, primeiro crie um selecionando + Criar projeto na parte superior da página.

3. Selecione o Centro de gerenciamento no menu esquerdo.

   

4. Selecione Todos os recursos, a seta para baixo ao lado de + Novo projeto e selecione + Novo hub.

   

5. Na caixa de diálogo Criar um hub, insira um nome para o hub (como hub contoso) e modifique os outros campos conforme desejado. Por padrão, uma conexão dos serviços de IA é criada para o hub.

   

   Observação

   Se você não vir (novo) antes das entradas Grupo de recursos e Conectar Serviços de IA do Azure, então um recurso existente está sendo usado. Para fins deste tutorial, crie uma entidade separada por meio de Criar grupo de recursos e Criar novos Serviços de IA. Isso permitirá que você evite cobranças inesperadas ao excluir as entidades após o tutorial.

6. Selecione Avançar, revise as informações e selecione Criar.

   

7. Você pode exibir o progresso da criação do hub no assistente.

   

Criar um hub seguro no portal do Azure

Se sua organização estiver usando Azure Policy, configure um hub que atenda aos requisitos da sua organização em vez de usar o Azure AI Foundry para criação de recursos.

1. No portal do Azure, pesquise Azure AI Foundry e crie um novo hub selecionando + Novo hub de IA do Azure.

2. Insira o nome do hub, a assinatura, o grupo de recursos e os detalhes do local.

3. Para modelos base dos serviços de IA do Azure, selecione um recurso de serviços de IA existente ou crie um novo. Os serviços de IA do Azure incluem vários pontos de extremidade de API para Fala, Segurança de Conteúdo e OpenAI do Azure.

   

4. Selecione a guia Armazenamento para especificar as configurações da conta de armazenamento. Para armazenar credenciais, forneça seu Azure Key Vault ou use o repositório de credenciais gerenciado pela Microsoft (versão prévia).

   

5. Selecione a guia Rede para configurar o Isolamento de rede. Leia mais sobre isolamento de rede. Para obter um passo a passo da criação de um hub seguro, consulte Criar um hub seguro.

   

6. Selecione a guia Criptografia para configurar a criptografia de dados. Por padrão, chaves gerenciadas pela Microsoft são usadas para criptografar dados. Você pode selecionar Criptografar dados usando uma chave gerenciada pelo cliente.

   

7. Selecione a guia Identidade. Por padrão, a Identidade atribuída pelo sistema está habilitada, mas você pode alternar para Identidade atribuída pelo usuário se o armazenamento, o cofre de chaves e o registro de contêiner existentes estiverem selecionados em Armazenamento. Você também pode selecionar se deseja usar o acesso Baseado em credencial ou Baseado em identidade à conta de armazenamento.

   

   Observação

   Se você selecionar Identidade atribuída pelo usuário, sua identidade precisará ter a função Cognitive Services Contributor para criar um novo hub com sucesso.

8. Selecione a guia Marcas para adicionar marcas.

   

9. Selecione Examinar + criar>Criar.

Gerenciar seu hub no portal do Azure

Gerenciar o controle de acesso

Você pode adicionar e remover usuários do centro de gerenciamento do portal do Azure AI Foundry. Tanto o hub quanto os projetos no hub têm uma entrada Usuários no menu esquerdo que permite adicionar e remover usuários. Ao adicionar usuários, você pode atribuir a eles funções internas.

Para atribuições de função personalizada, use o Controle de acesso (IAM) no portal do Azure. Saiba mais sobre o controle de acesso baseado em função do hub.

Para adicionar permissões de usuário no portal do Azure:

1. Selecione + Adicionar para adicionar usuários ao hub.

2. Selecione a Função que você deseja atribuir.

   

3. Selecione os Membros aos quais você deseja atribuir a função.

   

4. Examinar + atribuir. Pode demorar até uma hora para que as permissões sejam aplicadas a usuários.

Rede

As configurações de rede do hub podem ser definidas durante a criação do recurso ou alteradas no guia Rede no modo de exibição do portal do Azure. A criação de um novo hub invoca uma Rede Virtual Gerenciada. Isso simplifica e automatiza a configuração do isolamento de rede com uma Rede Virtual Gerenciada interna. As configurações de Rede Virtual Gerenciada são aplicadas a todos os projetos criados em um hub.

Na criação do hub, selecione entre os modos de isolamento de rede: Público, Privado com Saída pela Internet e Privado com Saída Aprovada. Para proteger seu recurso, selecione Privado com Saída para a Internet ou Privado com Saída Aprovada para suas necessidades de rede. Para os modos de isolamento privado, um ponto de extremidade privado deve ser criado para acesso de entrada. Para obter mais informações sobre o isolamento de rede, veja Isolamento de rede virtual gerenciado. Para criar um hub seguro, consulte Criar um hub seguro.

Na criação do hub no portal do Azure, será fornecida a criação de serviços de IA do Azure associados, conta de armazenamento, cofre de chaves (opcional), insights de aplicativo (opcional) e registro de contêiner (opcional). Esses recursos são encontrados na guia Recursos durante a criação.

Para se conectar aos serviços de IA do Azure (OpenAI do Azure, Pesquisa de IA do Azure e Segurança de Conteúdo de IA do Azure) ou a contas de armazenamento no portal do Azure AI Foundry, crie um ponto de extremidade privado em sua rede virtual. Certifique-se de que o sinalizador de acesso à rede pública (PNA) esteja desabilitado ao criar a conexão de ponto de extremidade privado. Para obter mais informações sobre conexões de serviços de IA do Azure, siga a documentação encontrada aqui. Você pode trazer a própria pesquisa (BYO), mas isso exige uma conexão de ponto de extremidade privado de sua rede virtual.

Criptografia

Projetos que usam o mesmo hub, compartilham a configuração de criptografia. O modo de criptografia só pode ser definido no momento da criação do hub entre chaves gerenciadas pela Microsoft e chaves gerenciadas pelo cliente.

Na exibição do portal do Azure, navegue até a guia criptografia para encontrar as configurações de criptografia do hub. Para hubs que usam o modo de criptografia CMK, você poderá atualizar a chave de criptografia para uma nova versão de chave. Essa operação de atualização é restrita a chaves e versões de chave na mesma instância do Key Vault que a chave original.

Atualizar o Azure Application Insights e o Registro de Contêiner do Azure

Para usar ambientes personalizados para o Prompt Flow, você precisa configurar um Registro de Contêiner do Azure para seu hub. Para usar o Azure Application Insights para implantações de Prompt Flow, é necessário um recurso configurado do Azure Application Insights para o hub. Atualizar o Registro de Contêiner do Azure anexado ao workspace ou o recurso ApplicationInsights pode quebrar a linhagem de trabalhos anteriores, os pontos de extremidade de inferência implantados ou sua capacidade de executar novamente trabalhos anteriores no workspace.

Você pode usar o portal do Azure, as opções do SDK/CLI do Azure ou os modelos de infraestrutura como código para atualizar o Azure Application Insights e o Registro de Contêiner do Azure para o hub.

Portal do Azure

Você poderá configurar o hub para esses recursos durante a criação ou atualização após a criação.

Para atualizar o Azure Application Insights do portal do Azure, navegue até as Propriedades do hub no portal do Azure e selecione Alterar o Application Insights.

SDK do Python

from azure.ai.ml.entities import Hub

my_app_insights = "{APPLICATION_INSIGHTS_ARM_ID}"
my_container_registry = "{CONTAINER_REGISTRY_ARM_ID}"

# construct a basic hub
my_hub = Hub(name="myexamplehub", 
             location="East US", 
             application_insights=my_app_insights,
             container_registry=my_container_registry)

# update_dependent_resources is used to give consent to update the workspace dependent resources.
created_hub = ml_client.workspaces.begin_update(workspace=my_hub, update_dependent_resources=True).result()

CLI do Azure

Confira a documentação do sinalizador para az ml workspace update

az ml workspace update -n "myexamplehub" -g "{MY_RESOURCE_GROUP}" -a "APPLICATION_INSIGHTS_ARM_ID" -u

Escolha como as credenciais serão armazenadas

Selecione cenários no portal do Azure AI Foundry armazenando credenciais em seu nome. Por exemplo, quando você cria uma conexão no portal do Azure AI Foundry para acessar uma conta de Armazenamento do Azure com chave de conta armazenada, acesse o Registro de Contêiner do Azure com senha de administrador ou quando criar uma instância de computação com chaves SSH habilitadas. Nenhuma credencial é armazenada com conexões quando você escolhe a autenticação baseada em identidade do Microsoft Entra ID.

Você pode escolher onde as credenciais serão armazenadas:

• Seu Azure Key Vault: isso exige que você gerencie sua própria instância do Azure Key Vault e configure-a por hub. Ele fornece controle adicional sobre o ciclo de vida dos segredos, por exemplo, para definir políticas de expiração. Você também pode compartilhar segredos armazenados com outros aplicativos no Azure.

• Armazenamento de credenciais gerenciado pela Microsoft (versão prévia): nesta variante, a Microsoft gerencia uma instância do Azure Key Vault em seu nome por hub. Nenhum gerenciamento de recurso é necessário da sua parte e o cofre não aparece na sua assinatura do Azure. O ciclo de vida de dados do segredo segue o ciclo de vida de recursos dos seus hubs e projetos. Por exemplo, quando a conexão de armazenamento de um projeto é excluída, seu segredo armazenado também é excluído.

Depois que o hub é criado, não é possível alternar entre o Azure Key Vault e o uso de um repositório de credenciais gerenciado pela Microsoft.

Excluir um hub do Azure AI Foundry

Para excluir um hub do Azure AI Foundry, selecione o hub e, em seguida, selecione Excluir hub na seção Propriedades do hub da página.

Observação

Você também pode excluir o hub do portal do Azure.

Excluir um hub exclui todos os projetos associados. Quando um projeto é excluído, todos os pontos de extremidade aninhados para o projeto também são excluídos. Opcionalmente, você pode excluir os recursos conectados. No entanto, verifique se nenhum outro aplicativo está usando essa conexão. Por exemplo, outra implantação do Azure AI Foundry pode estar usando-o.

Conteúdo relacionado

• Criar um projeto
• Saiba mais sobre o Azure AI Foundry
• Saiba mais sobre os hubs