Criando uma conexão Azure OpenAI

Para se comunicar com o Azure OpenAI, Para se comunicar com , crie uma conexão com a origem de análise do Azure OpenAI.

Os dados recebidos dessas conexões podem ser usados no script de carregamento e, em expressões de gráfico, para aprimorar seus aplicativos ou scripts de análise do Qlik Sense.

Antes de iniciar

Em sua conta do Microsoft Azure, o serviço Azure OpenAI está localizado no Azure Cognitive Services e não está habilitado por padrão. Entre em contato com a Microsoft se precisar de ajuda para habilitar o serviço Azure OpenAI.

Configurações de conector disponíveis

Configure sua conexão de analítica do Azure OpenAI com uma das seguintes configurações.

API de complementações do OpenAI - Linhas

Essa configuração envia cada linha de dados como uma pergunta para a API de complementações (em pequenos lotes para melhorar a performance). Cada resposta será armazenada como texto em uma tabela com o mesmo número de linhas da entrada.

Essa configuração pode ser usada no script de carregamento e nas expressões do gráfico.

API de complementações do OpenAI Chat - Linhas

Essa configuração envia cada linha de dados como uma solicitação para a API de complementações do OpenAI Chat. Nesse caso, as solicitações são feitas com a função de mensagem “user”, e cada linha de dados da Qlik é enviada como uma solicitação separada.

Não há suporte para o envio de várias linhas como um contexto de chat. Você precisa incluir todas as perguntas em uma única linha de solicitação.

Essa configuração pode ser usada no script de carregamento e nas expressões do gráfico.

Criando a conexão

Você pode criar uma conexão com o conector de análise do Azure OpenAI no hub ou no editor de carregamento de dados em um aplicativo que você já criou. Siga as etapas abaixo para criar uma conexão.

Para obter informações sobre como definir os valores dos parâmetros, consulte Referência da API REST do serviço Azure OpenAI.

Faça o seguinte:

Crie um novo aplicativo ou script do Qlik Sense e abra o Editor da carga de dados ou o Editor de script.
Clique em Criar nova conexão.
Sob Fontes de análise , clique em Azure OpenAI.
Escolha a Configuração necessária. Para obter mais informações sobre cada opção disponível, consulte Configurações de conector disponíveis.
Insira a Chave da API do Azure OpenAI.
Insira a Versão da API do Azure. Este campo já está preenchido com o padrão atual.
Ajuste qualquer um dos outros valores de parâmetro padrão conforme necessário.

Para obter descrições adicionais dos parâmetros, consulte Configurações definíveis.

Nota informativaVocê quase sempre precisará alterar o valor do parâmetro Máximo de tokens para que a conexão funcione adequadamente para suas necessidades. Esse parâmetro controla o tamanho da resposta que será gerada.
Clique em Criar.

A conexão de dados é salva no espaço onde o aplicativo é criado, para que possa ser reutilizado em outros aplicativos ou scripts do Qlik Sense.

Depois de criar a conexão, você pode usá-la para carregar dados para enviar ao OpenAI. Além disso, você pode usá-la em expressões de gráfico. Para obter mais informações, consulte Selecione e carregue os dados de uma conexão Azure OpenAI e Usando conexões Azure OpenAI em expressões de visualização.

Configurações definíveis

As configurações na tabela a seguir podem ser configuradas na caixa de diálogo de conexão.

Configurações definíveis na caixa de diálogo de conexão
Campo	Descrição
Selecione a configuração	Sob Configuração, selecione a configuração para o conector. Para obter mais informações, consulte Configurações de conector disponíveis.
Autorização	Insira a Chave da API do Azure OpenAI. Para obter informações, consulte Referência da API REST do serviço Azure OpenAI.
Solicitação do Azure OpenAI	Nome do recurso do Azure: O projeto de recurso que você configurou no Microsoft Azure. Nome da implementação do Azure: A implementação específica que você configurou para o modelo OpenAI escolhido. Versão da API do Azure: A versão da API no Azure. Isso é pré-preenchido com o valor padrão atual.
Solicitação do OpenAI	Temperatura: A temperatura de amostragem a ser usada. Máximo de tokens: Este parâmetro ajusta o número máximo de tokens a serem gerados. Ou seja, ele controla o tamanho da resposta que será gerada. Você quase sempre precisará alterar o valor padrão para que a conexão funcione adequadamente para suas necessidades. Top P: Ajusta a amostragem do núcleo. Isso pode ser alterado como uma alternativa para Temperatura de amostragem. Multa de frequência: O grau em que o modelo penaliza novos tokens que são repetidos textualmente de tokens existentes. Penalidade de presença: O grau em que o modelo penaliza novos tokens que já estão contidos no texto até o ponto em que são introduzidos. Usuário: O ID do usuário final, que pode ajudar no monitoramento de violações de política.
Associação	Especifique um Campo de aAssociação, um campo da tabela de dados de entrada contendo um identificador exclusivo. É necessário incluir esse campo nos dados de origem ao fazer uma solicitação de terminal para que a tabela de resultados retornada seja associada à tabela de campo de origem usando uma chave. O campo designado será retornado como um campo na resposta e permitirá que a resposta seja associada aos dados de origem no modelo de dados. Pode ser qualquer campo com um ID exclusivo, seja dos dados de origem ou como parte do processo de carregamento da tabela.
Nome	O nome da conexão. O nome padrão será usado se você não inserir um nome.

Saiba mais

Referência da API REST do serviço Azure OpenAI

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui