Tutorial: implantar um aplicativo Web de chat empresarial

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. O fundamento 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.

Siga 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 implantado do Azure OpenAI. Conclua o tutorial rápido do Foundry Playground para criar este recurso se você não tiver um.

• Uma conexão do serviço 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 Pesquisa.

• Uma cópia local dos dados do produto. O repositório Azure-Samples/rag-data-openai-python-promptflow no GitHub contém as informações de produtos de varejo de exemplo que são relevantes 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. Baixe o exemplo de dados do produto de varejo da Contoso Trek em um arquivo ZIP no seu computador 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 recurso, 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.

Portal do 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, é nesse local onde você criará e implantará o seu aplicativo Web de chat.

O portal do Azure permite que um administrador gerencie e monitore os recursos do Azure. Como administrador, você usa o portal para definir configurações para diferentes serviços do 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 do 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 OpenAI do Azure, a Pesquisa de IA do Azure e o Armazenamento de Blobs do 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 do OpenAI do Azure, use aquele que contém o 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 terminar, você terá três novas guias do navegador abertas: serviço Pesquisa, Fábrica e Contêiner de blobstore. Mantenha as três guias abertas porque você alterna entre elas para configurar os recursos.

Habilitar a identidade gerenciada

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

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

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

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

Definir o controle de acesso para a pesquisa

Na guia do navegador do recurso do serviço 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 obter o recurso especificado.
2. Na página à esquerda no portal do Azure, selecione Controle de acesso (IAM).
3. Selecione +Adicionar>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 o seu nome e selecione-a.
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 recurso, mas você ainda precisa selecioná-lo.
7. Continue por meio do assistente e selecione Examinar + 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 estas funções na guia do navegador para o serviço Pesquisa no portal do Azure:

  • Leitor de Dados do Índice de Pesquisa para a identidade gerenciada da Fábrica
  • Colaborador do Serviço de Pesquisa para a identidade gerenciada da Fábrica
  • Colaborador para você mesmo (para encontrar Colaborador, alterne para a aba Funções de administrador privilegiado na parte superior. Todas as outras funções estão na aba Funções de função de trabalho.)

• Atribua estas funções na aba do navegador para Foundry no portal do Azure.

  • Colaborador do OpenAI dos Serviços Cognitivos para a identidade gerenciada do serviço Pesquisa
  • Colaborador para si mesmo.

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

  • Colaborador de dados de blob de armazenamento para a identidade gerenciada da Fábrica
  • Leitor de dados de blob de armazenamento para a identidade gerenciada do serviço Pesquisa
  • Colaborador para si mesmo

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

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 as informações da amostra de produto de varejo que são relevantes para o cenário desse tutorial. Especificamente, o product_info_11.md contém informações sobre os sapatos de caminhada TrailWalker relevantes para este exemplo de tutorial. Baixe o exemplo de dados do produto de varejo da Contoso Trek em um arquivo ZIP no seu computador local.

Siga estas etapas para adicionar seus dados ao playground do 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 do Azure.

1. Acesse seu projeto no Microsoft Foundry.

2. Selecione Playgrounds no painel esquerdo.

3. Selecione Experimentar o playground de chat.

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

   

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

   

6. No menu suspenso Fonte de dados, selecione Carregar arquivos.

   

7. Selecione Carregar>Carregar arquivos para procurar seus arquivos locais.

8. Selecione os arquivos que você deseja 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 mais tarde na mesma sessão do playground.

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

   

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

11. Para o Nome do índice de vetor, insira product-info e selecione Avançar.

12. Na página Configurações de pesquisa, em Configurações de vetor, desmarque a caixa de seleção Adicionar busca em vetores a esse recurso de pesquisa. Essa configuração ajuda a determinar como o modelo responde às solicitações. Em seguida, selecione Avançar.

    Observação

    Se você adicionar busca em vetores, mais opções estarão disponíveis aqui, com um custo adicional.

13. Revise 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 custam 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 o aplicativo Web

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

Encontre o seu Grupo de Recursos no portal do 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 ir o grupo de recursos no portal do Azure:

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

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

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

   

4. Agora você está no portal do Azure, exibindo o conteúdo do grupo de recursos onde você implantou o hub. Anote o nome e o local do grupo de recursos. Você precisará dessas informações na próxima seção.

5. Mantenha esta página aberta em uma aba do navegador. Você retornará a ela 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 que você 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. 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.
   • Assinatura: sua assinatura do Azure. Se você não vir nenhuma assinatura disponível, primeiro registre o 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 do histórico de chat não está selecionada. Se você habilitar o recurso, os usuários terão acesso às consultas e respostas individuais anteriores deles. Para obter mais informações, consulte os 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 playground do chat — você voltará a ela 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 seu locatário do Azure. Os usuários entrarão com sua conta do 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 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 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 você vir que a Microsoft listou 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:

   • Provedor de identidade: selecione a Microsoft como o provedor de identidade. As configurações padrão nessa página restringem o aplicativo apenas ao seu locatário, portanto, não será necessário 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: locatário atual – locatário único
   • Restringir o acesso: requer autenticação
   • Solicitações não autenticadas: HTTP 302 Encontrado 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 playground, selecione aplicativos Web no painel esquerdo e 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 trilha TrailWalker"). Desta vez, o aplicativo usa informações de seus dados para criar a resposta. Expanda o botão de referência para ver os dados usados.

   

Entender o histórico de chats

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

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

Depois de habilitar o histórico de chats, 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 as conversas. À medida que entram no aplicativo, as conversas são ordenadas da mais nova para a mais antiga 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 chats habilitada no estúdio, os usuários verão um erro de conexão, mas poderão continuar usando o aplicativo Web sem o histórico de chats.

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 os recursos

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

Conteúdo relacionado

• Comece a criar um aplicativo de chat usando o SDK do prompt flow
• Criar um aplicativo de chat personalizado com o SDK de IA do Azure