Utilisation Amazon CloudWatch Events dans Amazon Augmented AI - Amazon SageMaker
Envoyez des événements de votre boucle humaine vers CloudWatch des événementsConfiguration d'une cible pour traiter les événementsUtilisation de la sortie de la vérification humaineEn savoir plus

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 à CompletedFailed, ouStopped. 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 put-rulecommande 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 la AWS région par la 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 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 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

  2. Dans le panneau de navigation, choisissez Règles.

  3. Choisissez la règle à laquelle vous souhaitez ajouter une cible.

  4. Sélectionnez Actions, puis Edit (Modifier).

  5. 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é.

  6. Configurez votre cible. Pour obtenir des instructions, veuillez consulter la rubrique relative à la configuration d'une cible dans la documentation AWS correspondant à ce service.

  7. Choisissez Configurer les détails.

  8. 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.

  9. Assurez-vous que la case en regard de État est cochée afin que l'état de votre règle soit Activé.

  10. 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 envoie à Amazon EventBridge