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.
# Utilisation Amazon CloudWatch Events dans Amazon Augmented AI
Amazon Augmented AI utilise Amazon CloudWatch Events pour vous avertir lorsque le statut d'une boucle de révision humaine passe à `Completed``Failed`, ou`Stopped`. La diffusion de cet événement est garantie au moins une fois, ce qui signifie que tous les événements créés lorsque les boucles humaines se terminent sont transmis avec succès à CloudWatch Events (Amazon EventBridge). Lorsqu'une boucle de révision passe à l'un de ces états, Augmented AI envoie un événement à CloudWatch Events similaire au suivant.
```
{
"version":"0",
"id":"12345678-1111-2222-3333-12345EXAMPLE",
"detail-type":"SageMaker A2I HumanLoop Status Change",
"source":"aws.sagemaker",
"account":"1111111111111",
"time":"2019-11-14T17:49:25Z",
"region":"us-east-1",
"resources":["arn:aws:sagemaker:us-east-1:111111111111:human-loop/humanloop-nov-14-1"],
"detail":{
"creationTime":"2019-11-14T17:37:36.740Z",
"failureCode":null,
"failureReason":null,
"flowDefinitionArn":"arn:aws:sagemaker:us-east-1:111111111111:flow-definition/flowdef-nov-12",
"humanLoopArn":"arn:aws:sagemaker:us-east-1:111111111111:human-loop/humanloop-nov-14-1",
"humanLoopName":"humanloop-nov-14-1",
"humanLoopOutput":{
"outputS3Uri":"s3://customer-output-bucket-specified-in-flow-definition/flowdef-nov-12/2019/11/14/17/37/36/humanloop-nov-14-1/output.json"
},
"humanLoopStatus":"Completed"
}
}
```
Les détails de la sortie JSON sont les suivants :
`creationTime`
Horodatage lors de la création de la boucle humaine par Augmented AI.
`failureCode`
Code d'échec désignant un type spécifique d’échec.
`failureReason`
Raison pour laquelle une boucle humaine a échoué. La raison de l'échec n'est renvoyée que lorsque l'état de la boucle de vérification humaine est `failed`.
`flowDefinitionArn`
Amazon Resource Name (ARN) de la définition de flux, ou *flux de vérification humaine*.
`humanLoopArn`
Amazon Resource Name (ARN) de la boucle humaine.
`humanLoopName`
Nom de la boucle humaine.
`humanLoopOutput`
Objet contenant des informations sur la sortie de la boucle humaine.
`outputS3Uri`
Emplacement de l'objet Amazon S3 où Augmented AI stocke la sortie de votre boucle humaine.
`humanLoopStatus`
État de la boucle humaine.
## Envoyez des événements de votre boucle humaine vers CloudWatch des événements
Pour configurer une règle d' CloudWatch événements afin d'obtenir des mises à jour de statut, ou *des événements*, pour vos boucles humaines Amazon A2I, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html)commande AWS Command Line Interface (AWS CLI). Lorsque vous utilisez la commande `put-rule`, spécifiez les éléments suivants afin de recevoir les états des boucles humaines :
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`
Pour configurer une règle d' CloudWatch événements afin de surveiller tous les changements de statut, utilisez la commande suivante et remplacez le texte de l'espace réservé. Par exemple, remplacez-le `"A2IHumanLoopStatusChanges"` par un nom de règle CloudWatch Events unique et *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`* par le numéro de ressource Amazon (ARN) d'un rôle IAM auquel est attachée une politique de confiance events.amazonaws.com. Remplacez *region* par la AWS région dans laquelle vous souhaitez créer la règle.
```
aws events put-rule --name "A2IHumanLoopStatusChanges"
--event-pattern "{\"source\":[\"aws.sagemaker\"],\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]}"
--role-arn "arn:aws:iam::111122223333:role/MyRoleForThisRule"
--region "region"
```
Pour en savoir plus sur cette `put-rule` demande, consultez la section [Event Patterns in CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) dans le *guide de l'utilisateur Amazon CloudWatch Events*.
## Configuration d’une cible pour traiter les événements
Pour traiter les événements, vous devez configurer une cible. Par exemple, si vous souhaitez recevoir un e-mail lorsque le statut d'une boucle humaine change, utilisez une procédure décrite dans la [section Configuration des notifications Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) dans le *guide de CloudWatch l'utilisateur Amazon* pour configurer une rubrique Amazon SNS et y abonner votre e-mail. Une fois que vous avez créé une rubrique, vous pouvez l'utiliser pour créer une cible.
**Pour ajouter une cible à votre règle CloudWatch d'événements**
1. Ouvrez la CloudWatch console : [https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home)
1. Dans le panneau de navigation, choisissez **Règles**.
1. Choisissez la règle à laquelle vous souhaitez ajouter une cible.
1. Sélectionnez **Actions**, puis **Edit** (Modifier).
1. Sous **Cibles**, choisissez **Ajouter une cible** et choisissez le AWS service que vous souhaitez utiliser lorsqu'un événement de changement d'état de la boucle humaine est détecté.
1. Configurez votre cible. Pour obtenir des instructions, consultez la rubrique relative à la configuration d’une cible dans la [documentation AWS correspondant à ce service](https://docs.aws.amazon.com/index.html).
1. Choisissez **Configurer les détails**.
1. Dans la zone **Nom**, saisissez un nom. Si vous le souhaitez, vous pouvez fournir des détails sur l’objet de la règle dans **Description**.
1. Assurez-vous que la case en regard de **État** est cochée afin que l’état de votre règle soit **Activé**.
1. Choisissez **Mettre à jour la règle**.
## Utilisation de la sortie de la vérification humaine
Après avoir reçu les résultats de la vérification humaine, vous pouvez les analyser et les comparer aux prédictions de machine learning. Le code JSON stocké dans le compartiment Amazon S3 contient à la fois les prédictions de machine learning et les résultats de la vérification humaine.
## En savoir plus
[Événements qu'Amazon SageMaker AI envoie à Amazon EventBridge](automating-sagemaker-with-eventbridge.md)