Criando uma conexão OpenAI
Para se comunicar com a plataforma OpenAI, crie uma conexão com a origem de análise do OpenAI.
Para se comunicar com o OpenAI, crie uma conexão com a origem de análise da OpenAI. Crie a conexão na página Criar do centro de atividades de Análises, Editor da carga de dados ou Script.
Os dados recebidos dessas conexões podem ser usados no script de carregamento e em expressões de gráfico para aprimorar seus aplicativos de análise do Qlik Sense.
Definições e configurações definíveis
Configure sua conexão de analítica do OpenAI com uma das seguintes configurações. As outras configurações definições podem variar dependendo da configuração usada.
API de complementações do OpenAI (GPT-3) - 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 é 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.
Para obter a documentação da OpenAI sobre a API usada por essa configuração, consulte Conclusões.
Campo | Descrição |
---|---|
Selecione a configuração | Em Configuração, selecione Complementações do OpenAI (GPT-3) - Linhas. |
Autorização | Introduza a Chave da API do OpenAI. Para obter mais informações, consulte Gerando uma chave de API do OpenAI. |
Solicitação do OpenAI |
|
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. |
API de complementações do OpenAI (GPT-3) - Tabelas JSON
Essa configuração envia uma solicitação em cada linha, em que a resposta deve ser uma lista de dados JSON. O conector converterá a tabela JSON em uma tabela de dados no modelo de dadosQlik. Deve ser tratado como experimental devido à natureza das respostas do OpenAI.
Essa configuração pode ser usada no script de carregamento para sintetizar dados. Não se destina ao uso em expressões de gráfico. Dependendo de como você faz sua pergunta, nem sempre pode retornar um JSON válido.
Campo | Descrição |
---|---|
Selecione a configuração | Em Configuração, selecione Complementações do OpenAI (GPT-3) - Tabelas JSON. |
Autorização | Introduza a Chave da API do OpenAI. Para obter mais informações, consulte Gerando uma chave de API do OpenAI. |
Solicitação do OpenAI |
|
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. |
API de complementações de chat do OpenAI (GPT-3.5, GPT-4) - Linhas
Essa configuração funciona de maneira semelhante à configuração de API de complementações do OpenAI (GPT-3) - Linhas, mas 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.
Essa configuração pode ser usada no script de carregamento e nas expressões do gráfico.
Para obter a documentação da OpenAI sobre a API usada por essa configuração, consulte Chat.
Campo | Descrição |
---|---|
Selecione a configuração | Em Configuração, selecione Complementações do OpenAI (GPT-3.5, GPT-4) - Linhas. |
Autorização | Introduza a Chave da API do OpenAI. Para obter mais informações, consulte Gerando uma chave de API do OpenAI. |
Solicitação do OpenAI |
|
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. |
Incorporações do OpenAI
Essa configuração envia linhas de texto de entrada para a API de Incorporações do OpenAI. O OpenAI retorna uma representação vetorial separada de cada entrada. Essa representação vetorial está em um formato que pode ser consumido por modelos de aprendizado de máquina.
Para obter a documentação da OpenAI sobre a API usada por essa configuração, consulte Incorporações.
Campo | Descrição |
---|---|
Selecione a configuração | Em Configuração, selecione Incorporações OpenAI. |
Autorização | Introduza a Chave da API do OpenAI. Para obter mais informações, consulte Gerando uma chave de API do OpenAI. |
Solicitação do OpenAI |
|
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. |
Criando a conexão
Você pode criar uma conexão com o conector analítico a partir do centro de atividades de Análises, do Editor da carga de dados em um aplicativo existente ou do Script de um script existente. Siga as etapas abaixo para criar uma conexão.
Faça o seguinte:
-
Crie um novo aplicativo ou script do Qlik Sense. Abra o Editor da carga de dados ou o Script.
-
Clique em Criar nova conexão.
-
Em Espaço, selecione o espaço onde a conexão será localizada.
-
Em Fontes de análise , clique OpenAI.
-
Escolha a Configuração necessária. Para obter mais informações sobre cada opção disponível, consulte Definições e configurações definíveis.
-
Insira a Chave da API do Azure OpenAI. Para obter mais informações, consulte Gerando uma chave de API do OpenAI.
-
Sob Modelo OpenAI , selecione o modelo OpenAI que deseja usar.
-
Ajuste qualquer um dos outros valores de parâmetro padrão conforme necessário. Esses parâmetros são descritos na documentação da API do OpenAI. Para mais informações, consulte Chat, Complementações e Incorporações.
Para obter descrições adicionais dos parâmetros, consulte Definições e 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 e scripts do Qlik Sense. Ela também é listado em Conexões de dados, no Editor da carga de dados ou no Script.
Depois de criar a conexão, você pode usá-la para carregar dados com as solicitações e as respostas da plataforma a elas. 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 OpenAI e Usando conexões OpenAI em expressões de visualização.
Exemplos detalhados
Para obter exemplos completos de como trabalhar com o conector de análise OpenAI, consulte Tutorial – Usando o conector de análise do OpenAI no Qlik Cloud.