Création d'une connexion OpenAI

Pour communiquer avec la plateforme OpenAI, créez une connexion à la source analytique OpenAI.

Pour communiquer avec OpenAI, créez une connexion à la source analytique OpenAI. Créez la connexion sur la page Créer du centre d'activités Analyses, de Éditeur de chargement de données ou de Script.

Les données reçues de ces connexions peuvent être utilisées dans le script de chargement et dans des expressions de graphique pour améliorer vos applications analytiques Qlik Sense.

Configurations et paramètres configurables

Configurez votre connexion analytique OpenAI à l'aide de l'une des configurations suivantes. Les autres paramètres configurables peuvent varier en fonction de la configuration utilisée.

OpenAI Completions API (GPT-3) - Rows

Cette configuration envoie chaque ligne de données sous forme de question à l'API Completions (par petits lots pour améliorer les performances). Chaque réponse est stockée sous forme de texte dans une table avec le même nombre de lignes que l'entrée.

Cette configuration peut s'utiliser aussi bien dans le script de chargement que dans des expressions de graphique.

Pour la documentation d'OpenAI sur l'API utilisée par cette configuration, voir Completions.

Paramètres configurables pour la configuration 'OpenAI Completions API (GPT-3) - Rows'
Champ	Description
Select Configuration (Sélectionner la configuration)	Sous Configuration, sélectionnez OpenAI Completions (GPT-3) - Rows.
Authorization (Autorisation)	Saisissez la clé API OpenAI. Pour plus d'informations, voir Génération d'une clé API OpenAI.
OpenAI Request (Requête OpenAI)	OpenAI Model (Modèle OpenAI) : modèle utilisé. Temperature (Température) : température d'échantillonnage à utiliser. Max Tokens (Nombre maxi. de jetons) : ce paramètre ajuste le nombre maximal de jeton à générer. En d'autres termes, il contrôle la taille de la réponse qui sera générée. Vous devrez quasiment toujours modifier la valeur par défaut pour que la connexion puisse fonctionner correctement en fonction de vos besoins. Top P : ajuste l'échantillonnage de noyau. Cette valeur peut être modifiée sous forme d'alternative à l'échantillonnage Temperature. Frequency Penalty (Pénalité de fréquence) : niveau suivant lequel le modèle pénalise les nouveaux jetons contenant du texte (verbatim) répété provenant de jetons existants. Presence Penalty (Pénalité de présence) : niveau suivant lequel le modèle pénalise les nouveaux jetons déjà contenus dans le texte jusqu'au point auquel ils sont introduits. User (Utilisateur) : ID de l'utilisateur final, qui peut faciliter la surveillance des violations de stratégie.
Association	Spécifie un Association Field (Champ d'association), à savoir, un champ de la table de données d'entrée contenant un identificateur unique. Il est obligatoire d'inclure ce champ dans les données sources lors du lancement d'une requête de point de terminaison pour que la table de résultats renvoyée soit associée à la table de champs source via une clé. Le champ désigné sera renvoyé sous forme de champ dans la réponse et permet l'association de la réponse aux données sources du modèle de données. Il peut s'agir de n'importe quel champ avec un ID unique, provenant des données sources ou faisant partie du processus de chargement de la table.
Name (Nom)	Nom de la connexion. Si vous ne saisissez pas de nom, le nom par défaut sera utilisé.

OpenAI Completions API (GPT-3) - JSON Tables

Cette configuration envoie une requête dans chaque ligne, où la réponse doit être une liste de données JSON. Le connecteur convertit la table JSON en table de données dans le modèle de données Qlik. Cette configuration doit être traitée comme expérimentale, en raison de la nature des réponses OpenAI.

Cette configuration peut être utilisée dans le script de chargement pour synthétiser les données. Elle n'est pas prévue pour être utilisée dans des expressions de graphique. Suivant la manière dont vous posez votre question, il se peut que vous n'obteniez pas toujours une réponse JSON valide.

Les modèles GPT prédiront ce à quoi ressemble le résultat JSON de façons pas forcément toujours exactes, par exemple, des nombres contenant du texte sans guillemets. Dans certains cas, il est possible de poser une question en ajoutant “as a JSON list” à la requête dans le script de chargement. Dans d'autres scénarios, vous devez être beaucoup plus spécifique pour obtenir le résultat souhaité.

Paramètres configurables pour la configuration 'OpenAI Completions API (GPT-3) - JSON Tables'
Champ	Description
Select Configuration (Sélectionner la configuration)	Sous Configuration, sélectionnez OpenAI Completions (GPT-3) - JSON Tables.
Authorization (Autorisation)	Saisissez la clé API OpenAI. Pour plus d'informations, voir Génération d'une clé API OpenAI.
OpenAI Request (Requête OpenAI)	OpenAI Model (Modèle OpenAI) : modèle utilisé. Temperature (Température) : température d'échantillonnage à utiliser. Max Tokens (Nombre maxi. de jetons) : ce paramètre ajuste le nombre maximal de jeton à générer. En d'autres termes, il contrôle la taille de la réponse qui sera générée. Vous devrez quasiment toujours modifier la valeur par défaut pour que la connexion puisse fonctionner correctement en fonction de vos besoins. Top P : ajuste l'échantillonnage de noyau. Cette valeur peut être modifiée sous forme d'alternative à l'échantillonnage Temperature. Frequency Penalty (Pénalité de fréquence) : niveau suivant lequel le modèle pénalise les nouveaux jetons contenant du texte (verbatim) répété provenant de jetons existants. Presence Penalty (Pénalité de présence) : niveau suivant lequel le modèle pénalise les nouveaux jetons déjà contenus dans le texte jusqu'au point auquel ils sont introduits. User (Utilisateur) : ID de l'utilisateur final, qui peut faciliter la surveillance des violations de stratégie.
Association	Spécifie un Association Field (Champ d'association), à savoir, un champ de la table de données d'entrée contenant un identificateur unique. Il est obligatoire d'inclure ce champ dans les données sources lors du lancement d'une requête de point de terminaison pour que la table de résultats renvoyée soit associée à la table de champs source via une clé. Le champ désigné sera renvoyé sous forme de champ dans la réponse et permet l'association de la réponse aux données sources du modèle de données. Il peut s'agir de n'importe quel champ avec un ID unique, provenant des données sources ou faisant partie du processus de chargement de la table.
Name (Nom)	Nom de la connexion. Si vous ne saisissez pas de nom, le nom par défaut sera utilisé.

OpenAI Chat Completions API (GPT-3.5, GPT-4) - Rows

Cette configuration fonctionne de la même manière que la configuration OpenAI Completions API (GPT-3) - Rows, mais elle envoie chaque ligne de données sous forme de requête à l'API OpenAI Chat Completions. Dans ce cas, les requêtes sont effectuées avec le rôle de message “user” et chaque ligne de données de Qlik est envoyée sous forme de requête distincte.

L'envoi de plusieurs lignes dans un contexte de chat n'est pas supporté. Vous devez inclure toutes les questions dans une seule ligne de requête.

Cette configuration peut s'utiliser aussi bien dans le script de chargement que dans des expressions de graphique.

Pour la documentation d'OpenAI sur l'API utilisée par cette configuration, voir Chat.

Paramètres configurables pour la configuration 'OpenAI Completions API (GPT-3.5, GPT-4) - Rows'
Champ	Description
Select Configuration (Sélectionner la configuration)	Sous Configuration, sélectionnez OpenAI Completions (GPT-3.5, GPT-4) - Rows.
Authorization (Autorisation)	Saisissez la clé API OpenAI. Pour plus d'informations, voir Génération d'une clé API OpenAI.
OpenAI Request (Requête OpenAI)	OpenAI Model (Modèle OpenAI) : modèle utilisé. Temperature (Température) : température d'échantillonnage à utiliser. Max Tokens (Nombre maxi. de jetons) : ce paramètre ajuste le nombre maximal de jeton à générer. En d'autres termes, il contrôle la taille de la réponse qui sera générée. Vous devrez quasiment toujours modifier la valeur par défaut pour que la connexion puisse fonctionner correctement en fonction de vos besoins. Top P : ajuste l'échantillonnage de noyau. Cette valeur peut être modifiée sous forme d'alternative à l'échantillonnage Temperature. Frequency Penalty (Pénalité de fréquence) : niveau suivant lequel le modèle pénalise les nouveaux jetons contenant du texte (verbatim) répété provenant de jetons existants. Presence Penalty (Pénalité de présence) : niveau suivant lequel le modèle pénalise les nouveaux jetons déjà contenus dans le texte jusqu'au point auquel ils sont introduits. User (Utilisateur) : ID de l'utilisateur final, qui peut faciliter la surveillance des violations de stratégie.
Association	Spécifie un Association Field (Champ d'association), à savoir, un champ de la table de données d'entrée contenant un identificateur unique. Il est obligatoire d'inclure ce champ dans les données sources lors du lancement d'une requête de point de terminaison pour que la table de résultats renvoyée soit associée à la table de champs source via une clé. Le champ désigné sera renvoyé sous forme de champ dans la réponse et permet l'association de la réponse aux données sources du modèle de données. Il peut s'agir de n'importe quel champ avec un ID unique, provenant des données sources ou faisant partie du processus de chargement de la table.
Name (Nom)	Nom de la connexion. Si vous ne saisissez pas de nom, le nom par défaut sera utilisé.

OpenAI Embeddings

Cette configuration envoie des lignes de texte d'entrée à l'API OpenAI Embeddings. OpenAI renvoie une représentation vectorielle distincte de chaque entrée. Cette représentation vectorielle se présente sous une forme qui peut être consommée par les modèles d'apprentissage machine.

Pour la documentation d'OpenAI sur l'API utilisée par cette configuration, voir Embeddings.

Paramètres configurables pour la configuration 'OpenAI Embeddings'
Champ	Description
Select Configuration (Sélectionner la configuration)	Sous Configuration, sélectionnez OpenAI Embeddings.
Authorization (Autorisation)	Saisissez la clé API OpenAI. Pour plus d'informations, voir Génération d'une clé API OpenAI.
OpenAI Request (Requête OpenAI)	OpenAI Model (Modèle OpenAI) : modèle utilisé. User (Utilisateur) : ID de l'utilisateur final, qui peut faciliter la surveillance des violations de stratégie.
Association	Spécifie un Association Field (Champ d'association), à savoir, un champ de la table de données d'entrée contenant un identificateur unique. Il est obligatoire d'inclure ce champ dans les données sources lors du lancement d'une requête de point de terminaison pour que la table de résultats renvoyée soit associée à la table de champs source via une clé. Le champ désigné sera renvoyé sous forme de champ dans la réponse et permet l'association de la réponse aux données sources du modèle de données. Il peut s'agir de n'importe quel champ avec un ID unique, provenant des données sources ou faisant partie du processus de chargement de la table.
Name (Nom)	Nom de la connexion. Si vous ne saisissez pas de nom, le nom par défaut sera utilisé.

Création de la connexion

Vous pouvez créer une connexion au connecteur analytique depuis le centre d'activités Analyses, depuis Éditeur de chargement de données dans une application existante ou depuis Script dans un script existant. Pour créer une connexion, procédez comme suit.

Procédez comme suit :

Créez une nouvelle application ou un nouveau script Qlik Sense. Ouvrez l'Éditeur de chargement de données ou l'Script.
Cliquez sur Créer une connexion.
Sous Espace, sélectionnez l'espace dans lequel sera placée la connexion.
Sous Sources analytiques, cliquez sur OpenAI.
Sélectionnez la Configuration nécessaire. Pour plus d'informations sur chaque option disponible, voir Configurations et paramètres configurables.
Saisissez votre clé API OpenAI. Pour plus d'informations, voir Génération d'une clé API OpenAI.
Sous OpenAI Model, sélectionnez le modèle OpenAI à utiliser.
Ajustez toute autre valeur de paramètre par défaut, si nécessaire. Ces paramètres sont décrits dans la documentation de l'API d'OpenAI. Pour plus d'informations, voir Chat, Completions et Embeddings.

Pour des descriptions supplémentaires des paramètres, voir Configurations et paramètres configurables.

Note InformationsVous devrez quasiment toujours modifier la valeur du paramètre Max Tokens pour que la connexion puisse fonctionner correctement en fonction de vos besoins. Ce paramètre contrôle la taille de la réponse qui sera générée.
Cliquez sur Créer.

La connexion de données est enregistrée dans l'espace dans lequel l'application est créée, afin de pouvoir être réutilisée dans d'autres applications et scripts Qlik Sense. Elle est également répertoriée sous Connexions de données dans Éditeur de chargement de données ou dans Script.

Une fois que vous avez créé la connexion, vous pouvez l'utiliser pour charger des données avec les requêtes et les réponses de la plateforme à ces requêtes. Vous pouvez également l'utiliser dans des expressions de graphique. Pour plus d'informations, voir Sélection et chargement de données depuis une connexion OpenAI et Utilisation de connexions OpenAI dans des expressions de visualisation.

Exemples détaillés

Pour des exemples complets de l'utilisation du connecteur analytique OpenAI, voir Didacticiel – Utilisation du connecteur analytique OpenAI dans Qlik Cloud.

En savoir plus

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici