Configuración de volantes de inercia a través de la API

También puede usar la API de Amazon Comprehend para crear, actualizar y eliminar volantes de inercia.

Al crear un volante de inercia, Amazon Comprehend crea un lago de datos para almacenar todos los datos que el volante necesita, como los datos de entrenamiento y los datos de prueba para cada versión del modelo.

Al eliminar un volante de inercia, Amazon Comprehend no eliminará el lago de datos ni el modelo asociado a ese volante.

La operación de eliminación del volante falla si dicho volante está ejecutando una iteración o creando un conjunto de datos.

Revise la información de la sección Creación del volante de inercia antes de crear un nuevo volante de inercia.

Crear un volante de inercia para un modelo existente

Utilice la CreateFlywheeloperación para crear un volante para un modelo existente.

aws comprehend create-flywheel  \
    --flywheel-name "myFlywheel2"  \
    --active-model-arn  "modelArn"  \
    --data-access-role-arn   arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --data-lake-s3-uri": "https://s3-bucket-endpoint"   \ 

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}     

Crear un volante de inercia para un modelo nuevo

Utilice la CreateFlywheeloperación para crear un volante para un nuevo modelo de clasificación personalizado.

aws comprehend create-flywheel \
    --flywheel-name "myFlywheel2" \
    --data-access-role-arn  arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --model-type "DOCUMENT_CLASSIFIER" \
    --data-lake-s3-uri  "s3Uri"  \
    --task-config  file://taskConfig.json         

{
    "LanguageCode": "en",
    "DocumentClassificationConfig": {
        "Mode": "MULTI_LABEL",
        "Labels": ["optimism", "anger"]
    } 
}       

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}  

Describir un volante de inercia

Utilice la DescribeFlywheeloperación Amazon Comprehend para recuperar la información configurada sobre un volante.

aws comprehend describe-flywheel \
    --flywheel-arn  "flywheelArn" 

El cuerpo de la respuesta de la API incluye el siguiente contenido.

{
  "FlywheelProperties": {
      "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
      "DataAccessRoleArn": "arn:aws::iam::111122223333:role/Admin",
      "TaskConfig": {
          "LanguageCode": "en",
          "DocumentClassificationConfig": {
              "Mode": "MULTI_LABEL"
          }
      },
      "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
      "Status": "ACTIVE",
      "ModelType":  "DOCUMENT_CLASSIFIER",
      "CreationTime": 1659318206.102,
      "LastModifiedTime": 1659318249.05
  }
}    

Actualizar un volante de inercia

Utilice la UpdateFlywheeloperación para actualizar los valores de configuración modificables del volante.

Algunos campos de configuración son estructuras JSON con subcampos. Para actualizar uno o más subcampos, proporcione los valores para todos los subcampos (Amazon Comprehend establece el valor en nulo para cualquier subcampo que falte en la solicitud).

Si omite un parámetro de nivel superior en la solicitud UpdateFlywheel, Amazon Comprehend no cambiará los valores del parámetro ni ninguno de sus subcampos en el volante de inercia.

Para añadir o eliminar etiquetas en el volante, utilice las TagResourceoperaciones y. UntagResource

También puede promover una versión del modelo a través de la configuración del parámetro ActiveModelArn, tal como se muestra en el siguiente ejemplo.

aws comprehend update-flywheel \
    --region aws-region \
    --flywheel-arn  "flywheelArn" \
    --active-model-arn  "modelArn" \

El cuerpo de la respuesta de la API incluye el siguiente contenido.

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}    

Eliminar un volante de inercia

Usa la DeleteFlywheeloperación Amazon Comprehend para eliminar los volantes.

aws comprehend delete-flywheel \
    --flywheel-arn  "flywheelArn" 

En una respuesta satisfactoria de la API se incluye un cuerpo de mensaje vacío

Enumerar los volantes de inercia

Utilice la ListFlywheelsoperación Amazon Comprehend para recuperar una lista de los volantes de inercia de la región actual.

aws comprehend list-flywheel \
    --region aws-region \
    --endpoint-url  "uri" 
    

El cuerpo de la respuesta de la API incluye el siguiente contenido.

{
    "FlywheelSummaryList": [
        {
            "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
            "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
            "Status": "ACTIVE",
            ""ModelType":  "DOCUMENT_CLASSIFIER",
            "CreationTime": 1659318206.102,
            "LastModifiedTime": 1659318249.05
        }
    ]
}