Share via

Tutorial: Implantar um aplicativo Web para chat em seus dados

  • Artigo

Observação

Atualmente, o Estúdio de IA do Azure está em visualização pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Neste artigo, você implantará um aplicativo Web de chat que usa seus próprios dados com um modelo do Serviço OpenAI do Azure.

Carregue seus arquivos de dados locais no Armazenamento de Blobs do Azure e crie um índice do Azure AI Search. Sua fonte de dados é usada para ajudar a aterrar o modelo com dados específicos. Aterramento significa que o modelo usa seus dados para ajudá-lo a entender o contexto de sua pergunta. 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. Para saber mais, confira OpenAI do Azure para seus dados.

Siga as etapas neste tutorial são:

  1. Implantar e testar um modelo de chat sem seus dados
  2. Adicionar seus dados
  3. Testar o modelo com seus dados
  4. Implantar o aplicativo Web

Pré-requisitos

  • Uma assinatura do Azure – Crie uma gratuitamente.

  • Acesso permitido ao OpenAI do Azure na assinatura do Azure desejada.

    No momento, o acesso a esse serviço é permitido somente por aplicativo. Você pode solicitar acesso ao Serviço OpenAI do Azure preenchendo o formulário em https://aka.ms/oai/access. Abra um problema neste repositório para entrar em contato conosco se você tiver algum problema.

  • Um recurso do hub de IA do Azure e um projeto no Estúdio de IA do Azure.

  • 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/aistudio-copilot-sample no GitHub. Especificamente, o product_info_11.md contém informações sobre os sapatos de caminhada TrailWalker relevantes para este exemplo de tutorial. Você pode baixar o arquivo ou copiar seu conteúdo para um arquivo nomeado product_info_11.md em seu computador local.

Implantar e testar um modelo de chat sem seus dados

Siga estas etapas para implantar um modelo de chat e testá-lo sem seus dados.

  1. Entre no Azure AI Studio.

  2. Acesse seu projeto ou crie um projeto no Estúdio de IA do Azure.

  3. Selecione Compilar no menu superior e, em seguida, selecione Implantações>Criar>Ponto de extremidade em tempo real.

    Captura de tela da página de implantações sem implantações.

  4. Na página Selecionar um modelo, selecione o modelo que você deseja implantar na lista suspensa Modelo. Por exemplo, selecione gpt-35-turbo-16k. Em seguida, selecione Confirmar.

    Captura de tela da página de seleção do modelo.

  5. Na página Implantar modelo, insira um nome para sua implantação e selecione Implantar. Depois que a implantação for criada, você verá a página de detalhes da implantação. Os detalhes incluem a data em que você criou a implantação e a data e a versão criadas do modelo implantado.

  6. Na página de detalhes da implantação da etapa anterior, selecione Abrir no playground.

    Captura de tela dos detalhes da implantação do GPT chat.

  7. No playground, verifique se o Chat está selecionado na lista suspensa Modo. Selecione o modelo de chat GPT implantado na lista suspensa Implantação.

    Captura de tela do playground de chat com o modo de chat e o modelo selecionados.

  8. Na caixa de texto da mensagem do sistema no painel de configuração do Assistente, forneça este prompt para orientar o assistente: "Você é um assistente de IA que ajuda as pessoas a encontrar informações." Você pode adaptar o prompt para seu cenário.

  9. Selecione Aplicar alterações para salvar suas alterações e, quando solicitado a responder se deseja atualizar a mensagem do sistema, selecione Continuar.

  10. No painel de sessão de chat, insira a seguinte pergunta: "Quanto custam os sapatos de caminhada TrailWalker" e selecione o ícone de seta para a direita a ser enviado.

    Captura de tela da primeira pergunta de chat sem dados de fundamentação.

  11. O assistente responde que não sabe a resposta. Isso ocorre porque o modelo não tem acesso às informações de produto sobre os sapatos de caminhada TrailWalker.

    Captura de tela da resposta do assistente sem dados de fundamentação.

Na próxima seção, você adicionará seus dados ao modelo para ajudá-lo a responder perguntas sobre seus produtos.

Adicionar seus dados

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

Importante

