Usar Amazon CloudWatch Events en Amazon Augmented AI - Amazon SageMaker AI
Enviar eventos desde un bucle humano a los eventos de CloudWatchConfigurar un destino para procesar eventosUsar resultado de revisión humanaMás información

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Usar Amazon CloudWatch Events en Amazon Augmented AI

Amazon Augmented AI utiliza los eventos de Amazon CloudWatch para avisarle cuando el estado de un bucle de revisión humana cambia a Completed, Failed o Stopped. 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 envían correctamente a los eventos de CloudWatch (Amazon EventBridge). Cuando un ciclo de revisión cambia a uno de estos estados, Augmented AI le envía a los eventos de CloudWatch un evento 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.

Enviar eventos desde un bucle humano a los eventos de CloudWatch

Para configurar una regla para los eventos de CloudWatch a fin de obtener actualizaciones de estado, o eventos, para los bucles humanos de Amazon A2I, utilice el comando put-rule de AWS Command Line Interface (AWS CLI). 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 eventos de CloudWatch a fin de observar todos los cambios de estado, utilice el siguiente comando y sustituya el texto del marcador de posición. Por ejemplo, reemplace "A2IHumanLoopStatusChanges" por un nombre de regla de eventos de CloudWatch único y reemplace "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 events.amazonaws.com asociada. Reemplace la región por la región de AWS en la que desea 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 solicitud de put-rule, consulte Patrones de eventos en eventos de CloudWatch, en la Guía del usuario de eventos de Amazon CloudWatch.

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 un procedimiento de Configuración de notificaciones de Amazon SNS, en la Guía del usuario de Amazon CloudWatch, para configurar un tema de Amazon SNS y suscribir su correo electrónico a este. Una vez que haya creado un tema, puede usarlo para crear un objetivo.

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

  1. Abra la consola de CloudWatch: 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 (Destinos), elija Add target (Agregar destino) y elija el servicio de AWS que desea accionar cuando se detecte un evento de cambio de estado de 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

Eventos que Amazon SageMaker AI envía a Amazon EventBridge