Analytique de l'agent

Vue d'ensemble

L'analytique d'agent fournit un tableau de bord d'observabilité dédié à chaque agent IA personnalisé dans Swiftask. Il centralise les métriques en temps réel sur le volume d'utilisation, les taux de réussite, l'adoption par les membres et la distribution des erreurs.

Utilisez l'analytique d'agent pour suivre la fréquence d'utilisation d'un agent, mesurer la consommation de crédits sur les différents canaux, détecter les inefficacités dans les prompts et résoudre les erreurs d'exécution avant qu'elles n'affectent vos opérations.

Prérequis

Pour accéder au tableau de bord analytique d'un agent, vous devez disposer de :

• Un compte actif dans un espace de travail Swiftask avec accès à l'agent.

• Des autorisations de créateur de l'agent ou d'administrateur de l'espace de travail pour modifier et configurer l'agent.

• Au moins un agent IA personnalisé configuré.

Guide étape par étape

1. Accéder au tableau de bord analytique de l'agent

1. Dans la barre latérale de Swiftask, cliquez sur Agents et sélectionnez l'agent souhaité.

2. Cliquez sur l'icône de configuration pour ouvrir l'espace de configuration de l'agent.

3. Dans le panneau de navigation latéral gauche, faites défiler jusqu'à la section Observabilité.

4. Cliquez sur Analytique.
   

   

2. Examiner les indicateurs de performance clés

L'en-tête du tableau de bord affiche le nom de l'agent ainsi que 6 cartes d'indicateurs clés de performance (KPI) calculés sur les 30 derniers jours :

• Crédits totaux : Total des crédits IA et d'exécution d'outils consommés par l'agent.

• Exécutions totales : Nombre total d'exécutions déclenchées à travers tous les points d'entrée.

• Taux de réussite : Pourcentage d'exécutions réussies, incluant le nombre absolu d'échecs.

• Utilisateurs actifs : Nombre d'utilisateurs uniques de l'espace de travail ayant interagi avec l'agent.

• Conversations : Nombre total de fils de conversation distincts initiés avec l'agent.

• Messages : Volume total de messages individuels traités par l'agent.
  

  

3. Analyser le volume d'exécutions par canal

Le graphique Volume d'exécution par canal visualise le volume quotidien d'exécutions réparti selon l'origine :

• Swiftask : Interactions de chat internes au sein de l'interface Swiftask.

• API : Exécutions déclenchées via l'API REST de Swiftask ou les intégrations SDK.

• Agent as app : Conversations externes générées via des applications web autonomes partagées.

• Trigger : Exécutions automatisées déclenchées par webhooks, tâches planifiées ou e-mails entrants.

4. Examiner les tendances détaillées, les statuts et les erreurs

Faites défiler la page pour analyser les métriques d'efficacité et de santé à long terme :

• Conversations & messages : Graphique linéaire comparant le nombre de conversations au volume de messages dans le temps.

• Tendance des utilisateurs actifs : Graphique de zone affichant le nombre d'utilisateurs actifs quotidiens pour mesurer l'adoption.

• Crédits au fil du temps : Graphique linéaire illustrant les pics et tendances de consommation quotidienne.

• Crédits moyens par exécution : Graphique mesurant le coût moyen par exécution individuelle. Une hausse durable indique des contextes grandissants ou des retours d'outils volumineux.

• Statut des exécutions au fil du temps : Graphique à barres empilées comparant les exécutions Réussies et Échouées chaque jour.

• Répartition des erreurs : Graphique à barres horizontales catégorisant les motifs d'échec tels que Erreur d'API, Crédits épuisés ou Autre.
  

  

5. Examiner les variantes selon le mode de déploiement

Selon le déploiement de votre agent, la répartition des canaux et les profils d'utilisation reflètent des variantes opérationnelles spécifiques :

Variante : Application web publique (Agent as app)

Les agents déployés en applications web autonomes affichent un volume concentré sur le canal Agent as app, avec des interactions réparties sur des sessions externes.

Variante : Agent d'arrière-plan automatisé (Trigger)

Les agents déclenchés par webhooks ou flux automatisés affichent leur volume sur le canal Trigger, caractérisé par des volumes élevés provenant de pipelines d'automatisation.

Cas d'usage pratiques

Détecter l'inflation du prompt et les contextes surdimensionnés

Un créateur constate que si le nombre d'exécutions reste stable, les Crédits moyens par exécution ont doublé sur la dernière semaine. En consultant le graphique, il identifie que des instructions allongées ou des fichiers volumineux augmentent le coût en tokens, ce qui permet d'optimiser le prompt.

Diagnostiquer les échecs soudains d'exécution

Une équipe remarque que des flux clients automatisés échouent. Le responsable consulte le Statut des exécutions au fil du temps et constate un pic d'échecs. Le graphique de Répartition des erreurs indique une cause liée aux Crédits épuisés, ce qui permet de réapprovisionner immédiatement les crédits.

Mesurer l'adoption d'un agent au sein des équipes

Un responsable des opérations déploie un nouvel agent documentaire. En consultant la Tendance des utilisateurs actifs et les courbes de Conversations & messages, il évalue la progression hebdomadaire de l'adoption dans l'espace de travail.

Conseils et bonnes pratiques

• Surveiller les crédits moyens : Contrôlez régulièrement les Crédits moyens par exécution afin de repérer rapidement les boucles coûteuses ou les payloads excessifs.

• Croiser les alertes d'échec : Lorsque le taux de réussite passe sous les 95 %, consultez la Répartition des erreurs pour savoir s'il s'agit d'une panne d'API externe ou d'un solde insuffisant.

• Relier les canaux aux dépenses : Comparez le Volume d'exécution par canal et les Crédits au fil du temps pour identifier si ce sont les appels API ou les sessions de chat qui mobilisent le plus de budget.

Dépannage

Problème : L'onglet analytique n'affiche aucune exécution ou des graphiques vides

• Cause : L'agent n'a pas été exécuté au cours des 30 derniers jours, ou les exécutions ont eu lieu dans un autre environnement.

• Solution : Lancez une conversation de test avec l'agent dans le Chat ou déclenchez son automatisation. Patientez quelques instants pour l'actualisation des données.

Problème : Erreurs fréquentes « Crédits épuisés » dans la répartition

• Cause : L'allocation de crédits de l'espace de travail est épuisée ou l'agent a atteint son plafond alloué.

• Solution : Rendez-vous dans Paramètres de l'espace de travail → Abonnement pour souscrire des crédits supplémentaires ou réajuster les limites des membres.

Problème : Taux élevé d'échecs de type « Erreur d'API »

• Cause : Les skills tiers connectés, les webhooks ou les modèles sous-jacents sont inaccessibles ou leurs identifiants sont expirés.

• Solution : Rendez-vous dans la configuration des Skills de l'agent, testez la connectivité et mettez à jour les clés API nécessaires.

Ressources supplémentaires

• Sessions & boîte de réception – Consultez l'historique des conversations, les traces d'exécution et les logs détaillés.

• Paramètres de l'agent – Configurez les instructions, le modèle de langage et le comportement de votre agent.

• Suivi de votre consommation – Surveillez l'utilisation globale des crédits et la facturation de votre espace de travail.

• Agent en application web – Partagez et déployez vos agents sous forme d'applications web autonomes.