Agent d'opérations : exécutions, nouvelles tentatives et rapports

Chaque fois qu'un déclencheur lance l'agent, une exécution est enregistrée. Les exécutions continuent malgré les redémarrages et les mises à jour : chaque étape est enregistrée dès qu'elle se termine, et une exécution reprise par un autre serveur continue là où elle s'était arrêtée.

Ouvrir une exécution#

La page Exécutions de l'agent liste chaque exécution avec son statut, le déclencheur, sa durée de travail et son coût. Ouvrez une exécution pour voir chaque étape sur une chronologie :

• sa durée et le nombre d'octets reçus et produits ;
• le JSON reçu et produit, exactement ce que l'étape suivante a obtenu ;
• quand un point de terminaison distant a échoué, ce que l'autre partie a répondu (le statut HTTP et le début de sa réponse) et chaque essai échoué ;
• les réponses du rapport et le téléchargement Excel, quand une étape de rapport s'est exécutée ;
• le bloc Facturation de l'exécution : ce qu'elle a traité et ce qu'elle a coûté.

Sur le tableau, cliquez sur une étape après une exécution pour voir les mêmes données dans l'inspecteur.

Statuts des étapes#

• Terminée, En cours, En file, En attente (des étapes qui la précèdent).
• En attente de reprise : une étape a échoué et réessaiera à l'heure indiquée ; les étapes suivantes attendent aussi. L'exécution reprend d'elle-même.
• Échouée : l'étape a épuisé ses essais. Les étapes suivantes sont ignorées, sauf si vous avez dessiné une branche d'échec.
• Ignorée : l'étape se trouvait sur une branche non prise, ou elle n'avait rien à faire, par exemple aucun enregistrement pour un appel manqué. Une exécution dont les étapes n'avaient rien à faire se termine quand même.
• Partiellement échouée pour l'exécution : certaines branches se sont terminées et d'autres non.

Politique de nouvelle tentative#

Chaque étape a une politique de nouvelle tentative (le panneau Politique de nouvelle tentative de l'inspecteur) : combien d'essais, de 1 à 24, et combien de minutes entre eux, de 1 à 1440. Les valeurs par défaut :

• les étapes qui appellent un point de terminaison distant (webhook, répartiteur, téléchargement de l'enregistrement, stockage) : 24 essais, une fois par heure, jusqu'à ce que le point de terminaison réponde 2xx ;
• transcription, résumé et e-mail : 3 essais à dix minutes d'intervalle ; rapport à partir de questions : 2 essais à dix minutes d'intervalle.

Un point de terminaison distant a reçu l'appel quand il répond 2xx ; toute autre réponse, ou aucune, compte comme un essai échoué. Un réglage que vous seul pouvez corriger, comme un destinataire manquant ou une adresse non autorisée, échoue immédiatement au lieu de réessayer toute la journée. Les heures d'attente d'une reprise ne sont pas facturées.

Dans une exécution, appuyez sur Réessayer maintenant sur une étape échouée ou en attente : elle s'exécute à nouveau immédiatement, puis tout ce qui suit. Un webhook peut, rarement, être livré deux fois ; il porte une clé d'idempotence que votre point de terminaison peut utiliser pour ignorer le doublon.

Journaux#

La page Journaux de l'agent affiche chaque étape des 100 dernières exécutions sur une ligne, les plus récentes en premier, avec son essai et son message. Filtrez-la sur Échouée ou En attente de reprise pour voir d'un coup d'œil ce qui demande votre attention ; cliquez sur une ligne pour ouvrir son exécution.

Toutes les exécutions du projet#

Exécutions dans le menu de gauche de la console liste les exécutions de tous les agents d'opérations du projet sur une période de votre choix (le mois en cours par défaut), filtrable par agent. Au-dessus de la liste : le nombre d'exécutions, les minutes d'automatisation, les minutes de l'offre utilisées, la valeur catalogue et ce qui a été facturé. Exporter vers Excel télécharge la période, jusqu'à 5 000 exécutions par fichier ; réduisez les dates pour en obtenir davantage.

Le tableau de bord peut afficher les appels, les exécutions ou les deux par jour, semaine ou mois : choisissez Opérations ou Tous les agents dans son filtre de type d'agent.

En cas de problème#

• Une exécution n'a pas démarré : vérifiez que l'agent est activé et qu'il a le bon déclencheur. Pour un déclencheur du standard, ouvrez Intégrations et vérifiez que le standard affiche Connecté et que l'appel figure dans ses appels récents ; l'onglet Toutes les requêtes du standard affiche chaque requête envoyée par le standard, y compris celles qui ont été refusées. Pour un webhook, utilisez Écouter pour voir si la requête arrive.
• Une étape réessaie sans cesse : ouvrez l'exécution et lisez Ce que l'autre partie a répondu. Corrigez le point de terminaison, puis appuyez sur Réessayer maintenant.
• Une valeur arrive vide : ouvrez l'exécution, cliquez sur l'étape qui aurait dû la produire et vérifiez le nom du champ dans sa sortie ; utilisez Écouter pour voir les vraies données du déclencheur.