View a markdown version of this page

Exécution d'agents personnalisés - AWS DevOps Agent
Gestion d'un agent personnalisé à la demandePlanification d'agents personnalisésGestion des déclencheursAnnulation d'une invocationRésultats des appels d'outils

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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.

Gestion 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é depuis la page détaillée, procédez comme suit :

  1. Accédez à la page Agents de 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, choisissez la flèche déroulante à côté de Exécuter maintenant, entrez une invite décrivant ce sur quoi l'agent doit se concentrer lors de cette invocation, puis choisissez Exécuter avec invite. L'invite est transmise à l'agent en tant que contexte supplémentaire à côté de son invite système.

Une fois l'exécution lancée, la nouvelle invocation apparaît dans l'onglet Historique avec le statut « Démarrage en attente ». Choisissez l'invocation pour visualiser sa trajectoire en temps réel.

Pour exécuter un agent personnalisé à l'aide de Chat :

Demandez à Chat de gérer 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 discussion, 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 son invite système configurée.

Un agent personnalisé ne peut exécuter qu'une seule invocation à la fois. Si l'agent est déjà en cours d'exécution, vous devez attendre que l'appel en cours soit terminé, expiré ou 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 la planification, 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 de 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 être de l'un des formats suivants :

    • Expression de taux  : 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 l'un des jours du mois ou 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.

Une fois créé, le déclencheur apparaît dans la liste indiquant son expression, sa date de création et l'heure d'exécution planifiée suivante.

Vous pouvez également créer des déclencheurs par programmation. Utilisez les AWS kits SDK pour appeler l'CreateTriggeropération du devops-agent client, qui nécessite cette aidevops:CreateTrigger autorisation. Vous pouvez également modéliser les déclencheurs en tant que AWS::DevOpsAgent::Trigger ressources dans AWS CloudFormation. Un déclencheur basé sur une planification fait référence à l'agent personnalisé qu'il exécute. Créez donc d'abord l'agent. Pour plus d'informations sur le type de AWS::DevOpsAgent::Trigger ressource, consultezGestion des ressources.

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, la date de sa création et la date de sa prochaine exécution.

Suspendre un déclencheur :

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

Supprimer un déclencheur :

Pour supprimer définitivement un déclencheur, choisissez 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 une invocation en cours depuis la vue de la trajectoire d'invocation ou via Chat.

Pour annuler une invocation 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 la trajectoire.

Pour annuler une invocation en cours à l'aide de Chat : 

Cancel the running invocation of weekly-health-report.

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

Résultats des appels d'outils

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

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

  • Appels d'outils 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 appels d'outils individuels et leurs résultats dans la trajectoire d'invocation pour comprendre le comportement de l'agent, vérifier qu'il a accédé aux bonnes ressources et résoudre les problèmes liés aux résultats inattendus. Pour plus d'informations sur la visualisation des trajectoires, voir Visualisation d'une trajectoire d'invocation.