Configuration de ChatGPT dans Merlin Backoffice® Flex

Accès à ChatGPT dans le module Merlin Backoffice ® Flex pour PrestaShop

L'interface de dialogue avec ChatGPT a été intégrée dans MagicEdit, outil déjà largement utilisé et sans doute l'un de vos préférés. Plusieurs raisons à ce choix :

• Outil déjà maitrisé par beaucoup, donc nouvel apprentissage facile.
• Mémorisation pour ré-utilisation des réglages par colonne.
• Fonction de prévisualisation du résultat et d'annulation possible (undo).
• Rapide et simple d'utilisation. Ne nécessite aucune compétence en programmation ou connaissance technique.
• A présent automatisable avant importation pour modifier le contenu de fichier CSV ou Excel automatiquement.

Ouvrir MagicEdit :

1. Dans n'importe quelle table, celle des produits, des catégories, des traductions, des images (légendes), voir même celle affichant le contenu d'un fichier avant importation, sélectionnez les lignes à modifier puis faites un clic droit dans la colonne à remplir.
2. Cliquez sur le lancement de MagicEdit, soit limité aux lignes sélectionnées, soit s'appliquant à toutes les lignes affichées.

Dérouler le bloc Intelligence Artificielle :

MagicEdit est constitué d'une série de blocs. Chaque bloc constitue une fonctionnalité, comme "Chercher  / remplacer", "Ajouter un texte" etc...

Le bloc IA est tout en bas :

 

Obtenir une clé API

Quel que soit le moteur IA que vous souhaitez utiliser (ChatGPT, Mistral, Gemini, Perplexity...), il faut demander une clé API.

Clé AI OpenAI, pour ChatGPT

Rien de plus simple et classique, allez sur le site d'OpenAi Platform et cliquez sur le bouton Log in en haut à droite.

Attention, ne confondez pas le site de ChatGPT et le site de l'API, OpenAI Platform.

Vous pourrez alors créer un nouveau compte à partir d'une adresse email et mot de passe, ou à partir de votre compte Google.

Demandez une clé d'API pour ChatGPT

Une fois le compte créé et connecté, il faut demander une clé secrète, ou API key. Pour cela :

• Cliquez sur le nom de votre compte en haut à droite.
• Puis dans le menu qui s'est ouvert, cliquez sur "View API keys".
• Ou bien directement sur "API Keys" dans le menu de la page à gauche.
• Une fois dans la page d'administration des clés, cliquez sur "Create new secret key".

Copiez la valeur de la clé et conservez la précieusement (impossible de la récupérer à nouveau, elle est définitivement masquée)

Acheter des crédits d'utilisation de l'API OpenAI 

Oui demander une clé est gratuit. Mais l'utiliser est payant, facturé à la consommation (aux tokens).

Pour pouvoir dialoguer avec l'API, il faut aussi avoir acheté au moins quelques euros de crédits chez OpenAI.

L'achat de crédits (minimum 5€) se fait depuis la même page sur OpenAI platform.

NOTE : un abonnement à ChatGTP Pro n'est pas demandé et ne sert à rien. Cela est non corrélé à l'usage de l'API.

Clé API chez les autres fournisseurs

Vous êtes libre d'utiliser un autre fournisseur qu'OpenAI, à condition d'en choisir qui un propose un ou des API 100% compatibles avec l'API d'OpenAI.

Beaucoup indiquent en effet être compatible mais cette compatibilité est souvent partielle. Elle peut être complète un jour et ne plus l'être le lendemain, l'API d'OpenAI évoluant constamment et très rapidement.

Cependant, à ce jour, nous avons pu tester avec succès la compatibilité de l'offre de Mistral AI, solution 100% française qui mérite à être plus connue (Le chat) et dans une moindre mesure l'offre Gemini de Google. Nous n'avons pas testé l'API Perplexity de Microsoft.

Les modèles de facturation peuvent varier. Par exemple chez Mistral AI, la clé est également gratuite et vous n'avez pas de crédits à acheter à l'avance. Vous devez cependant fournir un moyen de paiement et vous êtes facturés à postériori selon votre consommation.

L'API Gemini permet les premiers usages gratuitement.

Saisir au moins une clé dans MagicEdit 

En effet la seule étape de configuration réellement obligatoire est de saisir à minima une clé d'API d'un fournisseur :

1. Cliquez sur le bandeau pour dérouler le bloc IA.
2. Champs de saisie de la clé API nécessaire pour utiliser les moteurs d'openAI (ChatGTP).
3. Champs de saisie de la clé API nécessaire pour utiliser les moteurs de Mistral AI (concurrent français crédible). 
4. Champs de saisie de la clé API nécessaire pour utiliser les moteurs des autres marques compatibles (ex : Google Gemini ou Perplexity de Microsoft ou autres).  Compatibilité non garantie.

Choix du modèle et du end point

