Tutorial: Implantar um aplicativo Web de Chat Corporativo

Importante

Alguns dos recursos descritos neste artigo podem estar disponíveis apenas na visualização. 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. Implantar seu aplicativo Web

Pré-requisitos

• Uma assinatura do Azure - Crie uma gratuitamente.

• Acesso concedido ao Azure OpenAI na subscrição pretendida do Azure.

  Atualmente, o acesso a este serviço é concedido apenas por pedido. Você pode solicitar acesso ao Azure OpenAI preenchendo o formulário em https://aka.ms/oai/access. Abra um problema neste repositório para entrar em contato conosco se tiver um problema.

• 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 o produto de exemplo e os dados do cliente.

• Você precisa de pelo menos um arquivo para carregar que contenha dados de exemplo. Para concluir este tutorial, use os exemplos de informações do produto do repositório Azure-Samples/aistudio-python-quickstart-sample no GitHub. Especificamente, o product_info_11.md contém informações do produto sobre os sapatos de caminhada TrailWalker que são relevantes para este exemplo tutorial. Você pode baixar o arquivo ou copiar seu conteúdo para um arquivo nomeado product_info_11.md em seu computador local.

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/aistudio-python-quickstart-sample no GitHub contém exemplos de informações sobre clientes de varejo e produtos relevantes para este cenário tutorial. Clone o repositório ou copie os arquivos de 3-product-info.

Importante

O recurso Adicionar seus dados no playground do Azure AI Studio não oferece suporte ao uso de uma rede virtual ou ponto de extremidade privado nos seguintes recursos:

• Pesquisa de IA do Azure
• Azure OpenAI
• Recurso de armazenamento

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 (3-product-info) 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. Insira um nome para a configuração do playground e selecione Salvar>configuração de salvamento. Todos os itens de configuração são salvos por padrão. Os itens incluem implantação, mensagem do sistema, mensagem de segurança, parâmetros, dados adicionados, exemplos e variáveis. Salvar uma configuração com o mesmo nome salvará em relação à versão anterior.

    

16. 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 navegador - regresse a ela 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:

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

Próximos passos

• Crie um projeto no Azure AI Studio.
• Saiba mais sobre o que você pode fazer no Azure AI Studio.