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 :
Accédez à la page Agents de votre application Web DevOps Agent.
Choisissez l'agent personnalisé que vous souhaitez exécuter.
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.
Configuration des déclencheurs
Les déclencheurs exécutent automatiquement un agent personnalisé en fonction de conditions définies. AWS DevOps L'agent prend en charge deux types de déclencheurs :
Déclencheurs de planification : exécutez l'agent à intervalles récurrents à l'aide d'expressions EventBridge-compatible cron ou rate.
Déclencheurs d'événements : exécutez l'agent lorsqu'un événement webhook arrive depuis une intégration connectée, en transmettant la charge utile de l'événement comme contexte.
Les deux types de déclencheurs sont créés à partir de l'onglet Déclencheurs de l'agent personnalisé. Pour l'ouvrir, accédez à la page Agents de votre application Web DevOps Agent, choisissez l'agent personnalisé, puis cliquez sur l'onglet Déclencheurs.
Création d'un déclencheur de planification
Les expressions de planification utilisent la syntaxe EventBridge-compatible cron ou rate. 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 heuresrate(30 minutes)— Toutes les 30 minutesrate(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 UTCcron(0 0 1 * ? *)— Le premier jour de chaque mois à minuit UTCcron(0 */6 ? * * *)— Toutes les 6 heures
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.
Pour créer un déclencheur de planification :
Cliquez sur le bouton + (créer).
Pour Type de déclencheur, choisissez Planifier.
Entrez une expression de planification. Un message de confirmation vert apparaît lorsque l'expression est valide.
(Facultatif) Pour fournir un contexte supplémentaire pour chaque exécution planifiée, entrez une invite dans le champ Invite utilisateur (facultatif). L'invite est transmise à l'agent en même temps que son invite système.
Choisissez Créer.
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.
Création d'un déclencheur d'événement
Un déclencheur d'événements exécute l'agent personnalisé lorsqu'un événement webhook arrive depuis une intégration connectée. La charge utile de l'événement est transmise à l'agent en tant que contexte pour cette exécution.
Prérequis :
Avant de créer un déclencheur d'événement, vous devez disposer d'une intégration connectée avec un webhook actif dans votre espace agent. Toute intégration avec un webhook actif peut servir de source d'événements. Pour plus d’informations sur la configuration d’intégrations, consultez la section Invoquer un DevOps agent via Webhook.
Pour créer un déclencheur d'événement :
Cliquez sur le bouton + (créer).
Pour Type de déclencheur, choisissez Evénement.
Dans Source d'événements, choisissez l'intégration dont les événements du webhook doivent exécuter l'agent. Seules les intégrations avec un webhook actif sont répertoriées.
(Facultatif) Pour Filter l'expression, entrez une expression JMESPath pour filtrer et éventuellement transformer la charge utile de l'événement.
Choisissez Créer.
Si aucune source d'événement n'est répertoriée, soit aucune intégration compatible avec les webhooks n'existe dans l'espace agent, soit les autorisations et ne sont pas disponibles dans votre rôle. ListAssociations ListWebhooks
Expressions de filtre :
Vous pouvez éventuellement spécifier une expression de filtre JMESPath pour contrôler quels événements démarrent l'agent et quel contexte celui-ci reçoit. Les expressions de filtre sont évaluées par rapport à la racine brute de la charge utile de l'événement.
Syntaxe — Spécification JMESPath
Longueur maximale : 4 096 caractères
Validation — Les expressions non valides sont rejetées lorsque vous créez le déclencheur
L'expression du filtre agit à la fois comme une condition et, éventuellement, comme une projection :
Lorsque le résultat n'est pas
nullune chaîne vide, un tableau vide ou un objet vide, le déclencheur s'exécute.falseLorsque le résultat est booléen
true(par exemple, un prédicat likeseverity == 'critical'), l'agent reçoit la charge utile brute de l'événement en tant que contexte.Lorsque le résultat est une autre valeur véridique (par exemple, une projection similaire
{sev: severity}), l'agent reçoit le résultat projeté sous forme de contexte.
AWS DevOps L'agent tronque ce contexte à 10 000 caractères.
Si vous laissez l'expression de filtre vide, l'agent s'exécute sur chaque événement provenant de cette source et reçoit la charge utile brute de l'événement en tant que contexte.
Note
Une projection dont l'évaluation donne lieu à un objet ou à un tableau vide est considérée comme ne correspondant pas et l'agent ne s'exécute pas. Pour transmettre une valeur éventuellement vide, enveloppez-la dans un objet littéral. Par exemple, {payload: details}.
Exemples d'expressions de filtre :
severity == 'critical'— Prédicat : exécute l'agent uniquement lorsque la gravité est critique, en transmettant la charge utile brute de l'événement comme contexte.{sev: severity}— Projection : exécute l'agent sur chaque événement, en passant un objet contenant uniquement le champ de gravité comme contexte. Comme un hachage à sélection multiple inclut toujours ses clés, le résultat n'est jamais vide et ne filtre pas.
La forme de la charge utile étant différente pour chaque source, les champs disponibles dépendent de l'intégration. Lorsqu'un événement arrive mais qu'un déclencheur ne s'exécute pas, AWS DevOps l'agent émet une notification expliquant pourquoi. Par exemple, l'avis peut indiquer que l'expression du filtre ne correspond à rien. L'avis répertorie également les champs de niveau supérieur présents dans cette charge utile. Pour de plus amples informations, veuillez consulter Logs et statistiques vendus.
Création de déclencheurs par programmation
Vous pouvez également créer des déclencheurs par programmation à l'aide des AWS SDK. Appelez l'CreateTriggeropération du devops-agent client, qui nécessite l'aidevops:CreateTriggerautorisation. Définissez le type de déclencheur sur TIME_BASED et fournissez une condition de planification contenant l'expression de planification et une invite utilisateur facultative.
Vous pouvez également modéliser des déclencheurs basés sur un calendrier en tant que ressources dansAWS::DevOpsAgent::Trigger. AWS CloudFormation Un déclencheur fait référence à l'agent personnalisé qu'il exécute. Créez 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é. Un déclencheur de planification affiche son expression de planification. Un déclencheur d'événement affiche sa source d'événement et, s'il est défini, son expression de filtre. Les deux types indiquent la date de création.
Si l'intégration de la source ou son webhook est supprimé, un déclencheur d'événement reste répertorié mais indique que la source n'est plus disponible et qu'il ne s'exécute pas.
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 s'exécute plus tant qu'il n'est pas réactivé. Réactivez la bascule pour reprendre.
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 :
Dans l'onglet Historique, choisissez l'invocation en cours.
Choisissez Annuler en haut de la vue des trajectoires.
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_logsrenvoie des entrées de journal ouuse_awsrenvoie 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.
