L'API Conversational Analytics est un outil puissant qui vous permet d'interroger vos données en langage naturel. Cette page explique comment formuler des questions efficaces pour obtenir le résultat idéal. Cette page présente les bonnes pratiques pour les actions suivantes :
- Poser des questions d'ordre général
- Posez des questions en plusieurs parties pour des analyses plus complexes
- Poser des questions avec des conditions de données
- Demander l'agrégation de données
- Poser des questions complémentaires
- Demander des résultats mis en forme
Poser des questions générales
Lorsque vous posez des questions générales, soyez précis et fournissez du contexte. Au lieu de poser des questions générales, précisez votre requête en incluant des détails pertinents, comme des dates, des catégories spécifiques ou des filtres numériques.
Exemple
Question d'origine : "Combien de factures sont créées manuellement et systématiquement chaque année ?"
Question affinée : "Indique le nombre de factures créées manuellement et systématiquement chaque année. En supposant qu'il faut 15 minutes pour créer une facture manuelle, calcule également et résume le temps total nécessaire en heures pour traiter toutes les factures manuelles."
Pourquoi ça marche : la question affinée ajoute une exigence de calcul spécifique (temps passé sur les factures manuelles) et spécifie un format de sortie, un résumé.
Poser des questions en plusieurs parties pour des analyses plus complexes
Décomposez les questions complexes en plusieurs parties pour aider l'API Conversational Analytics à traiter chaque composant avec précision.
Exemple
Question d'origine : "Quel est le délai de traitement moyen en jours des paiements en espèces à la livraison et des paiements pour chaque type de créance (PHA, remise coopérative, carte de crédit, retail media) ? Quel pourcentage de ces paiements sont traités manuellement ? En supposant que nous consacrons 15 minutes à chaque compte client soldé manuellement, combien de temps consacrons-nous à l'application de trésorerie et à la compensation pour chaque type de compte client chaque année ?"
Question affinée, partie 1 : "Quel est le délai de traitement moyen en jours pour chaque type de créance entre le 5 mai 2025 et le 1er juin 2025 ?"
Question affinée, partie 2 : "Quel est le pourcentage de compensations manuelles entre le 5 mai 2025 et le 1er juin 2025 pour chaque type de créance ?"
Question affinée, partie 3 : "En supposant que nous consacrons 15 minutes à chaque compte client soldé manuellement, combien de temps passons-nous sur l'application de paiement et à solder chaque type de compte client chaque année ?"
Pourquoi ça marche : en posant les questions séparément, l'API Conversational Analytics peut traiter chaque métrique spécifique (délai moyen, pourcentage de clôtures manuelles, temps total passé) avec les filtres appropriés, pour un résultat plus précis.
Poser des questions avec des conditions de données
Lorsque vous posez des questions avec des conditions de données, indiquez clairement tous les filtres et conditions nécessaires dans votre question, y compris les dates exactes, les limites de nombre et les catégories spécifiques. Assurez-vous que l'API Conversational Analytics applique les filtres appropriés (plages de dates, N premiers résultats, catégories spécifiques, par exemple).
Exemples
Les questions suivantes spécifient correctement les critères de filtrage :
"Affiche-moi la date de facturation du 2 mai 2025 au 3 juin 2025, ainsi que l'âge moyen respectif des factures impayées uniquement." Cette question spécifie clairement la plage de dates.
"Indique le nom du client, la somme du solde impayé, l'âge moyen et le type de créance pour les enregistrements datant de plus de 46 jours. Limite les résultats à cinq enregistrements maximum par solde impayé." Cette question spécifie l'âge de l'enregistrement, fournit une limite et des exigences de tri.
"Indique les principaux secteurs par montant de variance dans les soldes des comptes clients, ainsi que les montants pour 2025FP1 par rapport à la fin de l'année précédente." Cette question spécifie les "secteurs les plus performants" et les périodes de comparaison.
Demander l'agrégation de données
Lorsque vous posez des questions pour agréger des données, spécifiez le type d'agrégation ("somme du solde dû" ou "âge moyen", par exemple) et les dimensions selon lesquelles vous souhaitez agréger les données ("nom du client", "type de créance" ou "secteur d'activité", par exemple).
Exemple
La question suivante spécifie clairement les exigences concernant l'agrégation des données :
"Indique le nom du client, la somme du solde impayé, l'âge moyen et le type de créance pour les enregistrements datant de plus de 46 jours."
Poser des questions complémentaires
Lorsque vous posez une question de suivi, faites référence au contexte établi précédemment, mais soyez explicite concernant les changements ou les ajouts. Par exemple, si vous souhaitez modifier une plage de dates ou une limite, indiquez clairement les nouveaux paramètres.
Exemples
Question d'origine : "Indique le nom du client, la somme du solde impayé, l'âge moyen et le type de créance pour les enregistrements dont l'ancienneté dépasse 46 jours. Limite les résultats à cinq enregistrements maximum par solde impayé."
Question de suivi : "Fournis les métriques précédentes pour les enregistrements datant de plus de 90 jours et limite-toi aux 10 premiers enregistrements."
Pourquoi ça marche : la question de suivi spécifie clairement les modifications apportées au filtre "Âge supérieur à" et à la limite de résultats, tout en faisant référence aux mêmes métriques que la question précédente pour le contexte.
Demander des résultats mis en forme
Lorsque vous posez une question qui ne spécifie pas de format de résultat, l'API Conversational Analytics détermine le format le mieux adapté aux critères spécifiques et aux termes clés fournis dans la question.
Vous pouvez guider l'API Conversational Analytics pour qu'elle fournisse des résultats dans les formats suivants en incluant des termes clés dans votre question :
Demander à l'API Conversational Analytics de renvoyer les résultats dans un tableau
La question suivante implique que les résultats doivent être renvoyés dans un tableau, car elle spécifie les noms des colonnes de dimensions et de métriques :
"Indique le nom du client, la somme du solde impayé, l'âge moyen et le type de créance pour les enregistrements datant de plus de 46 jours."
Demander à l'API Conversational Analytics de renvoyer les résultats sous forme de texte
Utiliser des termes clés tels que "résumé" ou poser une question qui ne nécessite qu'une réponse simple permet à l'API Conversational Analytics de fournir des résultats sous forme de texte.
Les questions suivantes impliquent que les résultats doivent être renvoyés sous forme de texte :
"Calcule et résume le temps total passé en heures pour traiter toutes les factures manuelles."
"Quel est le temps total nécessaire pour traiter les factures manuelles au cours de la semaine dernière ?"
Demander à l'API Conversational Analytics de renvoyer les résultats sous forme de graphique linéaire
L'utilisation de termes clés tels que "tendance", "évolution" ou "variation" dans une question permet à l'API Conversational Analytics de fournir des résultats sous forme de graphique linéaire.
Les questions suivantes impliquent que les résultats doivent être renvoyés sous la forme d'un graphique en courbes :
"Quelle est la tendance mensuelle des soldes de clôture pour chaque secteur en 2024 ?"
"Quelle est la variation quotidienne du delta de l'âge moyen des factures impayées pour le jour par rapport au jour précédent entre le 2 mai 2025 et le 3 juin 2025 ?"
Demander à l'API Conversational Analytics de renvoyer les résultats sous forme de graphique à barres ou comparatif
L'utilisation de termes clés tels que "comparer" et "variance" permet à l'API Conversational Analytics de fournir des résultats sous forme de graphique à barres ou comparatif.
La question suivante implique que les résultats doivent être renvoyés sous forme de graphique à barres ou comparatif :
"Indique les principaux secteurs par montant de variance dans les soldes des comptes clients, ainsi que les montants pour 2025FP1, par rapport à la fin de l'année précédente."
Les résultats de cette question seront renvoyés sous la forme d'un graphique à barres affichant la variance pour chaque secteur.
Autres ressources
Pour obtenir d'autres conseils de dépannage et des réponses aux questions fréquentes, consultez la page Questions fréquentes sur l'API Conversational Analytics.
Pour en savoir plus sur les erreurs d'API et les solutions potentielles, consultez le guide Résoudre les problèmes liés à l'API Conversational Analytics.