Verwenden von Amazon CloudWatch Events in Amazon Augmented AI - Amazon SageMaker AI
Ereignisse von Ihrem Human Loop an CloudWatch Events sendenEinrichten eines Ziels für die Verarbeitung von EreignissenVerwenden der Ausgabe der Prüfung durch Menschen (Human Review)Weitere Informationen

Verwenden von Amazon CloudWatch Events in Amazon Augmented AI

Amazon Augmented AI verwendet Amazon CloudWatch Events, um Sie zu benachrichtigen, wenn sich der Status einer Human-Loop-Überprüfung auf Completed, Failed oder Stopped. Diese Ereigniszustellung wird mindestens einmal garantiert, was bedeutet, dass alle Ereignisse, die entstehen, wenn Human Loops beendet sind, erfolgreich an CloudWatch Events (Amazon EventBridge) übermittelt werden. Wenn eine Human-Loop-Überprüfung in einen dieser Zustände wechselt, sendet Augmented AI ein Ereignis an CloudWatch Events, das dem Folgenden ähnelt.

{
    "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"
    }
}

Die Details in der JSON-Ausgabe umfassen Folgendes:

creationTime

Der Zeitstempel, als die Human Loop von Augmented AI erstellt wurde.

failureCode

Ein Fehlercode, der einen bestimmten Fehlertyp angibt.

failureReason

Der Grund für das Scheitern einer menschlichen Schleife (Human Loop). Der Fehlergrund wird nur zurückgegeben, wenn der Status der Schleife für die Prüfung durch Menschen (Human Review Loop) failed ist.

flowDefinitionArn

Der Amazon Resource Name (ARN) der Flow-Definition oder Workflow für die Prüfung durch Menschen (Human Review).

humanLoopArn

Der Amazon-Ressourcenname (ARN) der menschlichen Schleife (Human Loop).

humanLoopName

Der Name der menschliche (Human Loop).

humanLoopOutput

Ein Objekt, das Informationen über die Ausgabe der menschlichen Schleife (Human Loop) enthält.

outputS3Uri

Die Position des Amazon S3-Objekts, in dem Augmented AI die Ausgabe der Human Loop speichert.

humanLoopStatus

Der Status der menschlichen Schleife (Human Loop).

Ereignisse von Ihrem Human Loop an CloudWatch Events senden

Zum Konfigurieren einer CloudWatch Events-Regel, um Statusaktualisierungen oder Ereignisse für Ihre Amazon A2I Human Loops abzurufen, verwenden Sie den AWS Command Line Interface (AWS CLI) put-rule Befehl. Geben Sie bei Verwendung des Befehls put-rule Folgendes an, um Human-Loop-Status zu erhalten:

  • \"source\":[\"aws.sagemaker\"]

  • \"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]

Um eine CloudWatch Events-Regel zur Überwachung aller Statusänderungen zu konfigurieren, verwenden Sie den folgenden Befehl und ersetzen Sie den Platzhaltertext. Ersetzen Sie beispielsweise "A2IHumanLoopStatusChanges" durch einen eindeutigen CloudWatch Events-Regelnamen und "arn:aws:iam::111122223333:role/MyRoleForThisRule" durch die Amazon-Ressourcennummer (ARN) einer IAM-Rolle, der eine Vertrauensrichtlinie events.amazonaws.com angefügt ist. Ersetzen Sie die Region durch die AWS-Region, in der Sie die Regel erstellen möchten. 

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"

Weitere Informationen zu put-rule finden Sie unter Ereignismuster in CloudWatch-Ereignisse im Benutzerhandbuch für Amazon CloudWatch Events.

Einrichten eines Ziels für die Verarbeitung von Ereignissen

Um Ereignisse zu verarbeiten, müssen Sie ein Ziel einrichten. Wenn Sie beispielsweise eine E-Mail erhalten möchten, wenn sich der Human-Loop-Status ändert, verwenden Sie ein Verfahren in Amazon SNS-Benachrichtigungen einrichten im Benutzerhandbuch für Amazon CloudWatch, um ein Amazon SNS-Thema einzurichten und Ihre E-Mail hierfür zu abonnieren. Sobald Sie ein Thema erstellt haben, können Sie es zum Erstellen eines Ziels verwenden.

Hinzufügen eines Ziels zu Ihrer CloudWatch-Events-Regel

  1. Öffnen Sie die CloudWatch-Konsole: https://console.aws.amazon.com/cloudwatch/home

  2. Wählen Sie im Navigationsbereich Regeln aus.

  3. Wählen Sie die Regel aus, der Sie ein Ziel hinzufügen möchten.

  4. Wählen Sie Actions und anschließend Bearbeiten.

  5. Wählen Sie unter Targets (Ziele) die Option Add Target (Ziel hinzufügen) aus und legen Sie den AWS-Service fest, den Sie verwenden möchten, wenn ein Statusänderungsereignis für die Human Loop erkannt wird.

  6. Konfigurieren Sie Ihr Ziel. Anweisungen finden Sie im Thema zum Konfigurieren eines Ziels in der AWS Dokumentation für diesen Service.

  7. Wählen Sie Details konfigurieren.

  8. Geben Sie unter Name einen Namen und unter Description (Beschreibung) optional Details zum Zweck der Regel an.

  9. Stellen Sie sicher, dass das Kontrollkästchen neben State (Status) aktiviert ist, damit Ihre Regel als Enabled (Aktiviert) aufgeführt wird.

  10. Wählen Sie Regel aktualisieren aus.

Verwenden der Ausgabe der Prüfung durch Menschen (Human Review)

Nachdem Sie Ergebnisse für die Prüfung durch Menschen (Human Review) erhalten haben, können Sie die Ergebnisse analysieren und mit Machine-Learning-Vorhersagen vergleichen. Das im Amazon-S3-Bucket gespeicherte JSON enthält sowohl die Machine-Learning-Vorhersagen als auch die Ergebnisse der menschlichen Prüfung.

Weitere Informationen

Ereignisse, die Amazon SageMaker AI an Amazon EventBridge sendet