Exécutions d'agent IA
Chaque fois qu'un agent IA s'exécute, depuis un nœud Agent IA ou depuis l'API, MonoChat enregistre l'exécution : le harness et les modèles utilisés, la demande reçue, chaque appel de modèle et d'outil, la part du budget consommée et la façon dont l'exécution s'est terminée.
Vous trouverez les exécutions dans Paramètres › Automatisation › Exécutions d'agent IA. Cet élément de menu est affiché aux utilisateurs disposant de la permission Consulter les exécutions d'agents IA dans l'automatisation.
Le tableau des exécutions
| Colonne | Affiche |
|---|---|
| Harness IA | Le harness qui a exécuté l'agent. Survolez-le pour voir le type de harness. |
| Statut | En file d'attente, En cours, Terminé, Échec, Budget dépassé, Délai dépassé ou Annulé. Survolez une exécution en échec pour voir son erreur. |
| Appels au modèle | Appels de modèle utilisés / Appels de modèle max. du budget. |
| Appels d'outils | Appels d'outils utilisés / Appels d'outils maximum du budget. |
| Jetons | Total des jetons. Survolez-le pour voir les jetons en entrée et en sortie, ainsi que les lectures et écritures de cache lorsque le fournisseur les indique. |
| Durée | Durée de l'exécution. |
| Créé le | Date de démarrage de l'exécution. |
Chaque ligne comporte trois boutons :
- Copier l'ID copie l'ID de l'exécution, par exemple pour la retrouver avec
aiAgentRuns.showou pour l'envoyer au support. - Discussion ouvre la conversation dans laquelle l'exécution a travaillé. Il n'apparaît que pour les exécutions rattachées à une session.
- Afficher ouvre le détail de l'exécution.
Utilisez les filtres pour affiner la liste par Harness IA, Statut et Créé le (plage de dates). Le tableau ne se met pas à jour tout seul ; utilisez le bouton d'actualisation de son en-tête pour charger les nouvelles exécutions et les changements de statut.
Détail d'une exécution
Afficher ouvre le panneau Exécution d'agent IA.
Résumé
| Ligne | Affiche |
|---|---|
| ID | L'ID de l'exécution, avec un bouton de copie. |
| Harness IA | Le nom et le type du harness. |
| Statut | La façon dont l'exécution s'est terminée, ou son état s'il est encore en file d'attente ou en cours. |
| Erreur | Le message d'erreur, pour les exécutions qui ne se sont pas terminées. |
| Modèle principal, Modèle de repli (après la limite souple), Modèle rapide (tâches de fond légères) | Les modèles IA définis dans le nœud, pour les harness qui utilisent des modèles IA. |
| Modèle (un des modèles autorisés du harness) | Le modèle, pour un harness hébergé. |
| Créé le, Démarré le, Terminé le | Quand l'exécution a été mise en file d'attente, démarrée et terminée. |
| Durée | Temps utilisé / Durée max. (secondes). |
| Appels au modèle | Appels utilisés / maximum, avec la limite souple lorsqu'elle est définie. |
| Appels d'outils | Appels utilisés / maximum. |
| Jetons | Jetons en entrée et en sortie (et jetons de cache), et total / Tokens totaux max.. |
Étapes
Étapes liste ce que l'agent a fait, dans l'ordre, avec à droite le temps écoulé depuis le début de l'exécution :
| Étape | Affiche |
|---|---|
| Appel au modèle n | Le modèle, les jetons en entrée et en sortie, puis les outils demandés par le modèle (Outils demandés : …) ou Réponse finale. |
| Appel d'outil | Le nom de l'outil et sa durée. |
| Passage au modèle de secours | L'exécution a atteint la limite souple et a continué avec le modèle de secours. |
| Message intermédiaire | Un message rédigé par l'agent pendant son travail, tel qu'il a été envoyé au client ou ajouté comme chuchotement. |
| Nouvelle tentative | Un appel de modèle en échec qui a été relancé, avec son erreur. |
Si le harness ne signale aucune étape, le panneau indique « Aucune étape n'a été enregistrée pour cette exécution. »
Instructions, Entrée, Résultat et Données JSON
- Instructions : les instructions du nœud telles que l'agent les a reçues.
- Entrée : la tâche, avec ses balises déjà remplies.
- Résultat : la réponse finale de l'agent.
- Données JSON : l'enregistrement complet de l'exécution. Utilisez le bouton de copie pour le partager avec votre développeur ou avec le support MonoChat.
Déboguer un agent
| Ce que vous voyez | Ce qu'il faut vérifier |
|---|---|
| Budget dépassé avec Appels au modèle au maximum | Examinez les étapes. Si l'agent appelle des outils en boucle sans converger, rendez les instructions et les descriptions des outils plus précises. Si la tâche nécessite vraiment plus d'étapes, augmentez Appels de modèle max.. |
| Budget dépassé avec Jetons au maximum | Un long historique de conversation ou de gros résultats d'outils remplissent le budget de jetons. Réduisez la Limite de l'historique des messages, renvoyez moins de données depuis vos outils, ou augmentez Tokens totaux max.. |
| Budget dépassé avec Appels d'outils au maximum | L'agent a demandé plus d'outils que le nombre autorisé. Augmentez Appels d'outils maximum ou indiquez-lui dans les instructions quel outil utiliser et quand. |
| Délai dépassé | Vérifiez la durée des appels d'outils dans Étapes. Une API ou un serveur MCP lent consomme la Durée max. (secondes). |
| Échec avec « Un périmètre IA ou un outil MCP est introuvable dans cet espace de travail. » | Un périmètre ou un outil MCP du nœud a été supprimé. Mettez à jour les Paramètres des outils du nœud. |
| Échec avec « Choisissez l'un des modèles autorisés du harness IA. » | Le modèle du nœud a été retiré des Modèles autorisés du harness hébergé. |
| Échec avec « Ce harness n'est pas disponible sur ce serveur. » | Le harness nécessite l'exécuteur d'agents de MonoChat, qui n'est pas disponible. Choisissez un autre harness. |
| Le client n'a pas reçu la réponse | Vérifiez que l'exécution a le statut Terminé, que Envoyer la réponse est activé dans le nœud, et si le Résultat est vide. |
| Le client a vu des messages « en cours de réflexion » que vous ne souhaitiez pas | Désactivez Transmettre les messages intermédiaires au client ; les messages restent alors des chuchotements pour votre équipe. |
Comparez plusieurs exécutions du même nœud avant de modifier son budget. Les étapes montrent si l'agent a besoin de plus de marge ou de meilleures instructions.