Tutorial: Implantar um aplicativo Web de chat corporativo (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.

Neste artigo, você implantará um aplicativo Web de chat corporativo que usa seus dados com um modelo de linguagem grande no portal do Microsoft Foundry.

Sua fonte de dados fundamenta o modelo com dados específicos. Fundamentação significa que o modelo usa seus dados para entender o contexto de sua pergunta. Você não altera o próprio modelo implantado. Seus dados permanecem separados e seguros na fonte de dados original.

As etapas neste tutorial são:

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.

• Um modelo de chat do Azure OpenAI implantado. Conclua o Início rápido do playground do Foundry para criar esse recurso caso você não tiver um.

• Uma conexão de serviço de pesquisa para indexar os dados de produto de exemplo. Se você não tiver um, siga as etapas para criar e conectar um serviço de pesquisa.

• Uma cópia local dos dados do produto. O repositório Azure-Samples/rag-data-openai-python-promptflow no GitHub tem informações de produto de varejo de exemplo para este cenário de tutorial. O product_info_11.md arquivo contém informações do produto sobre os sapatos de trilha TrailWalker para este exemplo de tutorial. Carrege os dados de produto de varejo da Contoso Trek de exemplo em um arquivo ZIP para seu computador local.

• Um Microsoft.Web provedor de recursos registrado na assinatura selecionada para que você possa implantar em uma aplicação web. Para obter mais informações sobre como registrar um provedor de recursos, consulte Registrar provedor de recursos.

• Permissões necessárias para adicionar atribuições de função em sua assinatura Azure. Somente o Proprietário dos recursos de Azure específicos pode conceder permissões por atribuição de função.

Portal de Foundry e Portal do Azure

Neste tutorial, você executará algumas tarefas no portal do Foundry e algumas tarefas no portal do Azure.

O portal do Foundry é um ambiente baseado na Web para criar, treinar e implantar modelos de IA. Como desenvolvedor, é onde você cria e implanta seu aplicativo Web de chat.

O portal Azure permite que um administrador gerencie e monitore Azure recursos. Como administrador, você usa o portal para definir configurações para diferentes serviços de Azure necessários para acesso do aplicativo Web.

Configurar recursos

Para fazer com que os recursos funcionem corretamente em um aplicativo Web, configure as permissões corretas no portal do Azure.

Primeiro, identifique os recursos necessários para configurar no portal do Foundry.

1. Abra o portal Foundry e selecione o projeto baseado em hub usado para implantar o modelo de chat do Azure OpenAI.

2. Selecione o Centro de Gerenciamento no painel esquerdo.

3. Selecione Recursos conectados em seu projeto.

4. Identifique os três recursos que você precisa configurar: o Azure OpenAI, o Pesquisa de IA do Azure  e o armazenamento de Blobs Azure que corresponde ao workspaceblobstore.

   

   Dica

   Se você não vir o Tipo na tabela, selecione Colunas no canto superior direito e adicione ou reordene as colunas selecionadas. Se você tiver vários recursos Azure OpenAI, use aquele que contém o modelo de chat implantado.

5. Pesquise cada um desses nomes no Azure portal. Abra cada um deles em uma nova guia do navegador para que você possa alternar entre eles.

6. Quando terminar, você terá três novas guias do navegador abertas: serviço Pesquisa, Foundry e Contêiner de blobstore. Mantenha todas as três guias abertas, pois será necessário alternar entre elas para configurar os recursos.

Habilitar identidade gerenciada

Na guia navegador do recurso Search no portal Azure, habilite a identidade gerenciada:

1. No painel esquerdo, em Configurações, selecione Identidade.
2. Alterne o Status para Ativado.
3. Selecione Salvar.

Na guia navegador do recurso Foundry no portal Azure, habilite a identidade gerenciada:

1. No painel esquerdo, em Gerenciamento de Recursos, selecione Identidade.
2. Alterne o Status para Ativado.
3. Selecione Salvar.

Definir o controle de acesso para pesquisa

Na guia navegador do recurso Search service no portal Azure, defina a política de acesso à API:

1. No painel esquerdo, em Configurações, selecione Chaves.
2. No controle acesso à API, selecione Ambos.
3. Quando solicitado, selecione Sim para confirmar.

Atribuir funções

Repita esse padrão para cada recurso nas etapas abaixo.

O padrão geral para atribuir RBAC (controle de acesso baseado em função) para qualquer recurso é:

1. Navegue até o portal Azure para o recurso especificado.
2. Na página à esquerda no portal do Azure, selecione Access control (IAM).
3. Selecione + Adicionar>atribuição de função.
4. Pesquise a função que você precisa atribuir e selecione-a. Em seguida, selecione Avançar.
5. Ao atribuir uma função a si mesmo:
   1. Selecione Usuário, grupo ou entidade de serviço.
   2. Selecione Selecionar membros.
   3. Pesquise seu nome e selecione-o.
6. Ao atribuir uma função a outro recurso:
   1. Selecione Identidade gerenciada.
   2. Selecione Selecionar membros.
   3. Use a lista suspensa para localizar o tipo de recurso que você deseja atribuir. Por exemplo, Foundry Tools ou serviço Pesquisa.
   4. Selecione o recurso na lista exibida. Pode haver apenas um, mas você ainda precisa selecioná-lo.
7. Continue por meio do assistente de configuração e selecione Revisar + atribuir para adicionar a atribuição de função.

Use estas etapas para atribuir funções para os recursos que você configurou neste tutorial:

• Atribua essas funções na guia navegador para o serviço Search no portal Azure:

  • Leitor de Dados do Índice de Pesquisa para a identidade gerenciada do Foundry
  • Contribuidor do Serviço de Pesquisa para a identidade gerenciada da Foundry
  • Colaborador para você mesmo (para localizar Colaborador, alterne para a guia Funções de Administrador com Privilégios na parte superior. Todas as outras funções estão na guia Funções de Trabalho.)

• Atribua essas funções na guia navegador para Foundry no portal Azure:

  • Colaborador do OpenAI de Serviços Cognitivos para a identidade gerenciada do serviço Pesquisa
  • Colaborador para você mesmo.

• Atribua essas funções na aba do navegador para Azure Blob Storage no portal do Azure:

  • Colaborador de dados de blob de armazenamento para a identidade gerenciada do Foundry
  • Leitor de Dados do Blob de Armazenamento para a identidade gerenciada do serviço Pesquisa
  • Colaborador para você mesmo

Você terminou de configurar recursos. Você pode fechar as guias do navegador do portal do Azure agora, se desejar.

Adicione seus dados e tente o modelo de chat novamente

No início rápido do playground da Fábrica (que é um pré-requisito para este tutorial), você pode observar como o seu modelo responde sem os seus dados. Adicione seus dados ao modelo para que ele possa responder perguntas sobre seus produtos.

Para concluir esta seção, você precisa de uma cópia local dos dados do produto. O repositório Azure-Samples/rag-data-openai-python-promptflow no GitHub contém informações de produto de varejo de exemplo relevantes para este cenário de tutorial. Especificamente, o product_info_11.md arquivo contém informações do produto sobre os sapatos de caminhada TrailWalker relevantes para este exemplo de tutorial. Carrege os dados de produto de varejo da Contoso Trek de exemplo em um arquivo ZIP para seu computador local.

Siga estas etapas para adicionar seus dados no playground de chat para ajudar o assistente a responder perguntas sobre seus produtos. Você não está alterando o próprio modelo implantado. Seus dados são armazenados separadamente e com segurança em sua assinatura Azure.

1. Acesse seu projeto em Microsoft Foundry.

2. Selecione Playgrounds no painel esquerdo.

3. Selecione Experimente o playground de chat.

4. Selecione o modelo de chat implantado na lista suspensa Implantação.

   

5. No lado esquerdo do playground de chat, selecione Adicionar seus dados>+ Adicionar uma nova fonte de dados.

   

6. Na lista suspensa Fonte de dados , selecione Carregar arquivos.

   

7. Selecione Carregar>Carregar arquivos para navegar por seus arquivos locais.

8. Selecione os arquivos que você deseja carregar. Selecione os arquivos de dados do produto que você baixou ou criou anteriormente. Adicione todos os arquivos agora. Você não poderá adicionar mais arquivos mais tarde na mesma sessão do playground.

9. Selecione Upload para carregar o arquivo em sua conta de armazenamento de Blobs Azure. Em seguida, selecione Avançar.

   

10. Selecione seu serviço Pesquisa de IA do Azure .

11. Para o nome do índice vetor, insira informações sobre o produto e selecione Avançar.

12. Na página Configurações de Pesquisa, sob Configurações Vetoriais, desmarque a caixa de seleção Adicionar pesquisa vetorial a este recurso de pesquisa. Essa configuração ajuda a determinar como o modelo responde às solicitações. Em seguida, selecione Avançar.

    Nota

    Se você adicionar pesquisa de vetor, mais opções estarão disponíveis aqui por um custo adicional.

13. Examine suas configurações e selecione Criar índice de vetor.

14. No playground, você pode ver que a ingestão de dados está em andamento. Esse processo pode levar vários minutos. Antes de continuar, aguarde até ver a fonte de dados e o nome do índice no lugar do status.

    

15. Agora você pode conversar com o modelo fazendo a mesma pergunta de antes ("Quanto são os sapatos de caminhada TrailWalker"), e desta vez ele usa informações de seus dados para construir a resposta. Você pode expandir o botão de referências para ver os dados que foram usados.

Implantar seu aplicativo Web

Quando estiver satisfeito com a experiência no portal do Foundry, implante o modelo como um aplicativo Web autônomo.

Localizar seu grupo de recursos no portal Azure

Neste tutorial, implante seu aplicativo Web no mesmo grupo de recursos que o hub do Foundry. Você configurará a autenticação para o aplicativo Web no portal do Azure.

Siga estas etapas para acessar o grupo de recursos no portal do Azure:

1. Vá para o seu projeto no Foundry. Selecione o Centro de Gerenciamento no painel esquerdo.

2. No título Project, selecione Overview.

3. Selecione o nome do grupo de recursos para abrir o grupo de recursos no portal do Azure. Neste exemplo, o grupo de recursos é nomeado rg-sdg-ai.

   

4. Agora você está no portal Azure, exibindo o conteúdo do grupo de recursos em que implantou o hub. Observe o nome e o local do grupo de recursos. Você usará essas informações na próxima seção.

5. Mantenha esta página aberta em uma guia do navegador. Você retornará a ele mais tarde.

Implantar o aplicativo Web

A publicação cria um Serviço de Aplicativo do Azure na sua assinatura. Você pode incorrer em custos dependendo do plano de preços selecionado. Quando terminar de usar seu aplicativo, exclua-o do portal do Azure.

Para implantar o aplicativo Web:

1. Conclua as etapas na seção anterior para adicionar seus dados ao playground. Você pode implantar um aplicativo Web com ou sem seus próprios dados, mas precisa de um modelo implantado, conforme descrito no início rápido do Foundry Playground.

2. Selecione Implantar > ... como um aplicativo Web.

   

3. Na página Implantar em um aplicativo Web , insira os seguintes detalhes:

   • Nome: um nome exclusivo para seu aplicativo Web.
   • Subscription: sua assinatura Azure. Se você não vir nenhuma assinatura disponível, primeiro registre Microsoft.Web como um provedor de recursos.
   • Grupo de recursos: selecione um grupo de recursos no qual implantar o aplicativo Web. Use o mesmo grupo de recursos que o hub.
   • Local: selecione um local no qual implantar o aplicativo Web. Use o mesmo local que o hub.
   • Plano de preços: escolha um plano de preços para o aplicativo Web.
   • Habilitar o histórico de chat no aplicativo Web: para o tutorial, a caixa de histórico de chat não está selecionada. Se você habilitar o recurso, os usuários terão acesso a suas consultas e respostas individuais anteriores. Para obter mais informações, consulte comentários sobre o histórico de chat.

4. Selecione Implantar.

5. Aguarde a implantação do aplicativo. Esse processo pode levar alguns minutos.

6. Quando estiver pronto, o botão Iniciar estará habilitado na barra de ferramentas. Não inicie o aplicativo ainda e não feche a página do chat playground. Você retornará a ele mais tarde.

Configurar a autenticação de aplicativo Web

Por padrão, somente você pode acessar o aplicativo Web. Neste tutorial, adicione autenticação para restringir o acesso aos membros do locatário Azure. Os usuários entrarão com sua conta Microsoft Entra para acessar seu aplicativo. Você pode seguir um processo semelhante para adicionar outro provedor de identidade, se preferir. O aplicativo usa apenas as informações de entrada do usuário para verificar se ele é membro do seu locatário.

1. Retorne à guia do navegador com o portal do Azure ou abra o Azure portal em uma nova guia do navegador. Exiba o conteúdo do grupo de recursos em que você implantou o aplicativo Web. Talvez seja necessário atualizar a exibição para ver o aplicativo Web.

2. Selecione o recurso do Serviço de Aplicativo na lista de recursos no grupo de recursos.

3. No menu esquerdo recolhível em Configurações, selecione Autenticação.

   

4. Se Microsoft estiver listado como um provedor de identidade nesta página, nada mais é necessário. Você pode ignorar a próxima etapa.

5. Adicione um provedor de identidade com as seguintes configurações:

   • Identity provider: selecione Microsoft como o provedor de identidade. As configurações padrão nesta página restringem o aplicativo somente ao seu locatário, portanto, você não precisa alterar mais nada aqui.
   • Tipo de locatário: Força de trabalho
   • Registro de aplicativo: criar um novo registro de aplicativo
   • Nome: o nome do serviço de aplicativo Web
   • Tipos de conta com suporte: inquilino atual – inquilino único
   • Restringir o acesso: requer autenticação
   • Solicitações não autenticadas: HTTP 302 Found - redirecionamento recomendado para sites

Usar o aplicativo Web

Você está quase lá. Agora você pode testar o aplicativo Web.

1. Se você alterou as configurações, aguarde cerca de 10 minutos para que as configurações de autenticação entrem em vigor.

2. Retorne à guia do navegador com a página do chat playground no portal da Fábrica.

3. Selecione Iniciar para abrir o aplicativo Web implantado. Se solicitado, aceite a solicitação de permissões.

4. Se você não vir Iniciar no ambiente de teste, no painel à esquerda, selecione Aplicativos Web e depois selecione seu aplicativo na lista para abri-lo.

   Se as configurações de autenticação ainda não estiverem ativas, feche a guia do navegador do aplicativo Web e retorne ao playground de chat no portal do Foundry. Espere um pouco mais e tente novamente.

5. Em seu aplicativo Web, faça a mesma pergunta de antes ("Quanto são os sapatos de caminhada do TrailWalker"). Desta vez, o aplicativo usa informações de seus dados para construir a resposta. Expanda o botão de referência para ver os dados usados.

   

Entender o histórico de chat

Com o recurso de histórico de chat, os usuários podem ver suas consultas e respostas anteriores.

Habilite o histórico de chat ao implantar o aplicativo Web. Selecione a caixa de seleção Habilitar histórico de chat no aplicativo web.

Depois de habilitar o histórico de chat, os usuários poderão mostrá-lo ou ocultá-lo no canto superior direito do aplicativo. Quando o histórico é mostrado, eles podem renomear ou excluir conversas. À medida que estão conectados ao aplicativo, as conversas são ordenadas das mais novas para as mais antigas e nomeadas com base na primeira consulta da conversa.

Se você excluir o recurso do Cosmos DB, mas manter a opção de histórico de chat habilitada no estúdio, os usuários verão um erro de conexão, mas poderão continuar usando o aplicativo Web sem histórico de chat.

Atualizar o aplicativo Web

Use o playground para adicionar mais dados ou testar o modelo com cenários diferentes. Quando estiver pronto para atualizar o aplicativo Web com o novo modelo, selecione Implantar > ... como um aplicativo Web novamente. Selecione Atualizar um aplicativo Web existente e escolha o aplicativo Web existente na lista. O novo modelo é implantado no aplicativo Web existente.

Limpar recursos

Para evitar custos desnecessários de Azure, exclua os recursos criados neste início rápido se você não precisar deles. Gerenciar recursos no portal Azure.

Conteúdo relacionado

• Introdução à criação de um aplicativo de chat
• Construa um aplicativo de chat personalizado com o SDK de IA do Azure