Chaque fournisseur propose une liste variée de modèles, qui évolue sans cesse. Chacun à des caractéristiques, des puissances, des coûts, des vitesses, des capacités différentes. A vous de choisir celui qui convient le mieux à votre besoin.

Depuis la version 4.0.0 de Merlin Backoffice Flex, la liste est automatiquement mise à jour à chaque ouverture de MagicEdit. 

1. Choisissez le moteur à utiliser parmi la liste proposée. Attention la liste est construite dynamiquement et nécessite une ou plusieurs clé API valides (obtenue en interrogeant les API, donc consomme un usage, mais ne consomme pas de tokens).
   
   
2. Remarquez que vous pouvez aussi manuellement ajouter un modèle manquant et en supprimer.
   
   
3. Selon le choix du fournisseur et du moteur, la seconde liste permettant de choisir le end point (ou URL du moteur) est mise à jour automatiquement. Choisissez dans la liste proposée un "Endpoint" adapté à votre besoin (ils ont eux aussi des spécificités et capacités différentes, renseignez vous auprès du fournisseur de l'API). Le premier de la liste est celui conseillé par défaut.

Gestion de la mémoire de l'IA

Les moteurs IA récents, comme ChatGPT5 et 5.1 ont une mémoire, leur permettant de continuer une conversation précédente en ayant accès au contenu de celle-çi. 

Dans le cadre de l'utilisation de l'IA sur plusieurs colonnes successivement, cette mémoire apporte de nombreux avantages :

• Les consignes communes peuvent n'être communiquées qu'une seule fois au début, pour l'ensemble des colonnes.
• On peut lui demander de ré-utiliser les résultats obtenus lors du traitement des colonnes précédentes.

Par exemple, lors de l'étape de remplissage des descriptions longues, lui demander d'extraire et mémoriser les mots les plus important pour le SEO. Puis lors du remplissage des méta descriptions, lui demander de ré-utiliser si possible les mots clés mémorisés pour chaque ligne. Il faudra juste lui donner un index dans les deux prompts, tel que l'identifiant produit pour qu'il synchronise bien les lignes.

MagicEdit vous permet d'activer ou non cette conservation en mémoire du contenu de la conversation et de la réinitialiser car vous le jugez nécessaire (nouveau prompt sans rapport avec les précédents):

Réglages de la longueur et réglages experts

Ces autres réglages pourront soit n'être réalisés également qu'une fois pour toutes, soit ajustés à chaque utilisation, selon que vous ayez beaucoup de scénarios d'usages différents ou pas. Ils sont en effet mémorisés dans la configuration courante de MagicEdit, avec tous les autres réglages de la fenêtre (à l'exception donc des réglages des limites décrites au chapitre précédent) :

Longueur de la réponse (1)

Défini la taille maxi en "jetons"de la réponse demandée à GPT. Une valeur de 1000 jetons donne approximativement 700 mots.

500 jetons est une valeur demandant une réponse courte et consommant donc moins de crédit.

Selon votre budget et le champ de destination (par exemple la description longue), vous pouvez largement augmenter ce paramètre.

Souvenez-vous que vous pouvez aussi indiquer dans le prompt lui même la longueur de la réponse souhaitée, même si ChatGPT a plutôt tendance à faire des réponses plus longues que demandées.

A savoir :  en version gratuite, le nombre de jetons maximal pour une discussion est de 4096, mais questions  comprises (vos consignes et prompts compris, sachant que les prompts N°2 à 4 contiennent eux-mêmes les prompts et réponses précédentes !, ça grimpe vite). 

Donc si vous choisissez une valeur de 3000 pour la réponse, cela vous limite à  1096 jetons pour l'ensemble de la consigne et des prompts.

Ce qui signifie qu'en version gratuite, vous devrez bien souvent vous contenter d'un seul prompt (voir tutoriel suivant qui explique ce concept).

Température (3)

La température d'échantillonnage, entre 0 et 1, définit le  coté plus ou mois aléatoire de la réponse fournie. 

Des valeurs élevées comme 0,8 rendront la sortie plus aléatoire, tandis que des valeurs plus faibles comme 0,2 la rendront plus ciblée et déterministe. 

L'aide de l'API indique que si il est fixé à 0, le modèle utilisera la probabilité logarithmique pour augmenter automatiquement la température jusqu'à ce que certains seuils soient atteints.

Avec la valeur maxi de 1, vous êtes presque sûr d'avoir toujours une réponse différente à chaque fois que la même question est posée à ChatGPT.

Effort de raisonnement (7)

Contrôle la profondeur de réflexion du modèle. La qualité de la réponse, mais aussi le temps de traitement et le coût augmentent avec la complexité de réflexion demandée.

Pour les autres paramètres, on vous laisse consulter la documentation de l'API.

