Tutorial: Implantar um aplicativo Web de bate-papo corporativo

Neste artigo, implementa uma aplicação web de chat empresarial que utiliza os seus dados com um grande modelo de linguagem no portal 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 da sua pergunta. Você não altera o modelo implantado em si. Seus dados permanecem separados e seguros em sua fonte de dados original.

As etapas neste tutorial são:

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta gratuita do Azure, 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. Termina o Início rápido do Foundry playground para criar este recurso caso não tenha um.

• Uma conexão de serviço de Pesquisa para indexar os dados do 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 exemplos de informações de produtos de varejo para este cenário tutorial. O product_info_11.md arquivo tem informações do produto sobre os sapatos de caminhada TrailWalker para este exemplo tutorial. Baixe o exemplo de dados do produto de varejo Contoso Trek em um arquivo ZIP para sua máquina local.

• Um provedor de recursos Microsoft.Web registrado na assinatura selecionada para que você possa implantar em um aplicativo 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 do Azure. Somente o proprietário dos recursos específicos do Azure pode conceder permissões por atribuição de função.

Foundry portal e Azure portal

Neste tutorial, realizas algumas tarefas no portal Foundry e outras no portal Azure.

O portal Foundry é um ambiente web para construir, treinar e implementar modelos de IA. Como desenvolvedor, é onde você cria e implanta seu aplicativo Web de bate-papo.

O portal do Azure permite que um administrador gerencie e monitore os recursos do Azure. Como administrador, você usa o portal para configurar configurações para diferentes serviços do Azure necessários para acesso a partir 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 que precisa de configurar no portal da Foundry.

1. Abra o portal Foundry e selecione o projeto baseado no hub que usou para implementar o modelo de chat Azure OpenAI.

2. Selecione 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 Azure AI Search e o armazenamento de Blob do Azure que corresponde ao seu workspaceblobstore.

   

   Sugestão

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

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

6. Quando terminares, terás três separadores do navegador abertos: Serviço de Pesquisa, Foundry e Blobstore Container. Mantenha as três guias abertas porque você alterna entre elas para configurar os recursos.

Ativar a identidade gerida

Na guia do navegador para o recurso de serviço de Pesquisa no portal do Azure, habilite a identidade gerenciada:

1. No painel esquerdo, em Definições, selecione Identidade.
2. Alterne o status para Ativado.
3. Selecione Guardar.

No separador do navegador para o recurso Foundry no portal Azure, ativa a identidade gerida:

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

Definir controle de acesso para pesquisa

Na guia do navegador para o recurso de serviço de Pesquisa no portal do Azure, defina a política de acesso à API:

1. No painel esquerdo, em Configurações, selecione Chaves.
2. Em Controle de 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 controle de acesso baseado em função (RBAC) para qualquer recurso é:

1. Navegue até o portal do Azure para o recurso fornecido.
2. Na página à esquerda no portal do Azure, selecione Controle de acesso (IAM).
3. Selecione + Adicionar>Adicionar atribuição de função.
4. Procure a função que precisa de atribuir e selecione-a. Em seguida, selecione Seguinte.
5. Ao atribuir uma função a si mesmo:
   1. Selecione Usuário, grupo ou entidade de serviço.
   2. Selecione Selecionar membros.
   3. Procure o 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 de pesquisa.
   4. Selecione o recurso na lista exibida. Pode haver apenas um, mas você ainda precisa selecioná-lo.
7. Continue pelo assistente e selecione Revisar + atribuir para adicionar a atribuição de função.

Use estas etapas para atribuir funções aos recursos configurados neste tutorial:

• Atribua estas funções na guia do navegador para o serviço de Pesquisa no portal do Azure:

  • Índice de Pesquisa do Leitor de Dados para a identidade gerida da Foundry
  • Contribuidor do Serviço de Pesquisa para a identidade gerida da Foundry
  • Colaborador para si mesmo (para encontrar Colaborador, alterne para a guia Funções de administrador privilegiadas na parte superior. Todas as outras funções estão na guia Funções de função de trabalho.)

• Atribua estas funções no separador Foundry do navegador no portal Azure.

  • Serviços Cognitivos OpenAI Contributor para a identidade gerenciada do serviço de Pesquisa
  • Contribuinte para si mesmo.

• Atribua estas funções na guia do navegador para o armazenamento de Blob do Azure no portal do Azure:

  • Contribuidor de Dados de Blob de Armazenamento para a identidade gerida da Foundry
  • Leitor de dados de Blob de armazenamento para a identidade gerenciada do serviço de Pesquisa
  • Contribuinte para si mesmo

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

Adicione seus dados e tente o modelo de bate-papo novamente

No arranque rápido do recinto do Foundry (que é um pré-requisito para este tutorial), verás a forma como o seu modelo responde sem os seus dados. Adicione seus dados ao modelo para que ele possa responder a 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 exemplo de produto de varejo que são relevantes para este cenário tutorial. Especificamente, o product_info_11.md arquivo contém informações do produto sobre os sapatos de caminhada TrailWalker que são relevantes para este exemplo tutorial. Baixe o exemplo de dados do produto de varejo Contoso Trek em um arquivo ZIP para sua máquina local.

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

1. Vai ao teu projeto no Microsoft Foundry.

2. Selecione Playgrounds no painel esquerdo.

3. Selecione Experimente o playground de bate-papo.

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

   

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

   

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

   

7. Selecione Upload>Upload de arquivos para procurar seus arquivos locais.

