Usar o aplicativo Web de OpenAI do Azure

Juntamente com o OpenAI do Azure Studio, APIs e SDKs, você pode usar o aplicativo Web autônomo disponível para interagir com modelos do Serviço OpenAI do Azure usando uma interface gráfica do usuário. Você pode implantar o aplicativo usando o OpenAI do Azure Studio ou uma implantação manual.

Considerações importantes

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

• Não há suporte para o GPT-4 Turbo com modelos do Visão.

• Por padrão, o aplicativo é implantado com o provedor de identidade da Microsoft já configurado. O provedor de identidade restringe o acesso ao aplicativo aos membros do seu locatário do Azure. Para adicionar ou modificar a autenticação:

  1. Acesse para o portal do Azure e pesquise o nome do aplicativo especificado durante a publicação. Selecione o aplicativo Web e selecione Autenticação no menu à esquerda. Selecione Adicionar provedor de identidade.

     

  2. Selecione Microsoft como 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. Selecione Adicionar.

  Agora, os usuários serã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.

Personalização de aplicativo Web

Você também pode personalizar a lógica de front-end e back-end do aplicativo. O aplicativo fornece diversas variáveis de ambiente para cenários de personalização comuns, como a alteração do ícone no aplicativo.

Ao personalizar o aplicativo, recomendamos:

• Redefinindo a sessão de chat (chat claro) se os usuários alterarem as configurações. Notificar o usuário de que seu histórico de chat será perdido.

• Comunicando claramente como cada configuração implementada por você afetará a experiência do usuário.

• Atualizando as configurações de aplicativo para cada um dos aplicativos implantados para usar novas chaves de API depois de girar as chaves para o recurso do OpenAI do Azure ou da Pesquisa de IA do Azure.

O código-fonte de amostra do aplicativo Web está disponível no GitHub. O código-fonte é fornecido "como está" e apenas como uma amostra. Os clientes são responsáveis por toda a personalização e implementação de seus aplicativos Web.

Atualizando o aplicativo Web

Observação

Após 1º de fevereiro de 2024, o aplicativo Web exige que o comando de inicialização do aplicativo seja definido como python3 -m gunicorn app:app. Ao atualizar um aplicativo publicado antes de 1º de fevereiro de 2024, você precisa adicionar manualmente o comando de inicialização da página Configuração do Serviço de Aplicativo.

Recomendamos efetuar pull de alterações do branch main para o código-fonte do aplicativo Web com frequência para garantir que você tenha as correções de bug, versão de API e aprimoramentos mais recentes. Além disso, será necessário sincronizar o aplicativo Web sempre que a versão da API usada for desativada. Clique nos botões de Inspeção ou de Estrela no repositório GitHub do aplicativo Web para ser notificado sobre as alterações e atualizações no código-fonte.

Se você ainda não personalizou o aplicativo Web, poderá usar estas etapas para sincronizá-lo:

1. No portal do Azure, vá para seu aplicativo web.

2. No menu à esquerda, em Implantação, selecione Centro de Implantação.

3. Selecione Sincronizar na parte superior da tela e confirme se o aplicativo será reimplantado.

   

Se você personalizou ou alterou o código-fonte do aplicativo, será necessário atualizar manualmente o código-fonte do aplicativo e reimplantá-lo:

• Se o aplicativo estiver hospedado no GitHub, envie as alterações de código ao repositório por push e use as etapas de sincronização abaixo.
• Se você estiver reimplantando o aplicativo manualmente (por exemplo, CLI do Azure), siga as etapas da sua estratégia de implantação.

Histórico de chat

Você pode habilitar o histórico de chat para seus usuários do aplicativo Web. Quando você ativa o recurso, os usuários têm acesso a suas consultas e respostas individuais anteriores.

Para ativar o histórico de chat, implante ou reimplante seu modelo como um aplicativo Web usando o Estúdio OpenAI do Azure e selecione Habilitar histórico de chat no aplicativo Web.

Importante

Ativar o histórico de chat cria uma instância do Azure Cosmos DB em seu grupo de recursos e gera encargos adicionais para o armazenamento que você usa.

Depois de ativar o histórico do chat, os usuários poderão mostrá-lo e ocultá-lo no canto superior direito do aplicativo. Quando os usuários mostram o histórico de chat, eles podem renomear ou excluir conversas. Como os usuários estão conectados ao aplicativo, as conversas são ordenadas automaticamente do mais novo para o mais antigo. As conversas são nomeadas com base na primeira consulta na conversa.

Excluindo sua instância do Cosmos DB

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

Conteúdo relacionado

• Engenharia de prompts
• OpenAI do Azure em Seus Dados