Tutorial: Implantar um aplicativo Web de bate-papo corporativo
Importante
Os itens marcados (visualização) neste artigo estão atualmente em visualização pública. Essa visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
Neste artigo, você implanta um aplicativo Web de bate-papo corporativo que usa seus próprios dados com um modelo de linguagem grande no portal AI Foundry.
A sua fonte de dados é utilizada para ajudar a fundamentar o modelo com dados específicos. Aterramento significa que o modelo usa seus dados para ajudá-lo a entender o contexto da sua pergunta. Você não está alterando o modelo implantado em si. Os seus dados são armazenados separadamente e de forma segura na sua fonte de dados original
As etapas neste tutorial são:
- Implante e teste um modelo de chat sem seus dados.
- Adicione os seus dados.
- Teste o modelo com seus dados.
- Implante seu aplicativo Web.
Pré-requisitos
Uma assinatura do Azure - Crie uma gratuitamente.
Um modelo de chat do Azure OpenAI implantado. Conclua o início rápido do AI Foundry playground para criar este recurso, se ainda não o fez.
Uma conexão de serviço do Azure AI Search para indexar os dados de exemplo do produto.
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.mdarquivo 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.Um provedor de recursos Microsoft.Web registrado na assinatura selecionada, para poder implantar em um aplicativo Web.
Adicione seus dados e tente o modelo de bate-papo novamente
No início rápido do AI Foundry playground (que é um pré-requisito para este tutorial), observe como seu modelo responde sem seus dados. Agora você adiciona seus dados ao modelo para ajudá-lo a 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.
Vá para o seu projeto no Azure AI Foundry.
Selecione Playgrounds.
Selecione Experimente o playground de bate-papo.
Selecione seu modelo de chat implantado na lista suspensa Implantação .
No lado esquerdo do playground de bate-papo, selecione Adicionar seus dados>+ Adicionar uma nova fonte de dados.
Na lista suspensa Fonte de dados, selecione Carregar arquivos.
Selecione Upload>Upload de arquivos para procurar seus arquivos locais.
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.
Selecione Carregar para carregar o arquivo em sua conta de armazenamento de Blob do Azure. Em seguida, selecione Seguinte.
Selecione um serviço Azure AI Search. Neste exemplo, selecionamos Conectar outro recurso do Azure AI Search na lista suspensa Selecionar serviço Azure AI Search. Se você não tiver um recurso de pesquisa, poderá criar um selecionando Criar um novo recurso do Azure AI Search. Em seguida, volte a esta etapa para se conectar e selecione-o.
Procure seu serviço Azure AI Search e selecione Adicionar conexão.
Para o nome do índice vetorial, insira product-info e selecione Next.
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.
Nota
Se você adicionar pesquisa vetorial, mais opções estarão disponíveis aqui por um custo adicional.
Revise suas configurações e selecione Criar índice vetorial.
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.
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 Azure AI Foundry, você poderá implantar o modelo como um aplicativo Web autônomo.
Localizar o seu grupo de recursos no portal do Azure
Neste tutorial, seu aplicativo Web é implantado no mesmo grupo de recursos que o hub do AI Foundry. Mais tarde, você configura a autenticação para o aplicativo Web no portal do Azure.
Siga estas etapas para navegar do Azure AI Foundry para seu grupo de recursos no portal do Azure:
Vá para o seu projeto no Azure AI Foundry. Em seguida, selecione Centro de gerenciamento no painel esquerdo.
No título Projeto, selecione Visão geral.
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-contoso.
Agora você deve estar no portal do Azure, exibindo o conteúdo do grupo de recursos onde implantou o hub. Mantenha esta página aberta num separador do browser. Você volta a ele mais tarde.
Implantar o aplicativo Web
A publicação cria um Serviço de Aplicativo do Azure em sua assinatura. Ele pode incorrer em custos dependendo do plano de preços selecionado. Quando terminar de usar seu aplicativo, você poderá excluí-lo do portal do Azure.
Para implantar o aplicativo Web:
Nota
Você precisa ter o provedor de recursos Microsoft.Web registrado na assinatura selecionada para poder implantar em um aplicativo Web.
Conclua as etapas na seção anterior para adicionar seus dados ao playground.
Nota
Você pode implantar um aplicativo Web com ou sem seus próprios dados, mas pelo menos precisa de um modelo implantado, conforme descrito no início rápido do AI Foundry Playground.
Selecione Implantar > ... como um aplicativo Web.
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.
- Grupo de recursos: selecione um grupo de recursos no qual implantar o aplicativo Web. Você pode usar o mesmo grupo de recursos que o hub.
- Local: selecione um local no qual implantar o aplicativo Web. Você pode usar 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.
Selecione Implementar.
Aguarde até que o aplicativo seja implantado, o que pode levar alguns minutos.
Quando estiver pronto, o botão Iniciar estará ativado na barra de ferramentas. Mas não inicie o aplicativo ainda e não feche a página do playground de bate-papo - você retornará a ele mais tarde.
Configurar a autenticação do aplicativo Web
Por padrão, o aplicativo Web só estará acessível para você. Neste tutorial, você adiciona autenticação para restringir o acesso ao aplicativo aos membros do seu locatário do Azure. Os usuários são solicitados a entrar com sua conta do Microsoft Entra para poder acessar seu aplicativo. Você pode seguir um processo semelhante para adicionar outro provedor de identidade, se preferir. A aplicação não utiliza as informações de início de sessão do utilizador de qualquer outra forma que não seja verificar se é membro do seu inquilino.
Retorne à guia do navegador que contém o portal do Azure (ou reabra o portal do Azure em uma nova guia do navegador) e exiba o conteúdo do grupo de recursos onde você implantou o hub e o aplicativo Web (talvez seja necessário atualizar a exibição do aplicativo Web).
Selecione o recurso Serviço de Aplicativo na lista de recursos no grupo de recursos.
No menu recolhível à esquerda em Configurações, selecione Autenticação.
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
Já está quase! Agora você pode testar o aplicativo Web.
Aguarde cerca de 10 minutos para que as configurações de autenticação entrem em vigor.
Retorne à guia do navegador que contém a página do playground de bate-papo no portal do Azure AI Foundry.
Selecione Iniciar para iniciar o aplicativo Web implantado. Se solicitado, aceite a solicitação de permissões.
Se as configurações de autenticação ainda não tiverem entrado em vigor, feche a guia do navegador do seu aplicativo Web e retorne ao playground de bate-papo no portal do Azure AI Foundry. Em seguida, espere um pouco mais e tente novamente.
No seu aplicativo da web, você pode fazer 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ência para ver os dados que foram usados.
Compreender o histórico do chat
Com o recurso de histórico de bate-papo, seus usuários terão acesso às suas consultas e respostas anteriores individuais.
Você pode habilitar 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.
Importante
Habilitar o histórico de bate-papo criará uma instância do Cosmos DB em seu grupo de recursos e incorrerá em cobranças adicionais pelo armazenamento usado. A eliminação da sua aplicação Web não elimina automaticamente a sua instância do Cosmos DB. Para eliminar a sua instância do Cosmos DB, juntamente com todos os chats armazenados, tem de navegar para o recurso associado no portal do Azure e eliminá-lo.
Depois de ativar o histórico de bate-papo, seus usuários poderão mostrá-lo e ocultá-lo no canto superior direito do aplicativo. Quando o histórico é mostrado, eles podem renomear ou excluir conversas. À medida que forem iniciadas na aplicação, as conversas serão automaticamente 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 serão notificados de um erro de conexão, mas poderão continuar a usar o aplicativo Web sem acesso ao histórico de bate-papo.
Clean up resources (Limpar recursos)
Para evitar incorrer em custos desnecessários do Azure, você deve excluir os recursos criados neste início rápido se eles não forem mais necessários. Para gerenciar recursos, você pode usar o portal do Azure.