O recurso "Adicionar seus dados" no playground do Estúdio de IA do Azure não dá suporte ao uso de uma rede virtual ou ponto de extremidade privado nos seguintes recursos:

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

  1. Se você ainda não estiver no playground, selecione Compilar no menu superior e selecione Playground no menu esquerdo recolhível.

  2. No painel Configuração do Assistente, selecione Adicionar seus dados (versão prévia)>+ Adicionar uma fonte de dados .

    Captura de tela do playground de chat com a opção de adicionar uma fonte de dados visível.

  3. Na página Selecionar ou adicionar fonte de dados exibida, selecione Carregar arquivos na lista suspensa Selecionar fonte de dados.

    Captura de tela das opções de seleção da fonte de dados.

    Dica

    Para obter opções de fonte de dados e formatos e tipos de arquivo com suporte, consulte o OpenAI do Azure para seus dados.

  4. Insira os detalhes da fonte de dados:

    Captura de tela dos recursos e das informações necessárias para carregar arquivos.

    Observação

    O OpenAI do Azure precisa de um recurso de armazenamento e de um recurso de pesquisa para acessar e indexar seus dados. Seus dados são armazenados com segurança em sua assinatura do Azure.

    • Assinatura: selecione a assinatura do Azure que contém o recurso do OpenAI do Azure que você deseja usar.
    • Recurso de armazenamento: selecione o recurso de Armazenamento de Blobs do Azure no qual você deseja carregar seus arquivos.
    • Fonte de dados: selecione um índice existente do Azure AI Search, um contêiner do Armazenamento do Azure ou carregue arquivos locais como a origem da qual criaremos os dados de aterramento. Seus dados são armazenados com segurança em sua assinatura do Azure.
    • Nome do índice: selecione o recurso do Azure AI Search em que o índice usado para aterramento é criado. Um novo índice de pesquisa com o nome fornecido é gerado após a conclusão da ingestão de dados.

  5. Selecione seu recurso do Azure AI Search e selecione a confirmação de que a sua conexão incorrerá em uso em sua conta. Em seguida, selecione Avançar.

  6. No painel Carregar arquivos, selecione Procurar um arquivo e selecione os arquivos que você deseja carregar. Selecione o arquivo product_info_11.md que você baixou ou criou anteriormente. Consulte os pré-requisitos. Se você quiser carregar mais de um arquivo, faça isso agora. Você não poderá adicionar mais arquivos mais tarde na mesma sessão do playground.

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

    Captura de tela da caixa de diálogo para selecionar e carregar arquivos.

  8. No painel Gerenciamento de dados em Tipo de pesquisa, selecione Palavra-chave. Essa configuração ajuda a determinar como o modelo responde às solicitações. Em seguida, selecione Avançar.

    Observação

    Se você tiver adicionado a busca em vetores na página Selecionar ou adicionar fonte de dados, mais opções estarão disponíveis aqui para um custo adicional. Para saber mais, confira OpenAI do Azure para seus dados.

  9. Reveja os detalhes inseridos e selecione Salvar e fechar. Agora é possível conversar com o modelo e ele usará as informações dos seus dados para construir a resposta.

    Captura de tela da página de revisão e término para adicionar dados.

  10. Agora, no painel de configuração do Assistente, você pode ver que a ingestão de dados está em andamento. Antes de continuar, aguarde até ver a fonte de dados e o nome do índice no lugar do status.

    Captura de tela do playground de chat com o status da ingestão de dados na exibição.

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

    Captura de tela da resposta do assistente com dados de fundamentação.

Implantar o aplicativo Web

Quando estiver satisfeito com a experiência no Estúdio de IA do Azure, você poderá implantar o modelo como um aplicativo Web autônomo.

Encontre o seu Grupo de Recursos no portal do Azure

Neste tutorial, seu aplicativo Web será implantado no mesmo grupo de recursos do recurso do hub de IA do Azure. Posteriormente, você configurará a autenticação para o aplicativo Web no portal do Azure.

