Exécutez et validez vos agents intelligents pour confirmer que votre logique identifie les utilisateurs appropriés avant que les actions n’affectent votre cours.
Avant de commencer
Assurez-vous d’avoir l’autorisation de gérer les agents intelligents.
Comprendre les types d’exécution
Exécution d’entraînement
Une exécution d’essai permet de valider la logique de votre agent sans effectuer d’action.
Exécution manuelle
Une exécution manuelle lance immédiatement les actions sélectionnées pour les utilisateurs qui répondent actuellement aux critères.
|
Remarque : les exécutions d’essai et les exécutions manuelles n’exigent pas que l’agent soit activé. |
Effectuer une exécution d'essai d'un agent
Vous pouvez définir une exécution d'essai d'un agent pour connaître les utilisateurs identifiés par l'agent sans pour autant leur envoyer un courriel. Les agents ne doivent pas nécessairement être activés pour pouvoir exécuter un essai.
Pour effectuer une exécution d'essai d'un agent
- Accédez à Administration de cours > Agents intelligents.
- Dans le menu contextuel de l'agent visé, cliquez sur Exécution d'essai.
- Sélectionnez Exécuter dans la boîte de dialogue Confirmation.
- Cliquez sur Terminé pour retourner à la page Liste des agents.
- Les résultats de l'exécution d'essai s'affichent dans la colonne Résultats de la dernière exécution.
 | Astuce : Vous pouvez également afficher l'information détaillée en cliquant sur l'option Afficher l'historique du menu contextuel de l'agent. |
Points à vérifier lors d’une exécution d’essai
Après avoir effectué une exécution d’essai, examinez attentivement les résultats.
- Les bons utilisateurs apparaissent-ils?
- Est-ce qu’il manque des utilisateurs attendus?
- Des utilisateurs inattendus sont-ils inclus?
Si les résultats ne sont pas corrects, modifiez les critères ou les conditions et lancez de nouveau l’exécution d’essaie avant d’activer les actions.
Passez en revue les résultats
Passez en revue la colonne Résultats de la dernière exécution.
Sélectionnez le lien des résultats ou Afficher l’historique dans le menu contextuel.
Exécuter un agent manuellement
En règle générale, un agent est configuré de façon à s'exécuter automatiquement. Vous pouvez toutefois, si vous n'avez pas programmé un horaire d'exécution régulier, lancer l'exécution de façon manuelle.
Lorsque vous exécutez un agent de façon manuelle, celui-ci transmet un courriel de confirmation à l'utilisateur qui a demandé ou défini l'agent. Ce courriel comprend les renseignements suivants :
- Code et nom de l'unité organisationnelle;
- Identification de l'<I>Agent</I> exécuté;
- Heure et date de la soumission de la demande;
- Heure et date de la fin de l'exécution de la demande;
- Action exécutée par l'<I>Agent</I>;
Vous pouvez définir l’exécution manuelle d’un agent intelligent en tout temps pour un cours affichant une date de fin échue. Les agents ne doivent pas nécessairement être activés pour pouvoir configurer une exécution manuelle.
Pour exécuter un agent manuellement
- Accédez à Administration de cours > Agents intelligents.
- Dans le menu contextuel de l'agent à exécuter de façon manuelle, cliquez sur Faire exécuter l'agent maintenant.
- Sélectionnez Exécuter dans la boîte de dialogue Confirmation.
- Cliquez sur Terminé pour retourner à la page Liste des agents.
- Les résultats de l’exécution manuelle s’affichent dans la colonne Résultats de la dernière exécution. Vous pouvez également afficher l'information détaillée en cliquant sur l'option Afficher l'historique du menu contextuel de l'agent.
Afficher l'historique d'un agent
Vous pouvez consulter l'historique d'un agent pour connaître ses périodes d'exécution, les utilisateurs identifiés, le type d'exécution (Manuelle, Programmée ou d'Essai), le responsable de l'exécution et les erreurs rencontrées, s'il y a lieu.
Marche à suivre pour afficher l'historique d'un agent
- Accédez à Administration de cours > Agents intelligents.
- Dans le menu contextuel de l'agent visé, cliquez sur Afficher l'historique.
Vérifiez la date de la prochaine exécution
Accédez à Administration de cours > Agents intelligents et passez en revue la colonne Date de la prochaine exécution.
|
Remarque : Si l’horaire n’est pas activé, aucune date d’exécution suivante n’apparaît. |
Pourquoi mon agent ne s’est-il pas exécuté?
- Répétition : l’utilisateur a déjà été traité.
- Critères : l’utilisateur ne remplit pas les conditions lors de l’exécution de l’agent.
- Horaire : l’agent n’a pas encore exécuté.
- Configuration : l’agent est désactivé ou configuré incorrectement.
Pourquoi mon agent s’est-il exécuté plus tard que l’heure prévue?
Les agents s’exécutent dans le cadre d’un processus récurrent en arrière-plan qui vérifie tous les agents planifiés à un moment donné dans l’ensemble de l’organisation, puis les déclenche de manière séquentielle.
Si plusieurs agents sont prévus à l’horaire en même temps, ils sont traités l’un après l’autre. Selon la durée d’exécution de chaque agent, certains agents peuvent commencer plus tard que l’heure prévue.
Validez le flux de travail
- Effectuez une exécution d’essai.
- Passez en revue les utilisateurs identifiés.
- Comparez les résultats à votre objectif.
- Modifiez la configuration au besoin.
- Effectuez une autre exécution jusqu’à ce que les résultats correspondent à vos attentes.
- Utilisez Afficher l’historique pour dépanner les prochaines exécutions.
Erreurs courantes
- Sauter une exécution d’essai
- Mal interpréter erronée des résultats obtenus
- Présumer que les résultats passés persistent d’une exécution à l’autre
- Ne pas consulter l’option Afficher l’historique
Exporter l’historique d’un agent
Vous pouvez exporter l’historique d’un agent pour connaître ses périodes d’exécution, les utilisateurs identifiés, le type d’exécution (manuelle, programmée ou d’essai), le responsable de l’exécution et les erreurs résultants s’il y a lieu.
- Accédez à Administration de cours > Agents intelligents.
- Cliquez sur Plus d'actions, et sélectionnez Exporter l'historique d'un agent.
- Utilisez l'option Sélectionner un agent pour sélectionner Tous les agents ou un agent spécifique.
- Sélectionnez Inclure les exécutions d'essai pour inclure les renseignements sur l'exécution d'essai.
- Définissez la plage de dates à inclure.
- Cliquez sur Exporter.
- Cliquez sur le lien du fichier CSV pour télécharger l’historique.
| Remarque : Vous pouvez aussi télécharger ce lien plus tard en accédant à la page Liste des agents et en sélectionnant l'option Exporter l'historique du menu contextuel de cet agent. |
Articles connexes