Utilizzo di Amazon CloudWatch Events in IA aumentata Amazon - Amazon SageMaker AI
Invio di eventi dal ciclo umano a Eventi CloudWatchConfigurazione di una destinazione per elaborare eventiUtilizza l'output delle revisioni umaneUlteriori informazioni

Utilizzo di Amazon CloudWatch Events in IA aumentata Amazon

IA aumentata Amazon utilizza Eventi Amazon CloudWatch per avvisarti quando lo stato di un ciclo di revisione umano cambia in Completed, Failed o Stopped. Questa distribuzione di eventi è garantita almeno una volta, il che significa che tutti gli eventi creati al termine dei cicli umani vengono consegnati correttamente a Eventi CloudWatch (Amazon EventBridge). Quando un ciclo di revisione passa a uno di questi stati, IA aumentata invia un evento a Eventi CloudWatch 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.

Invio di eventi dal ciclo umano a Eventi CloudWatch

Per configurare una regola Eventi CloudWatch per ottenere aggiornamenti di stato, o eventi, per i cicli umani Amazon A2I, utilizza il comando AWS Command Line Interface (AWS CLI) put-rule. 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 Eventi CloudWatch per controllare tutte le modifiche dello stato, utilizza il comando seguente e sostituisci il testo segnaposto. Ad esempio, sostituisci "A2IHumanLoopStatusChanges" con un nome regola Eventi CloudWatch univoco e "arn:aws:iam::111122223333:role/MyRoleForThisRule" con il nome della risorsa Amazon (ARN) di un ruolo IAM con una policy di attendibilità events.amazonaws.com collegata. Sostituisci la Regione con la Regione AWS 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 richiesta put-rule, consulta Event Patterns in CloudWatch Events nella Guida per l'utente di Eventi Amazon CloudWatch.

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 ciclo di revisione cambia, utilizza una procedura in Impostazione delle notifiche Amazon SNS nella Guida per l’utente di Amazon CloudWatch per impostare un argomento Amazon SNS e iscrivere la tua e-mail. Dopo aver creato un argomento, puoi utilizzarlo per creare una destinazione.

Per aggiungere una destinazione alla regola Eventi CloudWatch

  1. Apri la console CloudWatch: https://console.aws.amazon.com/cloudwatch/home

  2. Nel pannello di navigazione, scegli Regole.

  3. Scegli la regola a cui aggiungere una destinazione.

  4. Seleziona Azioni, quindi scegli Modifica.

  5. In Destinazioni, scegli Aggiungi destinazione e scegli il servizio AWS che desideri attivare quando viene rilevata una modifica dello stato del ciclo umano.

  6. Configurazione della destinazione. Per le istruzioni, consulta l'argomento relativo alla configurazione di una destinazione nella Documentazione AWS per tale servizio.

  7. Scegli Configura dettagli.

  8. In Nome, immetti un nome e, facoltativamente, fornisci dettagli sullo scopo della regola in Descrizione.

  9. Accertati che la casella di controllo accanto a Stato sia selezionata, in modo che la regola sia indicata come Abilitata.

  10. 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