Uso Amazon CloudWatch Events en Amazon Augmented AI

Amazon Augmented AI utiliza Amazon CloudWatch Events para avisarte cuando el estado de un bucle de revisión humana cambia a CompletedFailed,, oStopped. La entrega de este evento está garantizada al menos una vez, lo que significa que todos los eventos creados cuando finalizan los bucles humanos se entregan correctamente a CloudWatch Events (Amazon EventBridge). Cuando un ciclo de revisión cambia a uno de estos estados, Augmented AI envía un evento a CloudWatch Eventos similar al siguiente.

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

Los detalles de la salida JSON incluyen lo siguiente:

creationTime

El timestamp cuando Augmented AI creó el bucle humano.

failureCode

El código de error que indica un tipo específico de error.

failureReason

La razón por la que ha fallado un bucle humano. El motivo del error solo se devuelve cuando el estado del bucle de revisión humana es failed.

flowDefinitionArn

El nombre de recurso de Amazon (ARN) de la definición de flujo o el flujo de trabajo de revisión humana.

humanLoopArn

El nombre de recurso de Amazon (ARN) del bucle humano.

humanLoopName

El nombre del bucle humano.

humanLoopOutput

Un objeto que contiene información sobre el resultado del bucle humano.

outputS3Uri

La ubicación del objeto de Amazon S3 donde Augmented AI almacena el resultado del bucle humano.

humanLoopStatus

El estado del bucle humano.

Envía eventos de tu bucle humano a CloudWatch Eventos

Para configurar una regla de CloudWatch eventos para obtener actualizaciones de estado, o eventos, para sus bucles humanos de Amazon A2I, utilice el comando AWS Command Line Interface (AWS CLI) put-rule. Al utilizar el comando put-rule, especifique lo siguiente para recibir los estados del bucle humano:

• \"source\":[\"aws.sagemaker\"]

• \"detail-type\":[\"SageMaker A2I HumanLoop Status Change\"]

Para configurar una regla de CloudWatch eventos que controle todos los cambios de estado, utilice el siguiente comando y sustituya el texto del marcador de posición. Por ejemplo, "A2IHumanLoopStatusChanges" sustitúyalo por un nombre de regla de CloudWatch eventos único y "arn:aws:iam::111122223333:role/MyRoleForThisRule"por el número de recurso de Amazon (ARN) de un rol de IAM con una política de confianza de events.amazonaws.com adjunta. Sustituya la región por la AWS región en la que desee crear la regla.

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"

Para obtener más información sobre la put-rule solicitud, consulte Patrones de CloudWatch eventos en eventos en la Guía del usuario de Amazon CloudWatch Events.

Configurar un destino para procesar eventos

Para procesar eventos, debe configurar un destino. Por ejemplo, si desea recibir un correo electrónico cuando cambie el estado de un bucle humano, utilice el procedimiento descrito en Configuración de notificaciones de Amazon SNS en la Guía del CloudWatch usuario de Amazon para configurar un tema de Amazon SNS y suscribir su correo electrónico a él. Una vez que haya creado un tema, puede usarlo para crear un objetivo.

Para añadir un objetivo a la regla de eventos CloudWatch

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

2. En el panel de navegación, seleccione Reglas.

3. Elija la regla a la que desea agregar un objetivo.

4. Seleccione Acciones y, a continuación, Editar.

5. En Targets, selecciona Añadir destino y elige el AWS servicio en el que quieres que actúe cuando se detecte un evento de cambio de estado en bucle humano.

6. Configure el destino. Para obtener instrucciones, consulte el tema sobre la configuración de un destino en la documentación de AWS para ese servicio.

7. Seleccione Configurar los detalles.

8. En Nombre, introduzca un nombre y, opcionalmente, proporcione detalles sobre el propósito de la regla en Descripción.

9. Asegúrese de que la casilla de verificación situada junto a Estado está activada para que la regla aparezca como Habilitada.

10. Elija Actualizar regla.

Usar resultado de revisión humana

Después de recibir los resultados de la revisión humana, puede analizar los resultados y compararlos con las predicciones de machine learning. El JSON que se almacena en el bucket de Amazon S3 contiene tanto las predicciones de machine learning como los resultados de la revisión humana.

Más información

Automatizar Amazon SageMaker con Amazon EventBridge