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. Elle présente les bonnes pratiques pour les actions suivantes :
- Poser des questions générales
- Poser 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, réduisez la portée en incluant des détails pertinents, tels que des dates, des catégories spécifiques ou des filtres numériques.
Un agent de données qui utilise une source de données Looker peut poser des questions complémentaires pour clarifier les ambiguïtés de la requête d'origine. Par exemple, s'il existe plusieurs champs portant un nom similaire, l'agent de données peut vous demander de préciser quel champ est le plus approprié pour traiter votre requête. Ces questions s'affichent dans une réponse Clarification nécessaire.
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 et indique également un récapitulatif du temps total nécessaire en heures pour traiter toutes les factures manuelles."
Pourquoi ça fonctionne : 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écapitulatif.
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 moyen en jours entre la livraison et l'encaissement du paiement pour chaque type de créance (PHA, ristourne coopérative, carte de crédit, média de vente au détail) et quel pourcentage de ces encaissements sont manuels ? En supposant que nous passons 15 minutes pour chaque créance encaissée manuellement, combien de temps consacrons-nous à l'application de paiement et à l'encaissement pour chaque type de créance chaque année ?"
Question affinée, partie 1 : "Quel est le délai 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 pourcentage des encaissements sont manuels 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 passions 15 minutes pour chaque créance encaissée manuellement, combien de temps consacrons-nous à l'application de paiement et à l'encaissement pour chaque type de créance chaque année ? »
Pourquoi ça fonctionne : en posant les questions séparément, l'API Conversational Analytics peut traiter chaque métrique spécifique (délai moyen, pourcentage d'encaissements manuels, 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 numériques 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 des factures en cours." Cette question spécifie clairement la plage de dates.
"Indique le nom du client, la somme du solde en cours, l'âge moyen et le type de créance pour les enregistrements dont l'âge dépasse 46 jours. Limite les résultats à cinq enregistrements en fonction du solde en cours." Cette question spécifie l'âge de l'enregistrement, fournit une limite et des exigences de tri.
"Indique les principaux secteurs d'activité par montant de variation dans les soldes des créances clients, ainsi que les montants pour la période 2025FP1 par rapport à la fin de l'année précédente." Cette question spécifie les "principaux secteurs d'activité" 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 (par exemple, "somme du solde en cours" ou "âge moyen") et les dimensions selon lesquelles vous souhaitez agréger les données (par exemple, "nom du client", "type de créance" ou "secteur d'activité").
Exemple
La question suivante spécifie clairement les exigences d'agrégation des données :
"Indique le nom du client, la somme du solde en cours, l'âge moyen et le type de créance pour les enregistrements dont l'âge dépasse 46 jours."
Poser des questions complémentaires
Lorsque vous posez une question complémentaire, faites référence au contexte établi précédemment, mais soyez explicite quant aux modifications ou aux 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 en cours, l'âge moyen et le type de créance pour les enregistrements dont l'âge dépasse 46 jours. Limite les résultats à cinq enregistrements en fonction du solde en cours."
Question complémentaire : "Indique les métriques précédentes pour les enregistrements dont l’âge dépasse 90 jours et limite les résultats aux 10 premiers enregistrements."
Pourquoi ça fonctionne : la question complémentaire spécifie clairement les modifications apportées au filtre "dont l'âge dépasse" et à la limite des 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 :
Guider l'API Conversational Analytics pour qu'elle renvoie des résultats dans un tableau
La question suivante implique que les résultats doivent être renvoyés au format de tableau, car elle spécifie les noms de colonnes de dimension et de métrique :
"Indique le nom du client, la somme du solde en cours, l'âge moyen et le type de créance pour les enregistrements dont l'âge dépasse 46 jours."
Guider l'API Conversational Analytics pour qu'elle renvoie des résultats sous forme de texte
L'utilisation de termes clés tels que "récapitulatif" ou la formulation d'une question qui ne nécessite qu'une réponse simple guide l'API Conversational Analytics pour qu'elle fournisse des résultats sous forme de texte.
Les questions suivantes impliquent que les résultats doivent être renvoyés dans une sortie de texte :
"Calcule et indique un récapitulatif du temps total nécessaire 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 ?"
Guider l'API Conversational Analytics pour qu'elle renvoie des résultats sous forme de graphique en courbes
L'utilisation de termes clés tels que "tendance", "modification" ou "variation delta" dans une question guide l'API Conversational Analytics pour qu'elle fournisse des résultats sous forme de graphique en courbes.
Les questions suivantes impliquent que les résultats doivent être renvoyés sous forme de graphique en courbes :
"Quelle est la tendance mensuelle des soldes de clôture pour chaque secteur d'activité en 2024 ?"
"Quelle est la variation delta quotidienne de l'âge moyen des factures en cours entre le 2 mai 2025 et le 3 juin 2025 ?"
Guider l'API Conversational Analytics pour qu'elle renvoie des résultats sous forme de graphique à barres ou comparatif
L'utilisation de termes clés tels que "comparer" et "variation" guide l'API Conversational Analytics pour qu'elle fournisse 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 d'activité par montant de variation dans les soldes des créances clients, ainsi que les montants pour la période 2025FP1 par rapport à la fin de l'année précédente."
Les résultats de cette question seront renvoyés sous forme de graphique à barres affichant la variation pour chaque secteur d'activité.
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.