Siga estas etapas para navegar do Estúdio de IA do Azure até seu grupo de recursos no portal do Azure:

  1. No Estúdio de IA do Azure, selecione Gerenciar no menu superior e selecione Detalhes. Se você tiver vários recursos do hub de IA do Azure, selecione aquele que deseja usar para ver os detalhes.

  2. No painel Configuração de recursos, selecione o nome do grupo de recursos para abrir o grupo de recursos no portal do Azure. Neste exemplo, o grupo de recursos é nomeado rg-docsazureairesource.

    Captura de tela do grupo de recursos no Estúdio de IA do Azure.

  3. Agora você está no portal do Azure, visualizando o conteúdo do grupo de recursos em que o recurso do hub de IA do Azure foi implantado.

    Captura de tela do grupo de recursos no portal do Azure.

    Mantenha esta página aberta em uma guia 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. Isso pode acarretar custos, dependendo do plano de preços que você selecionar. Quando terminar de usar o 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.

    Observação

    Você pode implantar um aplicativo Web com ou sem seus próprios dados, mas pelo menos precisa de um modelo implantado, conforme descrito na implantação e teste de um modelo de chat sem seus dados.

  2. Selecione Implantar>Um novo aplicativo Web.

    Captura de tela do botão implantar novo 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. Use o mesmo grupo de recursos do recurso do hub de IA do Azure.
    • Local: selecione um local no qual implantar o aplicativo Web. Você pode usar a mesma localização do recurso do hub de IA do Azure.
    • 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 anteriores individualmente. Para obter mais informações, consulte os comentários sobre o histórico de chat.
    • Reconheço que os aplicativos Web incorrerão no uso da minha conta: Selecionado

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

    Captura de tela do playground com a notificação de que a implantação do aplicativo Web está em andamento.

  5. Quando estiver pronto, o botão Iniciar estará habilitado na barra de ferramentas. Mas não inicie o aplicativo ainda e não feche a página do Playground - você retornará a ele mais tarde.

Configurar a autenticação de aplicativo Web

Por padrão, o aplicativo Web só poderá ser acessado por você. Neste tutorial, você adicionará autenticação para restringir o acesso ao aplicativo aos membros do 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. O aplicativo não usa as informações de entrada do usuário de outra maneira além de verificar se ele é membro do seu locatário.

  1. Volte à guia do navegador que contém o portal do Azure (ou abra novamente o portal do Azure em uma nova guia do navegador) e visualize o conteúdo do grupo de recursos em que você implantou o recurso do hub de IA do Azure e o aplicativo Web (talvez seja necessário atualizar a exibição do 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.

    Captura de tela do item de menu de autenticação do aplicativo Web em configurações no portal do Azure.

  4. 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. Aguarde 10 minutos ou mais para que as configurações de autenticação entrem em vigor.

  2. Retorne à guia do navegador que contém a página Playground no Estúdio de IA do Azure.

  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 aplicativo Web e retorne à página Playground no Estúdio de IA do Azure. Então aguarde um pouco mais e tente novamente.

  4. Em seu aplicativo Web, você pode fazer a mesma pergunta que antes ("Quanto custam os sapatos de caminhada do 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.

    Captura de tela da experiência de chat por meio do aplicativo Web implantado.

Limpar os recursos

Para evitar gerar custos desnecessários no Azure, exclua os recursos criados neste início rápido, caso eles não sejam mais necessários. Para gerenciar os recursos, use o portal do Azure.

Comentários

Histórico de chat

Com o recurso de histórico de chat, os usuários terão acesso às consultas e respostas anteriores individualmente.

Você pode habilitar o histórico de chat ao implantar o aplicativo Web. Marque a caixa de seleção Habilitar histórico de chat no aplicativo Web.

Captura de tela da opção para habilitar o histórico de chat ao implantar um aplicativo Web.

Importante

A habilitação do histórico de chat criará uma instância do Cosmos DB em seu grupo de recursos e implicará em cobranças adicionais pelo armazenamento utilizado. Excluir seu aplicativo Web não exclui sua instância do Cosmos DB automaticamente. Para excluir a sua instância do Cosmos DB, juntamente com todos os chats armazenados, é necessário navegar até ao recurso relacionado no portal do Azure e exclui-lo.

Depois de habilitar o histórico de chat, 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 estiverem conectados no aplicativo, as conversas serão ordenadas automaticamente (da mais recente 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 do chat habilitada no estúdio, seus usuários serão notificados sobre um erro de conexão, mas poderão continuar usando o aplicativo Web sem acesso ao histórico de chat.

Próximas etapas