Academy
6. Auditer avec le journal d'exécution
Utilisez l'historique des exécutions pour examiner chaque appel d'outil — en identifiant quel outil s'est déclenché, quand, depuis quelle origine, et s'il a réussi ou échoué.
Chaque appel d'outil effectué par l'IA via vos connexions MCP est enregistré dans le journal d'exécution. Cette vue dédiée capture quatre données critiques par entrée :
• Outil — quel outil précis a été invoqué (par exemple, « create_issue », « send_email »). • Heure — l'horodatage exact de l'appel. • Origine — d'où l'appel a été déclenché (une conversation ChatPro, une exécution d'agent OUPI Studio, une étape de workflow, un import RAG ou Deep Research). • Résultat — si l'appel a réussi ou échoué.
Comme les connexions fonctionnent à l'échelle de la plateforme, le journal agrège les appels de toutes les surfaces en une seule piste d'audit. C'est essentiel pour le débogage, la conformité et la compréhension de la façon dont vos agents IA interagissent avec les services externes.
Le champ origine mérite une attention particulière. Une seule connexion MCP peut être utilisée par ChatPro, Studio, l'Assistant, des étapes de workflow, des imports RAG et Deep Research — tous simultanément. Lorsque quelque chose ne fonctionne pas, l'origine vous indique quelle surface a déclenché l'appel problématique. Cela vous permet d'isoler les problèmes à une exécution d'agent ou une étape de workflow spécifique plutôt que de deviner sur l'ensemble de la plateforme.
Combinez l'origine avec le filtrage par résultat pour répondre à des questions comme : « Tous les appels d'outil Slack de mon workflow ont-ils réussi la nuit dernière ? » ou « Quelle exécution d'agent Studio a produit un appel API en échec ? »
Lorsque le journal affiche un résultat échoué, la cause la plus fréquente est une autorisation OAuth expirée ou révoquée du côté du service externe. La connexion apparaît intacte dans le MCP Hub, mais le token qu'elle détient n'est plus valide.
Pour résoudre ce problème :
- Ouvrez la connexion en échec dans la vue Connexions.
- Réautorisez-la — cela actualise l'octroi OAuth.
- Si le service a modifié ses permissions ou scopes requis, accordez-les à nouveau lors de la réautorisation.
Si la réautorisation ne résout pas le problème, supprimez la connexion et recréez-la. N'oubliez pas : la suppression la retire de toutes les surfaces sur l'ensemble de la plateforme, coordonnez-vous donc avec les workflows ou agents qui en dépendent.
Croisez le journal d'exécution avec l'inspection des outils. Ouvrez une connexion pour voir les outils exacts qu'elle expose — les mêmes noms apparaissent dans le journal. Cela vous aide à confirmer si l'IA a appelé le bon outil ou en a choisi un inattendu.
Les appels d'outil n'ont pas de ligne de coût distincte. Leurs crédits sont inclus dans l'opération IA qui les a déclenchés — la conversation, l'exécution d'agent ou le workflow. Ainsi, lors de l'audit des dépenses, examinez l'utilisation de crédits de l'opération d'origine, pas le journal d'exécution lui-même.
Ouvrez le journal d'exécution dans le MCP Hub. Choisissez une entrée récente en échec (ou n'importe quelle entrée si tout a réussi). Notez le nom de l'outil, l'horodatage et l'origine. Ensuite, accédez à la connexion correspondante et vérifiez que l'outil existe dans sa liste d'outils. Si l'entrée a échoué, essayez de réautoriser la connexion et de redéclencher l'action.
Le journal d'exécution est votre piste d'audit unique pour chaque appel d'outil MCP sur l'ensemble de la plateforme. Chaque entrée enregistre l'outil, l'horodatage, la surface d'origine et le résultat (réussite/échec). Utilisez l'origine pour isoler les problèmes à un agent ou un workflow spécifique. Les appels échoués signifient généralement une expiration OAuth — réautorisez ou recréez la connexion. Croisez les noms d'outils avec la liste d'outils de la connexion pour vérification, et n'oubliez pas que les coûts des appels d'outil sont intégrés aux crédits de l'opération IA déclenchante.