本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon 增強版 AI Amazon CloudWatch Events 中使用
Amazon 增強版 AI 使用 Amazon CloudWatch Events 在人工審核循環狀態變更為`Completed`、`Failed`或`Stopped`時提醒您。至少保證一次此事件交付，這表示在人工循環完成時建立的所有事件都會成功交付至 CloudWatch Events (Amazon EventBridge)。當審核循環變為其中一種狀態時，增強版 AI 會向 CloudWatch 事件發送類似於以下內容的事件。
```
{
"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"
}
}
```
JSON 輸出中的詳細資料包括：
`creationTime`
增強版 AI 建立人工循環時的時間戳記。
`failureCode`
表示特定失敗類型的失敗代碼。
`failureReason`
人工循環失敗的原因。只有當人工審核循環狀態為`failed`時，才會傳回失敗原因。
`flowDefinitionArn`
流程定義或*人工審核工作流程*的 Amazon Resource Name (ARN)。
`humanLoopArn`
人工循環的 Amazon Resource Name (ARN)。
`humanLoopName`
人工循環的名稱。
`humanLoopOutput`
此物件包含人工循環輸出的相關資訊。
`outputS3Uri`
Amazon S3 物件的位置，供增強版 AI 存放人工循環的輸出。
`humanLoopStatus`
人工循環的狀態。
## 從您的人工循環將事件傳到 CloudWatch Events
若要設定 CloudWatch Events 規則以取得 Amazon A2I 人工迴圈的狀態更新或*事件*，請使用 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)命令。使用 `put-rule` 命令時，請指定下列項目以接收人工循環狀態：
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`
若要將 CloudWatch Events 規則設定為監控所有狀態變更，請使用下列命令並取代預留位置文字。例如，用唯一的 CloudWatch Events 規則名稱取代 `"A2IHumanLoopStatusChanges"`，並用 IAM 角色的 Amazon Resource Number (ARN) 取代 *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`*，並連接一個events.amazonaws.com 信任政策。將*區域*取代為您要建立規則 AWS 的區域。
```
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"
```
要瞭解更多關於 `put-rule` 請求，請參閱 [CloudWatch 事件中的事件模式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)，在 *Amazon CloudWatch Events 用戶指南*中。
## 設定目標以處理事件
要處理事件，你需要設置一個目標。例如，如果您希望在人工循環狀態發生更改時接收電子郵件，請使用 *Amazon CloudWatch 使用者指南*中的[設置 Amazon SNS 通知](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html)程序，來設置 Amazon SNS 主題並訂閱您的電子郵件。主題建立後，您便可以用來建立目標。
**將目標新增至您的 CloudWatch Events 規則**
1. 開啟 CloudWatch 主控台：[https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home)
1. 在導覽窗格中，選擇**規則**。
1. 選擇您要新增目標的規則。
1. 選擇**動作**，然後選擇**編輯**。
1. 在**目標**下，選擇**新增目標**，然後選擇在偵測到人工循環狀態變更事件時要採取行動 AWS 的服務。
1. 設定您的目標。如需說明，請參閱該服務的[AWS 文件](https://docs.aws.amazon.com/index.html)中關於設定目標的主題。
1. 選擇**設定詳細資訊**。
1. 在**名稱**中輸入名稱，並在**描述**中提供有關規則用途的詳細資訊 (選擇性)。
1. 請確定**狀態**旁的核取方塊已選取，以便您的規則會列為**已啟用**。
1. 選擇**更新規則**。
## 使用人工審核輸出
收到人工審核結果後，您可以分析結果，並與機器學習預測進行比較。存放在 Amazon S3 儲存貯體中的 JSON 包含機器學習預測和人工審核結果。
## 詳細資訊
[Amazon SageMaker AI 傳送至 Amazon EventBridge 的事件](automating-sagemaker-with-eventbridge.md)