Exécution d'agents personnalisés

Vous pouvez exécuter un agent personnalisé à la demande ou configurer des déclencheurs pour l'exécuter automatiquement.

Exécution d'un agent personnalisé à la demande

Vous pouvez exécuter un agent personnalisé immédiatement depuis la page détaillée de l'agent ou via Chat.

Pour exécuter un agent personnalisé à partir de la page détaillée, procédez comme suit :

1. Accédez à la page Agents dans votre application Web DevOps Agent.

2. Choisissez l'agent personnalisé que vous souhaitez exécuter.

3. Choisissez Exécuter maintenant pour exécuter l'agent avec ses instructions configurées.

Pour fournir un contexte supplémentaire pour une exécution spécifique, cliquez sur la flèche déroulante située à côté de Exécuter maintenant, entrez une invite décrivant les points sur lesquels l'agent doit se concentrer lors de cet appel, puis choisissez Exécuter avec invite. L'invite est transmise à l'agent sous forme de contexte supplémentaire en plus de son invite système.

Après le début de l'exécution, le nouvel appel apparaît dans l'onglet Historique avec le statut « En attente de démarrage ». Choisissez l'invocation pour visualiser sa trajectoire en temps réel.

Pour exécuter un agent personnalisé à l'aide de Chat, procédez comme suit :

Demandez à Chat d'exécuter l'agent par son nom. Par exemple :

Run my weekly-investigation-report agent.

Run certificate-checker and focus on certificates expiring in the next 7 days.

Lorsque vous fournissez un contexte supplémentaire dans le message de chat, Chat le transmet comme invite pour cette exécution. Si vous ne fournissez pas de contexte supplémentaire, l'agent s'exécute uniquement avec l'invite système configurée.

Un agent personnalisé ne peut exécuter qu'un seul appel à la fois. Si l'agent est déjà en cours d'exécution, vous devez attendre que l'appel en cours soit terminé, expire ou soit annulé avant d'en lancer un autre.

Planification d'agents personnalisés

Les déclencheurs vous permettent d'exécuter automatiquement un agent personnalisé en fonction de conditions définies. AWS DevOps L'agent prend actuellement en charge les déclencheurs basés sur le calendrier, qui exécutent l'agent à intervalles récurrents à l'aide d'expressions EventBridge-compatible cron ou rate.

Pour créer un déclencheur de planification :

1. Accédez à la page Agents dans votre application Web DevOps Agent.

2. Choisissez l'agent personnalisé que vous souhaitez planifier.

3. Choisissez l’onglet Triggers (Déclencheurs).

4. Cliquez sur le bouton + (créer).

5. Dans la boîte de dialogue, entrez une expression de planification dans le champ de saisie. L'expression doit prendre l'un des formats suivants :

   • Expression de débit — S'exécute à un intervalle fixe. Format :rate(value unit). Exemples :

     • rate(1 hour)— Toutes les heures

     • rate(30 minutes)— Toutes les 30 minutes

     • rate(7 days)— Tous les 7 jours

   • Expression Cron — S'exécute selon un calendrier spécifique. Format :cron(minutes hours day-of-month month day-of-week year). Exemples :

     • cron(0 9 ? * MON-FRI *)— Tous les jours de la semaine à 9h00 UTC

     • cron(0 0 1 * ? *)— Le premier jour de chaque mois à minuit UTC

     • cron(0 */6 ? * * *)— Toutes les 6 heures

Un message de confirmation vert apparaît lorsque l'expression est valide.

1. Choisissez Créer.

Pour les expressions cron, exactement le jour du mois ou le jour de la semaine doit être ? (point d'interrogation). Pour plus d'informations sur la syntaxe des expressions de planification, consultez la section Types de planification dans le guide de l'utilisateur d'Amazon EventBridge Scheduler.

Après sa création, le déclencheur apparaît dans la liste indiquant son expression, sa date de création et la prochaine heure d'exécution planifiée.

Gestion des déclencheurs

L'onglet Déclencheurs affiche tous les déclencheurs configurés pour l'agent personnalisé. Pour chaque déclencheur, vous pouvez voir l'expression de planification, sa date de création et sa date de prochaine exécution.

Interruption d'un déclencheur :

Pour empêcher temporairement un déclencheur d'appeler l'agent sans le supprimer, désactivez le commutateur situé à côté du déclencheur. L'état du déclencheur passe à « Suspendu » et ne se déclenche plus tant qu'il n'est pas réactivé. Réactivez le bouton pour reprendre le programme.

Supprimer un déclencheur :

Pour supprimer définitivement un déclencheur, cliquez sur l'icône de suppression (corbeille) à côté du déclencheur que vous souhaitez supprimer. Confirmez la suppression dans la boîte de dialogue qui apparaît. Les déclencheurs supprimés ne peuvent pas être récupérés.

Annulation d'une invocation

Vous pouvez annuler un appel en cours depuis la vue de la trajectoire d'appel ou via Chat.

Pour annuler un appel en cours depuis la vue des trajectoires :

1. Dans l'onglet Historique, choisissez l'invocation en cours.

2. Choisissez Annuler en haut de la vue de trajectoire.

Pour annuler un appel en cours à l'aide de Chat, procédez comme suit :

Cancel the running invocation of weekly-health-report.

Le statut d'invocation passe à « Annulé ». Tout travail terminé avant l'annulation est conservé dans la trajectoire. Les appels aux outils qui étaient en cours au moment de l'annulation peuvent toujours être terminés.

Résultats des appels à outils

Lors de l'invocation, l'agent personnalisé invoque les outils MCP pour collecter des données, effectuer des actions et produire des résultats. Chaque appel d'outil et son résultat sont enregistrés dans la trajectoire d'invocation.

Les résultats des appels à l'outil fournissent une transparence sur ce que l'agent a fait lors de l'invocation :

• Appels d'outil réussis : l'outil a renvoyé des données que l'agent utilise pour poursuivre son travail. Par exemple, query_cloudwatch_logs renvoie des entrées de journal ou use_aws renvoie des réponses d'API.

• Échec des appels à l'outil : l'outil a renvoyé une erreur. L'agent peut réessayer, essayer une autre approche ou signaler l'échec dans sa sortie.

Vous pouvez inspecter les différents appels d'outils et leurs résultats dans la trajectoire d'appel afin de comprendre le comportement de l'agent, de vérifier qu'il a accédé aux bonnes ressources et de résoudre les problèmes liés aux résultats inattendus. Pour plus d'informations sur l'affichage des trajectoires, consultez la section Affichage d'une trajectoire d'appel.