8. Selecione os ficheiros que pretende carregar. Selecione os arquivos de informações do produto que você baixou ou criou anteriormente. Adicione todos os arquivos agora. Você não poderá adicionar mais arquivos posteriormente na mesma sessão de playground.

9. Selecione Carregar para carregar o arquivo em sua conta de armazenamento de Blob do Azure. Em seguida, selecione Seguinte.

   

10. Selecione seu serviço Azure AI Search .

11. Para o nome do índice vetorial, insira product-info e selecione Next.

12. Na página Configurações de pesquisa, em Configurações de vetor, 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 Seguinte.

    Observação

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

13. Revise suas configurações e selecione Criar índice vetorial.

14. No playground, você pode ver que sua ingestão de dados está em andamento. Este processo pode demorar 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 Foundry, implemente o modelo como uma aplicação web autónoma.

Localizar o seu grupo de recursos no portal do Azure

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

Siga estes passos para aceder ao seu grupo de recursos no portal do Azure:

1. Aceda ao seu projeto na Foundry. Selecione Centro de gerenciamento no painel esquerdo.

2. No título Projeto, selecione Visão geral.

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

   

4. Agora você está no portal do Azure, exibindo o conteúdo do grupo de recursos onde implantou o hub. Anote 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 num separador do browser. Você voltará a ele mais tarde.

Implantar o aplicativo Web

A publicação cria um Serviço de Aplicativo do Azure em sua assinatura. Poderá incorrer em custos dependendo do plano de preços que selecionar. 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. Pode desenvolver uma aplicação web com ou sem os seus próprios dados, mas precisa de um modelo publicado conforme descrito no guia de 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.
   • Assinatura: sua assinatura do 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 do hub.
   • Plano de preços: escolha um plano de preços para o aplicativo Web.
   • Ativar histórico de bate-papo no aplicativo Web: para o tutorial, a caixa de histórico de bate-papo não está selecionada. Se você habilitar o recurso, seus usuários terão acesso às suas consultas e respostas anteriores individuais. Para obter mais informações, consulte Observações do histórico de bate-papo.

4. Selecione Implantar.

5. Aguarde até que o aplicativo seja implantado. Este processo pode demorar alguns minutos.

6. Quando estiver pronto, o botão Iniciar estará ativado na barra de ferramentas. Não inicie o aplicativo ainda e não feche a página do chat playground — você voltará a ela mais tarde.

Configurar a autenticação do aplicativo Web

Por padrão, apenas você pode acessar o aplicativo Web. Neste tutorial, adicione autenticação para restringir o acesso aos membros do seu locatário do Azure. Os utilizadores iniciam sessão com a respetiva conta Microsoft Entra para aceder à sua aplicação. Você pode seguir um processo semelhante para adicionar outro provedor de identidade, se preferir. A aplicação utiliza apenas as informações de início de sessão do utilizador para verificar se é membro do seu inquilino.

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

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

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

   

4. Se vir a Microsoft a listar um fornecedor de Identidade nesta página, nada mais será necessário. Você pode pular a próxima etapa.

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

   • Provedor de identidade: selecione Microsoft como o provedor de identidade. As predefinições nesta página restringem a aplicação apenas ao seu inquilino, pelo que não precisa de alterar mais nada aqui.
   • Tipo de inquilino: Força de trabalho
   • Registo da aplicação: crie um novo registo da aplicação
   • Nome: o nome do seu serviço de aplicativo Web
   • Tipos de conta suportados: Inquilino atual - Inquilino único
   • Restringir acesso: requer autenticação
   • Solicitações não autenticadas: redirecionamento HTTP 302 encontrado - recomendado para sites

Utilizar a aplicação 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. Volte ao separador do navegador com a página do chat playground no portal Foundry.

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

4. Se não vir Iniciar no espaço intermédio, selecione Aplicações Web no painel esquerdo e, em seguida, selecione a sua aplicação na lista para a abrir.

   Se as definições de autenticação ainda não estiverem ativas, fecha o separador do navegador da tua aplicação web e volta ao chat playground no portal Foundry. Espere um pouco mais e tente novamente.

5. Na sua aplicação Web, faça a mesma pergunta que antes ("Quanto são os sapatos de caminhada 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.

   

Compreender o histórico do chat

Com o recurso de histórico de bate-papo, seus usuários podem ver suas consultas e respostas anteriores.

Habilite o histórico de bate-papo ao implantar o aplicativo Web. Marque a caixa de seleção Ativar histórico de bate-papo no aplicativo Web.

Depois de ativar o histórico de bate-papo, os usuários podem mostrá-lo ou ocultá-lo no canto superior direito do aplicativo. Quando o histórico é mostrado, eles podem renomear ou excluir conversas. À medida que iniciam sessão na aplicação, as conversas são ordenadas do mais recente para o mais antigo e nomeadas com base na primeira consulta da conversa.

Se você excluir o recurso do Cosmos DB, mas mantiver a opção de histórico de bate-papo ativada no estúdio, seus usuários verão um erro de conexão, mas poderão continuar usando o aplicativo Web sem histórico de bate-papo.

Atualizar a aplicação Web

Use o playground para adicionar mais dados ou testar o modelo com diferentes cenários. 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.

Limpeza de recursos

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

Conteúdo relacionado

• Comece a construir um chat app usando o SDK do Prompt Flow
• Criar um aplicativo de chat personalizado com o SDK do Azure AI