Tutorial: Implantar um aplicativo Web de Chat 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 AI Studio.

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:

1. Implante e teste um modelo de chat sem seus dados.
2. Adicione os seus dados.
3. Teste o modelo com seus dados.
4. Implante seu aplicativo Web.

Pré-requisitos

• Uma assinatura do Azure - Crie uma gratuitamente.

• Um hub, projeto e modelo de chat do Azure OpenAI implantado no AI Studio. Conclua o início rápido do playground do AI Studio para criar esses recursos, se ainda não o fez.

• Uma conexão de serviço do Azure AI Search para indexar os dados de exemplo do produto.

• 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.

• Você precisa ter o 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 Studio (que é um pré-requisito para este tutorial), você pode observar 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.

1. Vá para o seu projeto no Azure AI Studio.

2. Selecione Playgrounds>Chat no painel esquerdo.

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

   

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

   

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

   

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

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

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

   

9. 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.

   

10. Procure seu serviço Azure AI Search e selecione Adicionar conexão.

    

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

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.

    Nota

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

13. Reveja as suas definições e selecione Criar.

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 Azure AI Studio, 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 Studio. Mais tarde, você configura a autenticação para o aplicativo Web no portal do Azure.

Siga estas etapas para navegar do Azure AI Studio para seu grupo de recursos no portal do Azure:

1. Vá para o seu projeto no Azure AI Studio. Em seguida, selecione Configurações no painel esquerdo.

2. 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.

   

3. 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.

1. 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 playground do AI Studio.

2. Selecione Implantar em 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.
   • 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.

4. Selecione Implementar.

5. Aguarde até que o aplicativo seja implantado, o que pode levar alguns minutos.

   

6. 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.

1. 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).

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

1. Aguarde cerca de 10 minutos para que as configurações de autenticação entrem em vigor.

2. Retorne à guia do navegador que contém a página do playground de bate-papo no Azure AI Studio.

3. 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 Azure AI Studio. Em seguida, espere um pouco mais e tente novamente.

4. 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.

   

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.

Observações

Histórico do bate-papo

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.

Conteúdos relacionados

• Comece a criar um aplicativo de bate-papo usando o SDK de fluxo de prompt
• Crie um aplicativo de chat personalizado com o SDK de fluxo de prompt..