

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 nell'intelligenza artificiale aumentata di Amazon
<a name="a2i-cloudwatch-events"></a>

**Nota**  
Amazon SageMaker A2I non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. AWS continua a investire in miglioramenti della sicurezza e della disponibilità per A2I, ma non prevediamo di introdurre nuove funzionalità.

Amazon Augmented AI utilizza Amazon CloudWatch Events per avvisarti quando lo stato di un ciclo di revisione umano cambia in`Completed`,, `Failed` o. `Stopped` 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 a CloudWatch 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 dal tuo Human Loop a CloudWatch Eventi
<a name="a2i-cloud-watch-events-rule-setup"></a>

Per configurare una regola CloudWatch Events per ottenere aggiornamenti di stato, o * eventi*, per i tuoi loop umani di Amazon A2I, usa il comando AWS Command Line Interface ()AWS CLI. [`put-rule`](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 di stato, usa il comando seguente e sostituisci il testo segnaposto. Ad esempio, sostituiscila `{{"A2IHumanLoopStatusChanges"}}` con un nome univoco di regola CloudWatch Events e {{`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`}} con l'Amazon Resource Number (ARN) di un ruolo IAM con allegata una politica di fiducia di events.amazonaws.com. Sostituisci {{region}} 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
<a name="a2i-subscribe-cloud-watch-events"></a>

Per elaborare gli eventi, è necessario configurare una destinazione. Ad esempio, se desideri ricevere un'email quando lo stato di un human loop cambia, utilizza una procedura in [ Configurazione delle notifiche di Amazon SNS ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) nella * Amazon CloudWatch User Guide * per impostare un argomento di Amazon SNS e iscriverti alla tua email. 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 ** Add Target ** e scegli il AWS servizio che desideri utilizzare quando viene rilevato un evento di modifica dello stato di human loop. 

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
<a name="using-human-review-output"></a>

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
<a name="amazon-augmented-ai-programmatic-walkthroughs"></a>

[Eventi che Amazon SageMaker AI invia ad Amazon EventBridge](automating-sagemaker-with-eventbridge.md)