Statistiques

Statistiques, c’est l’onglet Utilisation du canevas. 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. 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.

« Non facturé » ne veut pas dire gratuit

Les exécutions qui passent par votre propre clé LLM ne sont pas facturées par endue ; elles ne portent donc aucun crédit. Ces jetons sont indiqués à part, sous la mention non facturé, au lieu d’être comptés comme zéro crédit. Vérifiez le coût auprès de ce fournisseur de LLM.

Si vous voyez « Non classé »

L’utilisation enregistrée avant le suivi des sources a été complétée à partir de la conversation à laquelle elle appartient. Ce qui reste inconnu est regroupé sous Non classé. L’utilisation API plus ancienne est attribuée à la clé qui a créé la conversation.

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

CanevasL'onglet Configuration : ce qui est rattaché.

Tableau de bord d'utilisationTous les agents d'un coup.

API d'agentAppeler votre agent avec une clé API.

Offres et utilisationLe fonctionnement des crédits et de l'utilisation incluse.