Crie e gerencie sessões de computação de prompt flow no portal Microsoft Foundry (clássico)

Aplica-se somente a:Portal Foundry (clássico). Este artigo não está disponível para o novo portal do Foundry. Saiba mais sobre o novo portal.

Você precisa de uma sessão de computação para executar fluxos de prompt. Use Microsoft Foundry para criar e gerenciar sessões de computação de fluxo de prompt.

Uma sessão de computação de fluxo de comandos possui os recursos de computação necessários para que o aplicativo seja executado, incluindo uma imagem Docker que contém todos os pacotes de dependências necessários. Além da execução de fluxo, o Foundry usa a sessão de computação para garantir a precisão e a funcionalidade das ferramentas incorporadas no fluxo ao fazer atualizações no conteúdo do prompt ou do código.

Pré-requisitos

• Uma conta Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta de Azure free, que inclui uma assinatura de avaliação gratuita.
• Se você não tiver um, crie um projeto baseado em hub.

Criar uma sessão de computação

Ao iniciar uma sessão de computação, você pode usar as configurações padrão ou personalizar as configurações avançadas.

Iniciar uma sessão de computação com configurações padrão

Por padrão, a sessão de computação usa o ambiente definido na flow.dag.yamlpasta de fluxo. Ele é executado em uma computação sem servidor com um tamanho de VM (máquina virtual) para o qual você tem cota suficiente em seu workspace.

1. Acesse seu projeto no portal do Foundry.
2. No painel esquerdo, selecione Fluxo de prompt e, em seguida, selecione o fluxo que você deseja executar.
3. Na barra de ferramentas superior do fluxo de prompt, selecione Iniciar sessão de computação.

Iniciar uma sessão de computação com configurações avançadas

Nas configurações avançadas, você pode selecionar o tipo de computação. Você pode escolher entre a computação sem servidor e a instância de computação.

1. Acesse seu projeto no portal do Foundry.

2. No painel esquerdo, selecione Fluxo de prompt e, em seguida, selecione o fluxo que você deseja executar.

3. Na barra de ferramentas superior do prompt flow, selecione a seta suspensa no lado direito do botão Iniciar sessão de computação. Selecione Iniciar com configurações avançadas para personalizar a sessão de computação.

   

   Você pode escolher entre a computação sem servidor e a instância de computação.

   • Se você escolher a computação sem servidor, poderá definir as seguintes configurações:

     • Personalize o tamanho da VM que a sessão de computação usa.
     • Personalize o tempo ocioso, que salva o código excluindo a sessão de computação automaticamente se ela não estiver em uso.
     • Defina a identidade gerenciada atribuída pelo usuário. A sessão de computação usa essa identidade para fazer o download de uma imagem base e instalar pacotes. Verifique se a identidade gerenciada atribuída pelo usuário tem permissão de pull no Registro de Contêiner do Azure.

     Se você não definir a identidade atribuída pelo usuário, o fluxo de prompt usará a identidade do usuário por padrão. Saiba mais sobre como criar e atualizar identidades atribuídas pelo usuário para um workspace.

     

   • Se você escolher a instância de computação, só poderá definir o tempo de desligamento ocioso.

     • Como essa é uma instância de computação existente, o tamanho da VM é fixo e não pode ser alterado em um lado da sessão de computação.

     • A identidade usada para essa sessão de computação também é definida na instância de computação, por padrão, ela usa a identidade do usuário. Saiba mais sobre como atribuir identidade à instância de computação

     • O tempo de desligamento ocioso é usado para definir o ciclo de vida da sessão de computação. Se a sessão de computação estiver ociosa pelo tempo definido, ela será excluída automaticamente. Se você tiver o desligamento ocioso habilitado em uma instância de computação, ele será desligado, mas não será excluído.

       

4. Selecione Avançar para especificar as configurações de imagem base. Use a imagem base padrão ou forneça uma imagem base personalizada. Se você escolher uma imagem base personalizada, forneça a URL da imagem e a marca de imagem. Há suporte apenas para imagens em um registro do Docker público ou no ACR (Registro de Contêiner do Azure). Se você especificar uma imagem no ACR, verifique se você (ou a identidade de gerenciamento atribuída pelo usuário) tem permissão de pull do ACR.

5. Selecione Avançar para examinar suas configurações.

6. Selecione Aplicar e iniciar a sessão de computação para iniciar a sessão de computação.

