# Statistiques > Voyez sur le canevas les conversations qu'un agent a traitées et les crédits qu'il a utilisés. Répartition par source (application, API, Live, canal, routine, Space) et par point d'entrée (clé API ou connexion de canal). Pour Live, voyez aussi les visites et leur provenance. **Statistiques**, c'est l'onglet **Utilisation** du [canevas](/fr/docs/build/canvas/). Le canevas montre ce qui est rattaché à cet agent. L'onglet Utilisation y ajoute le nombre de requêtes arrivées par chaque point d'entrée et ce qu'elles ont coûté. ## Quand l'utiliser - Après avoir activé Live, pour voir combien de personnes viennent, combien commencent une conversation et combien de crédits elles consomment. - Pour repérer la clé API que vos intégrations appellent le plus. - Pour retrouver le jour où l'utilisation des canaux ou des routines a augmenté. Pour comparer tous vos agents d'un coup, utilisez le [tableau de bord d'utilisation](/fr/docs/account/usage/). Les statistiques portent sur un seul agent. ## Y accéder 1. Ouvrez le **Studio** de l'agent. 2. Sélectionnez l'onglet **Utilisation** en haut du canevas. La cellule **Statistiques**, sous la carte de l'agent, mène à la même vue. 3. Choisissez une **période** en haut à droite : 7, 30 ou 90 jours. La période n'existe que dans l'onglet Utilisation. ## Les chiffres sur le canevas Dans l'onglet Utilisation, les nœuds de la colonne de gauche (Les requêtes arrivent) affichent des chiffres. | Nœud | Ce qu'il affiche | | --- | --- | | Lignes d'en-tête **Canal, Live, API** | Conversations et crédits de cette source ; Live affiche aussi les visites | | **Connexion de canal**, **Clé API** | Conversations, réponses et crédits de ce seul point d'entrée | | **Adresse Live** | Visites, conversations commencées et crédits de cette adresse | | **Autres requêtes** | L'utilisation qui n'a pas de point d'entrée à configurer, comme les conversations dans l'application, les routines et les Spaces | Le trait qui mène à l'agent s'épaissit avec l'utilisation. Les points d'entrée inutilisés sur la période sont tracés en pointillés pâles. Le total de l'en-tête API inclut les appels effectués avec des **clés valables pour tout le compte**. Le canevas ne dessine que les clés dédiées à cet agent : la somme des nœuds de clés peut donc être inférieure à la ligne d'en-tête. ## Le graphique en dessous Un graphique en barres quotidien se trouve sous le canevas. Les barres s'empilent par source, et chaque jour de la période a sa place. Les jours sans utilisation restent vides. - L'en-tête du graphique affiche les totaux de la période : conversations, réponses, jetons et crédits. - Choisissez **Jetons**, **Crédits** ou **Réponses** pour les barres. - Sélectionnez une pastille de source sous le graphique pour masquer ou afficher cette source. - Si vous réduisez le graphique, il reste réduit la fois suivante. Les conversations ne sont pas représentées en barres. Additionner les nombres quotidiens compterait plusieurs fois une conversation qui s'étend sur plusieurs jours. Lisez le nombre de conversations de la période dans l'en-tête du graphique. ## Cibler un point d'entrée Sélectionnez un nœud dans l'onglet Utilisation pour ouvrir le panneau **Statistiques** à droite. Le graphique n'affiche alors que ce point d'entrée. - Une **source** (la ligne d'en-tête Canal, Live ou API, ou Autres requêtes) ne garde en couleur pleine que les barres de cette source. - Une **clé API** ou une **connexion de canal** affiche les valeurs quotidiennes de ce point d'entrée par rapport au total du jour. Le panneau Statistiques contient deux tableaux. - **Sources** : conversations, réponses, jetons, crédits et part de chacune des six sources. Les sources inutilisées restent affichées pour permettre la comparaison. - **Points d'entrée** : appels, jetons et crédits par clé API et par connexion de canal. Seul le préfixe des clés est affiché. Sélectionnez **›** en bout de ligne pour ouvrir les paramètres de cette clé ou de ce canal. Le point d'entrée ciblé apparaît sous forme de pastille dans l'en-tête du graphique et dans celui du panneau. Sélectionnez **×** sur la pastille pour revenir à l'ensemble. ## Visites Live Lorsque Live est activé, l'onglet Utilisation compte aussi les personnes qui ouvrent la page endue.live de votre agent ou une fenêtre de chat intégrée à un site. Une visite est comptée même sans message : vous voyez ainsi combien de visiteurs commencent ensuite une conversation. Sélectionnez la ligne **Live** ou son adresse. Le canevas montre les visites, les conversations commencées et les crédits. Le panneau d'analyse ouvre **Points d'entrée → Live**, avec les totaux de la période, les tableaux par site et par provenance ainsi que les langues des visiteurs. Le graphique propose **Visites** et sépare page et intégration. | Mesure | Ce qui est compté | | --- | --- | | Visites | Chaque affichage de la page ou de la fenêtre intégrée ; un rechargement ajoute une visite | | Visiteurs uniques | Le même visiteur, le même jour et pour le même agent une seule fois ; la période additionne les jours | | Conversations commencées | Visites avec au moins un message envoyé | | Taux de démarrage | Conversations commencées divisées par visites | | Conversations valides | Visites avec au moins deux messages envoyés | Un jour va de minuit à minuit UTC. Un message compte quand l'agent l'accepte. Un message refusé parce que le visiteur écrit trop vite ou que le compte manque de crédits ne compte pas. Les **conversations commencées** comptent les visites ; les **conversations** comptent les fils auxquels l'agent a répondu au moins une fois. Revenir le lendemain dans le même fil peut donner deux conversations commencées et une seule conversation. Le tableau par site comporte une ligne pour la page endue.live et une pour chaque site accueillant le chat intégré. Chaque ligne affiche **visites, conversations, messages et crédits**. Les trois derniers chiffres totalisent la ligne Live du tableau **Sources**. ### Provenance des visiteurs Chaque visite rejoint la première ligne qui lui correspond : | Ligne | Condition | | --- | --- | | Site · example.com | Fenêtre de chat intégrée sur ce site | | Campagne · newsletter | Le lien comporte `utm_source` | | Direct | Aucun référent : adresse saisie, favori ou application qui n'en transmet pas | | endue.live Explore, endue.ai | Visite depuis l'un de ces sites | | Recherche · Google | Moteur de recherche reconnu | | Réseau social · X | Réseau social ou messagerie reconnu | | Site · blog.example.com | Autre site ; seul l'hôte est affiché | | Inconnu | Un message est arrivé sans visite enregistrée | Le tableau montre les 20 lignes avec le plus de visites et regroupe le reste. Pour distinguer les liens distribués, ajoutez `utm_source`, par exemple `endue.live/@your-agent?utm_source=newsletter`. La valeur accepte lettres, chiffres et `. _ ~ -`, jusqu'à 64 caractères. Une autre forme est ignorée. ### Visites exclues - **Propriétaire** : si vous ouvrez la page Live depuis les réglages Live ou l'accueil de l'agent, le navigateur est reconnu comme celui du propriétaire. Une intégration sur `localhost` est aussi comptée comme telle. Sur un autre navigateur ou appareil, vous comptez comme visiteur jusqu'à cette ouverture. - **Robots** : les robots et aperçus de liens sans scripts ne sont jamais enregistrés. Les navigateurs automatisés et robots connus qui exécutent des scripts sont classés comme robots. La dernière ligne de l'onglet Live montre les visites exclues. Les crédits dépensés pour vos conversations de test restent dans les coûts. Chaque visite conserve l'agent, page ou intégration, l'hôte du site intégré, le type et le nom du référent, `utm_medium` et `utm_campaign`, la langue du navigateur, le pays, le type d'appareil, l'heure, le nombre de messages et une clé servant à compter les visiteurs uniques. Ne sont pas conservés : adresse IP, cookies, URL complète de provenance et chaîne user agent. La clé est dérivée de l'adresse IP, change chaque jour et pour chaque agent et ne relie ni les jours ni les agents. Les visites sont supprimées après 400 jours. Limites : aucune visite antérieure à l'activation du comptage n'apparaît. Plusieurs personnes sur un même réseau peuvent compter comme un visiteur unique. Pour une intégration, seule l'ouverture de la fenêtre compte, pas l'affichage du bouton. Le tableau par provenance répartit visites et conversations commencées ; conversations, messages et crédits ne sont détaillés que par site. ## Lire les chiffres - Les **conversations** comptées sont celles auxquelles cet agent a répondu au moins une fois pendant la période. Celles auxquelles il n'a jamais répondu ne sont pas comptées. - Les **réponses** correspondent au nombre de fois où l'agent a répondu. - Les **crédits** représentent le coût définitif. Un crédit vaut 1 $ US. - Sur une même période, le total de jetons correspond à celui de l'onglet Agents du [tableau de bord d'utilisation](/fr/docs/account/usage/). ## Qui peut les voir Seul le propriétaire de l'agent. Les autres personnes ne voient ni l'onglet Utilisation ni la cellule Statistiques. Quand quelqu'un d'autre utilise cet agent, cette utilisation est comptée sur son compte et n'apparaît pas ici. ## Limites - Les appels d'outils (connecteurs et compétences) ne sont pas encore comptabilisés. C'est pourquoi la colonne de droite du canevas n'affiche aucun chiffre. - Les coûts des appareils (ordinateur et navigateur) ne sont pas inclus. - L'utilisation est enregistrée à la fin d'une exécution. Une exécution en cours n'apparaît qu'une fois terminée. ## Voir aussi