Veuillez noter que la plupart de ces paramètres ne sont pas compatibles avec tous les fournisseurs, ni même avec tous les moteurs. Désactivez ceux qui génèrent des échecs en fonction du moteur utilisé.

1. Longueur de la réponse.
2. Top_p
3. Température
4. Pénalité de présence
5. Pénalité de fréquence
6. Graine (aléatoire)
7. Effort de raisonnement

Voilà la configuration est à présent terminée, il vous reste à apprendre à dialoguer avec l'IA. Rendez-vous pour cela dans le second tutoriel de cette section. 

OBSOLETE : Configuration des limites de ChatGPT

DEPUIS LA VERSION 4.0.0 de Merlin Backoffice Flex, il n'est plus nécessaire de configurer les limites. Ce chapitre est conservé ici uniquement pour ceux qui n'ont pas encore fait la mise à jour de l'application.

Que vous ayez uniquement un compte OpenAI gratuit pour ChatGPT 3.5 ou payant donnant accès à GPT-4, l'usage est restreint par certaines limites à connaitre.

Cela concerne le nombre d'interactions à la minute et à la journée, le volume de mots échangés par question et par jour...  

Ces limites ont une valeur générique que vous pourrez retrouver dans la documentation officielle de l'API et sur votre compte OpenAI, mais il est possible d'acheter auprès d'OpenAI des droits supplémentaires.

Merlin Backoffice intègre une gestion automatique de vos droits  dans les échanges avec ChatGPT, de manière à ne jamais dépasser une des limites. Si par exemple vous avez droit à 3 requêtes par minute, et que vous venez d'en envoyer 3 en 20 secondes, il va attendre 40 secondes avant d'envoyer la quatrième de sa liste.

Pour cela il a besoin de connaitre les limites associées à votre compte. Par défaut il est configuré avec les valeurs standards pour ChatGPT 3.5 en version gratuite. A vous de les modifier si elles ne correspondent pas à votre compte. Les bulles d'aide des champs de configuration vous assistent en indiquant aussi les valeurs standards pour ChatGPT4.

Ces données étant susceptibles d'évoluer, consulter la source officielle : https://platform.openai.com/docs/guides/rate-limits/overview

Ces valeurs sont ensuite stockées dans Merlin Backoffice Flex, mais ne sont pas spécifiques à chaque configuration de MagicEdit. Ces réglages ne seront donc à faire qu'une seule fois au premier usage, et non pas à chaque usage. 

Limite de débit

Il s'agit du nombre de requêtes maxi par minute autorisées par ChatGTP.

Cela correspond pour MagicEdit, au nombre de prompts maxi qu'il doit traiter par unité de temps.

La limite le force donc à ralentir pour ne pas générer de refus de traitement par le robot. 

En version gratuite, la valeur par défaut est seulement de 3 requêtes par minutes.

En version payante, la limite est de 60 requêtes par minutes les premières 48 heures puis 3500 requêtes par minutes, largement suffisant vu la vitesse de réponse du moteur.

A noter qu'avec GPT4 il y a aussi une limite supplémentaire, qui est actuellement est de 50 requêtes toutes les 3 heures.

Mettre 0 ou laisser vide pour ne pas fixer de limite.

Limite de débit supplémentaire

Il s'agit d'une seconde limite du nombre de requêtes maxi mise en place lors du lancement de GTP-4. Est fixé actuellement à 50 requêtes par tranche de 3 heures (180 minutes)

Ne s'applique pas à GPT-3. Si vous n'utilisez pas GTP-4, mettre 0 dans ce champs ou laissez le vide pour ne pas imposer cette limite à Merlin Backoffice Flex.

Limite journalière

Il s'agit du nombre de requêtes maxi par jour autorisées par ChatGTP.

Cela correspond pour MagicEdit, au nombre de prompts maxi qu'il doit traiter par jour calendaire. Compteur remis à zéro à minuit.

La limite le force donc à ralentir pour ne pas générer de refus de traitement par le robot. 

En version gratuite, la valeur par défaut est seulement de 200 requêtes par jour.

En version payante, la limite est de 2000 échanges par minutes les premières 48 heures puis sans limite.

Mettre 0 ou laisser vide pour ne pas fixer de limite.

Limite de taille

Il s'agit du nombre de jetons maxi par jour autorisés par ChatGTP.

Pour rappel une valeur de 1000 jetons donne approximativement 700 mots.

Cela correspond pour MagicEdit, au nombre de jetons maxi qu'il doit traiter par jour.

La limite le force donc à ralentir pour ne pas générer de refus de traitement par le robot. 

En version gratuite, la valeur par défaut est seulement de 40000 jetons par jour.

En version payante, la limite est de 120000 jetons par jour les  premières 48 heures puis 180000.

Mettre 0 ou laisser vide pour ne pas fixer de limite.

1. Limite de débit
2. Limite de débit supplémentaire
3. Limite journalière
4. Limite de taille