Gerenciar uma sessão de computação

Para gerenciar uma sessão de computação, selecione a sessão de computação em execução na barra de ferramentas superior da página de fluxo:

• Alterar as configurações de sessão de computação abre a página de configuração da sessão de computação, na qual você pode definir o lado da VM e o tempo ocioso para a sessão de computação.
• Instalar pacotes de requirements.txt Abre requirements.txt na interface do usuário do prompt flow para que você possa adicionar pacotes.
• Exibir pacotes instalados mostra os pacotes instalados na sessão de computação. Ele inclui os pacotes inseridos na imagem base e os pacotes especificados no arquivo requirements.txt na pasta flow.
• Redefinir a sessão de computação exclui a sessão de computação atual e cria uma nova com o mesmo ambiente. Se você encontrar um conflito de pacotes, poderá experimentar essa opção.
• Parar a sessão de computação exclui a sessão de computação atual. Se não houver nenhuma sessão de computação ativa em uma computação sem servidor subjacente, o recurso de computação também será excluído. Se a sessão de computação estiver em uma instância de computação, parar a sessão permitirá que a instância fique ociosa.

Você pode personalizar o ambiente usado para executar esse fluxo adicionando pacotes no requirements.txt arquivo na pasta de fluxo. Depois de adicionar mais pacotes neste arquivo, escolha uma destas opções:

• Salve e instale gatilhos pip install -r requirements.txt na pasta de fluxo. O processo pode levar alguns minutos, dependendo dos pacotes instalados.
• Salvar apenas salva o requirements.txt arquivo. Você pode instalar os pacotes mais tarde por conta própria.

Adicionar pacotes em um feed privado no Azure DevOps

Se você quiser usar um feed privado no Azure DevOps, siga estas etapas:

1. Crie uma identidade gerenciada atribuída pelo usuário e adicione essa identidade na organização Azure DevOps. Para mais informações, veja Principais de serviço e identidades gerenciadas.

   Nota

   Se o botão Adicionar Usuários não estiver visível, você provavelmente não terá as permissões necessárias para executar essa ação.

2. Adicione ou atualize identidades atribuídas pelo usuário ao seu projeto.

3. Adicione {private} à URL do feed privado. Por exemplo, se você quiser instalar test_package de test_feed em Azure DevOps, adicione -i https://{private}@{test_feed_url_in_azure_devops} em requirements.txt:

   -i https://{private}@{test_feed_url_in_azure_devops}
   test_package
   

4. Especifique a identidade gerenciada atribuída pelo usuário em Iniciar com configurações avançadas se a sessão de computação não estiver em execução ou use o botão Editar se a sessão de computação estiver em execução.

   

Alterar a imagem base

Por padrão, usamos a imagem de fluxo de prompt mais recente como a imagem base. Se você quiser usar uma imagem base diferente, precisará criar sua própria imagem base. A imagem do docker deve ser criada a partir da imagem base do fluxo de prompt. mcr.microsoft.com/azureml/promptflow/promptflow-runtime:<newest_version> Se possível, use a versão mais recente da imagem base.

1. Abra o fluxo de prompt.

2. Na barra de ferramentas superior, selecione o modo de arquivo Bruto para habilitar a edição no editor de arquivos.

3. Abra a seção Arquivos e selecione flow.dag.yaml.

   

4. Especifique sua imagem na environment seção do flow.dag.yaml arquivo. Por exemplo, para usar a imagem <your-custom-image>, adicione o seguinte código:

   environment:
       image: <your-custom-image>
       python_requirements_txt: requirements.txt
   

Atualizar o runtime da instância de computação

Se você criou anteriormente um runtime de instância de computação, alterne-o para uma sessão de computação usando as seguintes etapas:

• Prepare o arquivo requirements.txt na pasta 'flow'. Para obter mais informações, consulte Gerenciar uma sessão de computação.

• Se você criou um ambiente personalizado, obtenha a imagem da página de detalhes do ambiente e especifique-a no arquivo flow.dag.yaml na pasta 'flow'. Para saber mais, confira Alterar a imagem base. Verifique se você tem acr pull permissão para a imagem.

• Você pode continuar a usar a instância de computação existente se quiser gerenciar manualmente o ciclo de vida.

Recursos relacionados

• Saiba mais sobre o prompt flow
• Desenvolver um fluxo
• Desenvolver um fluxo de avaliação