AI Chat aide les marchands à analyser leurs données dans staging-wallee.com en posant des questions en langage naturel, sans écrire de SQL.
AI Chat s’appuie sur Analytics. Pour chaque question, il planifie une ou deux requêtes SQL sur les données d’Analytics, les exécute comme des requêtes analytiques ordinaires dans le compte et résume leurs résultats dans une réponse courte. Les données pouvant être analysées sont décrites dans le Schéma d’analyse.
AI Chat n’est pas actif pour tous les comptes. Pour les fonctions et les autorisations nécessaires, voir Accès et autorisations.
AI Chat est accessible dans le compte sous Compte > Analytique > Chat sur l’IA. L’entrée de menu n’est affichée que si la fonction Chat sur l’analyse de l’IA est active pour le compte et que l’utilisateur dispose de l’autorisation Chat sur l’analyse de l’IA, voir Accès et autorisations.
Figure 1. La page AI Chat avec les exemples de questions et les barres d’utilisation quotidienne.
La page comprend :
-
Zone de conversation : Vos questions précédentes et leurs réponses. Tant qu’il n’y en a aucune, un message de bienvenue avec trois exemples de questions est affiché.
-
Barres de consommation : La part des limites d’utilisation quotidiennes du compte déjà utilisée, voir Barres de consommation.
-
Champ de question : Le champ dans lequel vous saisissez votre question.
-
Remarques : De brefs rappels sous le champ de question, par exemple que les résultats générés par l’IA peuvent être inexacts et que l’utilisation quotidienne est réinitialisée à minuit UTC, ainsi que le lien
Donnez votre avis.
Saisissez votre question dans le champ de question et appuyez sur Enter ou cliquez sur le bouton d’envoi.
Appuyez sur Shift+Enter pour commencer une nouvelle ligne.
Une question doit contenir au moins 3 caractères et peut en contenir jusqu’à 2000.
Un clic sur l’un des exemples de questions l’envoie immédiatement.
Vous ne pouvez poser qu’une question à la fois. Pendant l’analyse d’une question, le champ de question est désactivé. Si l’une de vos analyses est encore en cours, par exemple dans un autre onglet du navigateur, une nouvelle question est refusée avec le message "Vous avez déjà une analyse en cours. Veuillez attendre sa fin et réessayer."
AI Chat fonctionne le mieux avec des questions qui précisent ce qu’il faut mesurer, sur quelle période et comment regrouper le résultat. Par exemple :
-
Combien de transactions réussies avons-nous eues par mois au cours des six derniers mois ?
-
Quels modes de paiement ont eu le plus de tentatives de débit échouées la semaine dernière ?
-
Quel a été le montant total remboursé par devise le mois dernier ?
-
Quel est le taux de réussite des tentatives de débit par mode de paiement au cours des 30 derniers jours ?
Conseils :
-
Indiquez la période : Si une question n’indique aucune période, toutes les données disponibles sont utilisées.
-
Soyez précis : Les questions générales comme "Comment se porte mon activité ?" reçoivent une vue d’ensemble fondée sur des hypothèses raisonnables. Des questions précises mènent à des réponses précises.
-
Mentionnez explicitement les données de test : Par défaut, seuls les paiements de production sont analysés, voir Données de test et de production.
AI Chat répond uniquement aux questions portant sur les données d’Analytics. Les autres questions, par exemple de culture générale ou de programmation, sont refusées avec le message "Il n’a pas été possible de répondre à cette question. Veuillez poser une question sur vos données analytiques." Les demandes de conseils, par exemple sur la manière de réduire les rétrofacturations, reçoivent généralement une courte réponse textuelle qui explique à quelles questions sur les données il est possible de répondre à la place.
AI Chat n’a pas de mémoire de conversation. Chaque question est analysée indépendamment, et les questions et réponses précédentes ne sont pas prises en compte. Une question de suivi doit donc contenir tous les détails nécessaires.
Exemple :
-
Après la question "Quel a été le montant total des transactions par devise le mois dernier ?", la question de suivi "Et par mode de paiement ?" ne peut pas être comprise.
-
Demandez plutôt "Quel a été le montant total des transactions par devise et par mode de paiement le mois dernier ?".
Après l’envoi d’une question, sa carte de réponse affiche la progression de l’analyse selon les étapes suivantes :
-
Comprendre votre question
-
Récupération des schémas de données pertinents
-
Approche de l’analyse de la planification
-
Exécution des requêtes : une ligne par requête avec sa description, son statut, le nombre de lignes et un bouton
Afficher SQL -
Préparer votre résumé
Figure 2. La progression d’une question en cours d’analyse.
Une analyse peut prendre quelques minutes. Vous pouvez quitter la page et revenir plus tard, car la réponse est conservée dans votre historique des conversations. Si l’analyse est encore en cours lorsque vous rouvrez la page, sa progression est de nouveau affichée et la page continue d’attendre la réponse.
Si l’analyse dure plus d’environ dix minutes, la page cesse d’attendre et affiche le message "Votre analyse est en cours de traitement. Le résultat apparaîtra dans la conversation lorsqu’il sera prêt." Rouvrez la page plus tard pour voir la réponse.
À l’ouverture de la page, vos conversations les plus récentes dans le compte sont chargées, la plus récente se trouvant en bas.
Pour en charger davantage, cliquez sur Charger les anciennes conversations en haut de la zone de conversation.
L’historique est personnel : chaque utilisateur ne voit que ses propres conversations dans le compte. Les questions dont l’analyse a échoué sont affichées avec leur message d’erreur. Les questions refusées avant le début de l’analyse, par exemple parce qu’une limite était atteinte, ne sont pas conservées dans l’historique.
|
Note
|
Les réponses sont générées par l’IA. Les règles décrites dans ce chapitre indiquent comment AI Chat est conçu pour construire ses réponses, elles ne sont pas garanties pour chaque réponse. Pour les chiffres importants, vérifiez les requêtes à l’origine de la réponse, voir Détails techniques et SQL. |
La réponse est un court résumé rédigé dans un langage métier simple. Lorsque c’est utile, elle est mise en forme avec des titres, des listes et des tableaux. AI Chat ne dessine ni graphiques ni images.
AI Chat est conçu pour rapporter les chiffres trouvés dans les données, et non pour donner des conseils commerciaux ou supposer des causes qui ne ressortent pas des données. Les montants sont affichés avec leur devise, et les grands nombres avec des séparateurs de milliers.
L’heure de chaque question et de chaque réponse est affichée dans l’heure locale de votre navigateur.
Figure 3. Une réponse terminée.
Le texte de la réponse ne contient pas de SQL. Les requêtes à l’origine d’une réponse sont listées dans la section Détails techniques située en dessous, qui est réduite par défaut. Son en-tête indique le nombre de requêtes exécutées et la durée totale de traitement.
Pour chaque requête, la section affiche :
-
Description : Ce que la requête récupère, généralement avec ce que représente une ligne du résultat et la période couverte.
-
Statut et lignes : Si la requête a été terminée, a échoué ou a été refusée, et combien de lignes elle a renvoyées.
-
Voir la requête : Ouvre les détails de l’exécution de la requête dans un nouvel onglet. Le fichier de résultat peut y être téléchargé au format
CSV, comme pour toute autre requête analytique. Chaque téléchargement du fichier de résultat est payant. -
SQL : Affiche le SQL de la requête.
-
Erreur : Pour une requête qui a échoué ou a été refusée, la raison.
Figure 4. Les détails techniques d’une réponse avec le SQL d’une requête.
AI Chat ne dispose pas de fonction d’export ou de téléchargement propre, et il ne peut pas ouvrir une requête dans l’éditeur de requêtes. Pour modifier une requête ou l’exécuter à nouveau, copiez son SQL et collez-le dans l’éditeur de requêtes sous Compte > Analytique > Soumettre une requête.
Les requêtes d’AI Chat renvoient un nombre limité de lignes.
Si un résultat est trop long pour être affiché en entier, la réponse en affiche généralement une sélection, par exemple les 10 entrées les plus récentes, et indique combien de lignes ne sont pas affichées.
Pour obtenir toutes les lignes d’une requête, cliquez sur Voir la requête et téléchargez son fichier de résultat.
Si la requête a atteint sa limite de lignes, copiez le SQL dans l’éditeur de requêtes et augmentez la valeur de sa clause LIMIT.
-
Toutes les dates et heures sont en UTC, et les semaines commencent le lundi.
-
AI Chat travaille avec des données mises à jour une fois par jour. Les données les plus récentes, par exemple les transactions du jour, peuvent ne pas encore être incluses. La réponse indique généralement jusqu’à quelle date et quelle heure (UTC) vont les données.
-
Si une question n’indique aucune période, toutes les données disponibles sont utilisées, et la réponse se réfère généralement à l’ensemble de la période.
-
Une période encore en cours, comme le mois en cours, est signalée comme partielle, par exemple par "à ce jour". La réponse commence généralement par la dernière période complète et ne compare pas une période partielle à une période complète. Les comparaisons portent sur des périodes complètes ou sur des fenêtres de même durée, par exemple le mois en cours à ce jour et les mêmes jours du mois précédent.
-
Si certains détails ne sont enregistrés que pour des périodes plus récentes, la réponse le signale généralement au lieu d’indiquer zéro pour les périodes antérieures.
Les montants sont présentés par devise :
-
Les montants dans des devises différentes ne sont jamais additionnés en un seul total.
-
Au lieu d’un seul leader global, le leader de chaque devise est nommé.
-
Les classements de montants, comme le top 10, sont établis au sein de chaque devise.
Sauf si une question porte explicitement sur des données de test, AI Chat analyse uniquement les paiements de production. Pour analyser les paiements de test, indiquez-le dans la question, par exemple "Combien de transactions de test avons-nous eues la semaine dernière ?".
-
Un taux indique s’il est basé sur le nombre ou sur le montant des transactions.
-
Les taux de réussite et d’échec par mode de paiement ou par processeur sont calculés à partir des tentatives de débit, et la réponse le précise.
-
Les décomptes de transactions échouées n’incluent que les transactions avec une tentative de débit échouée. Les transactions qui ont échoué sans aucune tentative de débit, par exemple les checkouts abandonnés ou expirés, ne sont pas incluses, et la réponse le signale.
-
Certaines requêtes ont échoué : Une remarque au-dessus de la réponse explique que certaines requêtes n’ont pas pu être terminées et que la réponse repose sur les autres résultats. Si certaines requêtes n’ont pas été exécutées parce que la limite quotidienne des coûts d’Analytics était atteinte, la remarque l’indique à la place. Les requêtes échouées et leurs erreurs sont listées dans les détails techniques. Si l’utilisateur ne dispose pas des autorisations requises, si le compte n’est pas actif ou si AI Chat est désactivé, aucune réponse n’est affichée et la question échoue avec le message correspondant, voir Accès et autorisations.
-
Résultat trop volumineux : Si les résultats sont trop volumineux pour être résumés, aucun résumé n’est affiché. À la place, la remarque "Le jeu de résultats est trop volumineux pour être résumé automatiquement. Ouvrez les requêtes ci-dessous pour afficher les résultats complets." est suivie d’un lien vers chaque requête, où le résultat complet peut être consulté.
-
Aucune donnée correspondante : Une requête qui ne trouve aucune donnée est listée avec 0 ligne, et la réponse indique généralement qu’aucun enregistrement ne correspond à ses filtres, sans supposer de cause.
Les questions peuvent être posées dans n’importe quelle langue. La réponse et les descriptions des requêtes sont généralement rédigées dans la langue de la question. Les textes de la page elle-même, comme les étapes de progression, les remarques et les messages d’erreur, sont affichés dans la langue de votre interface utilisateur.
Sous chaque réponse terminée, évaluez la réponse avec le bouton pouce levé ou pouce baissé.
Ajoutez éventuellement un commentaire, puis cliquez sur Soumettre un commentaire pour enregistrer l’évaluation.
L’évaluation reste visible dans l’historique des conversations.
Pour donner un avis général sur AI Chat, cliquez sur Donnez votre avis sous le champ de question.
Si vous préférez travailler avec SQL, l’éditeur de requêtes sous Compte > Analytique > Soumettre une requête peut transformer une description des données dont vous avez besoin en requête SQL.
Cette fonction s’appelle Traduction de l’invite en SQL.
Elle est indépendante d’AI Chat et dispose de sa propre fonction et de sa propre autorisation, voir Accès et autorisations.
Si elle est disponible, la barre d’outils de l’éditeur affiche un bouton Générer SQL.
-
Cliquez sur
Générer SQL. -
Décrivez les données que vous souhaitez récupérer, par exemple "Montrez-moi le montant total des transactions par jour pour les 7 derniers jours", et cliquez sur
Générer SQL. -
Vérifiez le SQL affiché sous SQL généré.
-
Cliquez sur
Utilisez cette requêtepour remplacer le contenu de l’éditeur par le SQL généré, ou cliquez surRéessayerpour modifier la description. -
Cliquez sur
Soumettrepour exécuter la requête comme d’habitude.
Figure 5. Génération d’une requête SQL à partir d’une description dans l’éditeur de requêtes.
Le SQL généré est une requête unique sans résumé, et il n’est exécuté que lorsque vous le soumettez.
Par défaut, il ne couvre généralement que les paiements de production.
Vérifiez toujours le SQL avant de le soumettre.
Après une traduction, vous pouvez l’évaluer avec le bouton pouce levé ou pouce baissé et cliquer sur Soumettre.
L’onglet Requêtes générées du panneau des actifs liste vos dernières requêtes générées. Cliquez sur une entrée pour charger son SQL dans l’éditeur.
La génération de SQL est décomptée de la même limite quotidienne des coûts d’IA et des mêmes limites par minute qu’AI Chat, et la boîte de dialogue affiche la barre d’utilisation Est. Coût de l’IA. Elle n’est pas décomptée de la limite quotidienne des coûts d’Analytics, car aucune requête n’est exécutée tant que vous ne l’avez pas soumise.
AI Chat est soumis à des limites configurées pour chaque compte :
-
Coût d’IA estimé quotidien : Le coût estimé du traitement par l’IA de toutes les questions et de toutes les requêtes SQL générées du compte pour la journée en cours.
-
Coût d’Analytics estimé quotidien : Le coût estimé des requêtes analytiques exécutées par AI Chat dans le compte pour la journée en cours.
-
Demandes par minute pour le compte : Le nombre de demandes que tous les utilisateurs du compte peuvent envoyer ensemble en une minute.
-
Demandes par minute par utilisateur : Le nombre de demandes qu’un seul utilisateur peut envoyer en une minute.
Les questions posées à AI Chat et les requêtes SQL générées sont décomptées ensemble des limites par minute. Les limites quotidiennes s’appliquent à la journée UTC et sont réinitialisées à minuit UTC.
La limite quotidienne des coûts d’Analytics est vérifiée avant le lancement des requêtes. Les requêtes déjà en cours lorsque la limite est atteinte ne sont pas arrêtées, de sorte que l’utilisation d’une journée peut dépasser légèrement la limite.
Pour modifier les limites de votre compte, contactez votre responsable de compte.
Au-dessus du champ de question, deux barres indiquent la part des limites quotidiennes que le compte a utilisée aujourd’hui :
-
Est. Coût de l’IA (UTC)
-
Est. Coût de l’analyse (UTC)
Une barre devient orange à partir de 50 % et rouge à partir de 80 %. Les barres sont mises à jour après chaque réponse. Si une valeur ne peut pas être déterminée, sa barre est masquée.
Lorsqu’une limite est atteinte, la question n’est pas analysée et l’un des messages suivants est affiché :
| Message | Signification |
|---|---|
Trop de demandes. Veuillez patienter un moment avant de réessayer. |
Vous avez envoyé trop de demandes en une minute. Patientez un moment et réessayez. |
Trop de demandes pour ce compte. Veuillez patienter un moment. |
Les utilisateurs du compte ont envoyé trop de demandes en une minute. Patientez un moment et réessayez. |
Estimation journalière. Limite des coûts d’IA atteinte (N% utilisé). Veuillez réessayer demain. |
La limite quotidienne du coût d’IA estimé du compte est atteinte. N est la part de la limite déjà utilisée. |
La limite quotidienne des coûts d’analyse est atteinte (N% utilisé). Veuillez réessayer demain. |
La limite quotidienne du coût d’Analytics estimé du compte est atteinte. N est la part de la limite déjà utilisée. |
Limite d’utilisation quotidienne atteinte pour ce compte. Veuillez réessayer demain. |
Une limite quotidienne du compte est atteinte. |
Figure 6. Un message affiché lorsqu’une limite quotidienne du compte est atteinte.
AI Chat n’est disponible dans un compte que si les fonctions Analytique et Chat sur l’analyse de l’IA sont actives pour le compte. Sinon, l’entrée de menu n’est pas affichée et la page ne peut pas être ouverte.
AI Chat peut également être désactivé pour un seul compte. Dans ce cas, la page affiche le message "AI Analytics Chat n’est pas disponible pour ce compte." et aucune question ne peut être posée. Il en va de même pour un compte qui n’est pas actif, avec le message "Votre compte n’est pas actif."
Pour utiliser AI Chat, un utilisateur a besoin des autorisations de compte suivantes :
-
Chat sur l’analyse de l’IA : Permet à l’utilisateur d’utiliser AI Chat.
-
Exécution des requêtes analytiques : Permet à l’utilisateur d’exécuter des requêtes analytiques.
-
Lire (Account Admin analytics) : Permet à l’utilisateur d’accéder à Analytics dans le compte.
Si l’une de ces autorisations manque, l’entrée de menu n’est pas affichée, ou la page affiche le message "Vous n’êtes pas autorisé à utiliser AI Analytics Chat dans ce compte." Pour plus d’informations sur les rôles et les autorisations, voir le Concept d’autorisation.
Accès aux données :
-
AI Chat utilise le même accès aux données qu’Analytics. Il répond uniquement à partir des tables que l’utilisateur est autorisé à interroger, et ses requêtes sont exécutées avec les autorisations de l’utilisateur dans le compte.
-
Si l’utilisateur ne peut interroger aucune table, les questions sont refusées avec le message "Les données nécessaires pour répondre à cette question ne sont pas accessibles."
-
Si une question nécessite des données d’une table que l’utilisateur ne peut pas interroger, la requête correspondante est refusée. Son erreur dans les détails techniques est "Les données nécessaires pour répondre à cette question ne sont pas accessibles.", et la réponse repose sur les autres requêtes. Si toutes les requêtes sont refusées, la question échoue avec ce message.
Traduction de l’invite en SQL :
Le bouton Générer SQL de l’éditeur de requêtes nécessite la fonction Traduction de l’invite en SQL pour le compte et l’autorisation Traduction de l’invite en SQL pour l’utilisateur.
Il ne nécessite ni la fonction ni l’autorisation d’AI Chat.
Lorsque AI Chat est désactivé pour le compte, la génération de SQL n’est pas disponible non plus, et la boîte de dialogue affiche le message "La conversion de l’invite en SQL n’est pas disponible pour ce compte."
Besoin de modifications d’accès ?
Si vous avez besoin d’accéder à AI Chat ou à des tables supplémentaires, veuillez consulter votre responsable de compte.
-
L’IA peut se tromper : Les résultats générés par l’IA peuvent être inexacts. Vérifiez les chiffres importants, par exemple en examinant le SQL et le résultat des requêtes dans les détails techniques.
-
Lecture seule : AI Chat exécute uniquement des requêtes analytiques. Il ne peut modifier aucune donnée ni aucun paramètre du compte.
-
Une question à la fois : Attendez la réponse avant de poser la question suivante.
-
Pas de mémoire de conversation : Répétez tous les détails dans une question de suivi.
-
Données récentes : Les données les plus récentes peuvent ne pas encore être incluses. Vérifiez dans la réponse jusqu’à quand vont les données.
-
Résultats complets : Pour des listes complètes ou un traitement ultérieur, cliquez sur
Voir la requêtedans les détails techniques et téléchargez le fichier de résultat. -
Pas de graphiques : Les réponses ne contiennent que du texte et des tableaux.
| Message | Que faire |
|---|---|
Aucune source de données pertinente n’a été trouvée pour cette question. Veuillez reformuler votre question. |
Reformulez la question avec des termes des données, comme transactions, remboursements ou tentatives de débit. |
Impossible de générer un plan d’analyse. Essayez de reformuler votre question. |
Formulez la question plus simplement ou de manière plus précise. |
Cette question n’a pas pu être transformée en requête valide. Veuillez essayer de reformuler votre question. |
Formulez la question plus simplement ou de manière plus précise. |
Les requêtes n’ont pas pu être complétées. Veuillez essayer de reformuler votre question. |
Formulez la question plus simplement ou de manière plus précise, par exemple en demandant une période plus courte. |
Les données nécessaires pour répondre à cette question ne sont pas accessibles. |
L’utilisateur ne peut pas interroger les données nécessaires à la question, voir Accès et autorisations. |
L’analyse a été interrompue. Veuillez réessayer. |
Réessayez, ou limitez la question, par exemple à une période plus courte. |
Le service d’analyse est actuellement indisponible. Veuillez réessayer plus tard. |
Réessayez plus tard. |