

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Gunakan Amazon CloudWatch Events di Amazon Augmented AI
<a name="a2i-cloudwatch-events"></a>

Amazon Augmented AI menggunakan CloudWatch Amazon Events untuk mengingatkan Anda saat status loop tinjauan manusia berubah `Completed` menjadi`Failed`,, `Stopped` atau. Pengiriman acara ini dijamin setidaknya sekali, yang berarti semua peristiwa yang dibuat saat loop manusia selesai berhasil dikirim ke CloudWatch Acara (Amazon EventBridge). Ketika loop tinjauan berubah ke salah satu status ini, Augmented AI mengirimkan acara CloudWatch ke Acara yang mirip dengan yang berikut ini.

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

Rincian dalam output JSON meliputi yang berikut:

`creationTime`  
Stempel waktu saat Augmented AI menciptakan loop manusia.

`failureCode`  
Kode kegagalan yang menunjukkan jenis kegagalan tertentu.

`failureReason`  
Alasan mengapa loop manusia gagal. Alasan kegagalan hanya dikembalikan ketika status loop tinjauan manusia adalah`failed`.

`flowDefinitionArn`  
Nama Sumber Daya Amazon (ARN) dari definisi alur, atau alur kerja *tinjauan manusia*.

`humanLoopArn`  
Nama Sumber Daya Amazon (ARN) dari lingkaran manusia.

`humanLoopName`  
Nama lingkaran manusia.

`humanLoopOutput`  
Objek yang berisi informasi tentang output loop manusia.

`outputS3Uri`  
Lokasi objek Amazon S3 tempat Augmented AI menyimpan output loop manusia Anda.

`humanLoopStatus`  
Status loop manusia.

## Kirim Acara dari Loop Manusia Anda ke CloudWatch Acara
<a name="a2i-cloud-watch-events-rule-setup"></a>

Untuk mengonfigurasi aturan CloudWatch Peristiwa untuk mendapatkan pembaruan status, atau *peristiwa*, untuk loop manusia Amazon A2I Anda, gunakan perintah AWS Command Line Interface (AWS CLI) [https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html). Saat menggunakan `put-rule` perintah, tentukan yang berikut ini untuk menerima status loop manusia: 
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`

Untuk mengonfigurasi aturan CloudWatch Acara untuk melihat semua perubahan status, gunakan perintah berikut dan ganti teks placeholder. Misalnya, ganti `"A2IHumanLoopStatusChanges"` dengan nama aturan CloudWatch Acara yang unik dan *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`* dengan Nomor Sumber Daya Amazon (ARN) peran IAM dengan kebijakan kepercayaan events.amazonaws.com terlampir. Ganti *region* dengan AWS Wilayah tempat Anda ingin membuat aturan. 

```
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"
```

Untuk mempelajari lebih lanjut tentang `put-rule` permintaan, lihat [Pola CloudWatch Peristiwa dalam Peristiwa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) di *Panduan Pengguna CloudWatch Acara Amazon*.

## Menyiapkan Target untuk Memproses Acara
<a name="a2i-subscribe-cloud-watch-events"></a>

Untuk memproses acara, Anda perlu mengatur target. Misalnya, jika Anda ingin menerima email saat status loop manusia berubah, gunakan prosedur dalam [Menyiapkan Notifikasi Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) di *Panduan CloudWatch Pengguna Amazon* untuk menyiapkan topik Amazon SNS dan berlangganan email Anda ke sana. Setelah Anda membuat topik, Anda dapat menggunakannya untuk membuat target. 

**Untuk menambahkan target ke aturan CloudWatch Acara Anda**

1. Buka CloudWatch konsol: [https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home)

1. Di panel navigasi, pilih **Aturan**.

1. Pilih aturan yang ingin Anda tambahkan target. 

1. Pilih **Tindakan**, dan kemudian pilih **Edit**.

1. Di bawah **Target****, pilih Tambahkan Target** dan pilih AWS layanan yang ingin Anda lakukan saat peristiwa perubahan status loop manusia terdeteksi. 

1. Konfigurasikan target Anda. Untuk petunjuk, lihat topik untuk mengonfigurasi target dalam [AWS dokumentasi untuk layanan tersebut](https://docs.aws.amazon.com/index.html).

1. Pilih **Konfigurasikan detail**.

1. Untuk **Nama**, masukkan nama dan, secara opsional, berikan detail tentang tujuan aturan di **Deskripsi**. 

1. Pastikan kotak centang di sebelah **Negara** dipilih sehingga aturan Anda terdaftar sebagai **Diaktifkan**. 

1. Pilih **Perbarui aturan**.

## Gunakan Output Tinjauan Manusia
<a name="using-human-review-output"></a>

Setelah Anda menerima hasil tinjauan manusia, Anda dapat menganalisis hasilnya dan membandingkannya dengan prediksi pembelajaran mesin. JSON yang disimpan di bucket Amazon S3 berisi prediksi pembelajaran mesin dan hasil tinjauan manusia.

## Informasi Selengkapnya
<a name="amazon-augmented-ai-programmatic-walkthroughs"></a>

[Peristiwa yang dikirimkan Amazon SageMaker AI ke Amazon EventBridge](automating-sagemaker-with-eventbridge.md)