Verwendung Amazon CloudWatch Events in Amazon Augmented AI

Amazon Augmented AI verwendet Amazon CloudWatch Events, um Sie zu benachrichtigen, wenn sich der Status einer menschlichen Überprüfungsschleife auf CompletedFailed, oder ändertStopped. Diese Ereigniszustellung wird mindestens einmal garantiert, was bedeutet, dass alle Ereignisse, die entstehen, wenn menschliche Schleifen beendet sind, erfolgreich an CloudWatch Events (Amazon EventBridge) übertragen werden. Wenn eine Überprüfungsschleife 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).

Senden Sie Ereignisse aus „Your Human Loop“ an „ CloudWatch Ereignisse“

Verwenden Sie den put-ruleBefehl AWS Command Line Interface (AWS CLI), um eine CloudWatch Ereignisregel zum Abrufen von Statusaktualisierungen oder Ereignissen für Ihre Amazon A2I Human Loops zu konfigurieren. 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 Ereignisregel so zu konfigurieren, dass alle Statusänderungen überwacht werden, verwenden Sie den folgenden Befehl und ersetzen Sie den Platzhaltertext. "A2IHumanLoopStatusChanges"Ersetzen Sie es beispielsweise durch einen eindeutigen Namen für die CloudWatch Events-Regel und "arn:aws:iam::111122223333:role/MyRoleForThisRule"durch die Amazon-Ressourcennummer (ARN) einer IAM-Rolle, der eine Events.amazonaws.com-Vertrauensrichtlinie beigefügt ist. Ersetzen Sie 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 der put-rule Anfrage finden Sie unter Event Patterns in CloudWatch Events im Amazon CloudWatch Events-Benutzerhandbuch.

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 Status eines Human Loop ändert, verwenden Sie ein Verfahren unter Einrichten von Amazon SNS SNS-Benachrichtigungen im CloudWatch Amazon-Benutzerhandbuch, um ein Amazon SNS-Thema einzurichten und es mit Ihrer E-Mail zu abonnieren. Sobald Sie ein Thema erstellt haben, können Sie es zum Erstellen eines Ziels verwenden.

Um Ihrer Event-Regel ein Ziel hinzuzufügen CloudWatch

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 Ziele die Option Ziel hinzufügen und wählen Sie den AWS Service aus, auf den Sie reagieren möchten, wenn ein menschliches Ereignis zur Statusänderung 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

Amazon SageMaker mit Amazon automatisieren EventBridge