Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo Amazon CloudWatch Events in Amazon Augmented AI
Amazon Augmented AI utilizza CloudWatch Amazon Events per avvisarti quando lo stato di un ciclo di revisione umano cambia `Completed` in`Failed`, `Stopped` o. La consegna di questo evento è garantita almeno una volta, il che significa che tutti gli eventi creati al termine dei loop umani vengono consegnati con successo a CloudWatch Events (Amazon EventBridge). Quando un ciclo di revisione passa a uno di questi stati, Augmented AI invia un evento CloudWatch a Events simile al seguente.
```
{
"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"
}
}
```
I dettagli nell'output JSON includono quanto segue:
`creationTime`
Il timestamp di quando IA aumentata ha creato il ciclo umano.
`failureCode`
Un codice di errore che indica un tipo di errore specifico.
`failureReason`
Il motivo per cui un ciclo umano ha riscontrato un errore. Il motivo dell'errore viene restituito solo quando lo stato del ciclo di revisione umana è `failed`.
`flowDefinitionArn`
Il nome della risorsa Amazon (ARN) della definizione del flusso o del flusso di *lavoro di revisione umana*.
`humanLoopArn`
Il nome della risorsa Amazon (ARN) del ciclo umano.
`humanLoopName`
Il nome del ciclo umano.
`humanLoopOutput`
Un oggetto contenente informazioni sull'output del ciclo umano.
`outputS3Uri`
La posizione dell'oggetto Amazon S3 in cui IA aumentata memorizza l'output del ciclo umano.
`humanLoopStatus`
Lo stato del ciclo umano.
## Invia eventi da Your Human Loop a CloudWatch Events
Per configurare una regola CloudWatch Events per ottenere aggiornamenti di stato, o *eventi*, per i loop umani di Amazon A2I, usa il comando 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) Quando utilizzi il comando `put-rule`, specifica quanto segue per ricevere gli stati del ciclo umano:
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]`
Per configurare una regola CloudWatch Events per controllare tutte le modifiche allo stato, usa il seguente comando e sostituisci il testo segnaposto. Ad esempio, sostituiscilo `"A2IHumanLoopStatusChanges"` con un nome di regola CloudWatch Events univoco e *`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`* con l'Amazon Resource Number (ARN) di un ruolo IAM con una policy di fiducia events.amazonaws.com allegata. *region*Sostituiscilo con la AWS regione in cui desideri creare la regola.
```
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"
```
Per ulteriori informazioni sulla `put-rule` richiesta, consulta [Event Patterns in CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) nella *Amazon CloudWatch Events User Guide*.
## Configurazione di una destinazione per elaborare eventi
Per elaborare gli eventi, è necessario configurare una destinazione. Ad esempio, se desideri ricevere un'e-mail quando lo stato di un loop umano cambia, utilizza una procedura in [Configurazione delle notifiche Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) nella *Amazon CloudWatch User Guide* per impostare un argomento Amazon SNS e iscrivere la tua e-mail ad esso. Dopo aver creato un argomento, puoi utilizzarlo per creare una destinazione.
**Per aggiungere un obiettivo alla tua regola Events CloudWatch**
1. Apri la CloudWatch console: [https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home)
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli la regola a cui aggiungere una destinazione.
1. Seleziona **Azioni**, quindi scegli **Modifica**.
1. **In Target, scegli **Aggiungi target** e scegli il AWS servizio che desideri utilizzare quando viene rilevato un evento di modifica dello stato del loop umano.**
1. Configurazione della destinazione. Per le istruzioni, consulta l'argomento relativo alla configurazione di una destinazione nella [Documentazione AWS per tale servizio](https://docs.aws.amazon.com/index.html).
1. Scegli **Configura dettagli**.
1. In **Nome**, immetti un nome e, facoltativamente, fornisci dettagli sullo scopo della regola in **Descrizione**.
1. Accertati che la casella di controllo accanto a **Stato** sia selezionata, in modo che la regola sia indicata come **Abilitata**.
1. Scegli **Aggiorna regola**.
## Utilizza l'output delle revisioni umane
Dopo aver ricevuto i risultati delle revisioni umane, puoi analizzare i risultati e confrontarli con le previsioni di Machine Learning. Il JSON memorizzato nel bucket Amazon S3 contiene sia le previsioni di Machine Learning sia i risultati della revisione umana.
## Ulteriori informazioni
[Eventi che Amazon SageMaker AI invia ad Amazon EventBridge](automating-sagemaker-with-eventbridge.md)