Configuration des volants à l'aide de l'API

Vous pouvez utiliser l'API Amazon Comprehend pour créer, mettre à jour et supprimer des volants.

Lorsque vous créez un volant, Amazon Comprehend crée un lac de données contenant toutes les données dont le volant a besoin, telles que les données d'entraînement et les données de test pour chaque version du modèle.

Lorsque vous supprimez un volant, Amazon Comprehend ne supprime pas le lac de données ni le modèle associé au volant.

L'opération de suppression du volant échoue si le volant exécute une itération ou crée un jeu de données.

Consultez les informations de la section Création d'un volant avant de créer un nouveau volant.

Création d'un volant pour un modèle existant

Utilisez cette CreateFlywheelopération pour créer un volant d'inertie pour un modèle existant.

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

Création d'un volant pour un nouveau modèle

Utilisez cette CreateFlywheelopération pour créer un volant d'inertie pour un nouveau modèle de classification personnalisé.

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

Décrire un volant

Utilisez l'DescribeFlywheelopération Amazon Comprehend pour récupérer les informations configurées concernant un volant d'inertie.

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

Le corps de réponse de l'API inclut le contenu suivant.

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

Mettre à jour un volant

Utilisez cette UpdateFlywheelopération pour mettre à jour les valeurs de configuration modifiables du volant.

Certains champs de configuration sont des structures JSON avec des sous-champs. Pour mettre à jour un ou plusieurs sous-champs, fournissez des valeurs pour tous les sous-champs (Amazon Comprehend définit la valeur sur null pour tout sous-champ manquant dans la demande).

Si vous omettez un paramètre de premier niveau dans la UpdateFlywheel demande, Amazon Comprehend ne modifie pas les valeurs du paramètre ou de ses sous-champs dans le volant.

Pour ajouter ou supprimer des tags sur le volant, utilisez les UntagResourceopérations TagResourceet.

Vous pouvez promouvoir une version de modèle en définissant le ActiveModelArn paramètre, comme illustré dans l'exemple suivant.

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

Le corps de réponse de l'API inclut le contenu suivant.

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

Supprimer un volant

Utilisez l'DeleteFlywheelopération Amazon Comprehend pour supprimer les volants.

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

Une réponse API réussie contient un corps de message de réponse vide

Listez les volants

Utilisez l'ListFlywheelsopération Amazon Comprehend pour récupérer la liste des volants de la région actuelle.

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

Le corps de réponse de l'API inclut le contenu suivant.

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