Configurazione dei volani tramite l'API

Puoi utilizzare l'API Amazon Comprehend per creare, aggiornare ed eliminare i volani.

Quando crei un volano, Amazon Comprehend crea un data lake per contenere tutti i dati necessari al volano, come i dati di addestramento e i dati di test per ogni versione del modello.

Quando elimini un volano, Amazon Comprehend non elimina il data lake o il modello associato al volano.

L'operazione di eliminazione del flywheel ha esito negativo se il flywheel sta eseguendo un'iterazione o sta creando un set di dati.

Esamina le informazioni nella sezione Creazione del volano prima di creare un nuovo volano.

Create un volano per un modello esistente

Utilizzate l'CreateFlywheeloperazione per creare un volano per un modello esistente.

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

Crea un volano per un nuovo modello

Utilizzate l'CreateFlywheeloperazione per creare un volano per un nuovo modello di classificazione personalizzato.

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

Descrivi un volano

Usa l'DescribeFlywheeloperazione Amazon Comprehend per recuperare informazioni configurate su un volano.

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

Il corpo della risposta dell'API include il seguente contenuto.

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

Aggiorna un volano

Utilizzate l'UpdateFlywheeloperazione per aggiornare i valori di configurazione modificabili del volano.

Alcuni campi di configurazione sono strutture JSON con sottocampi. Per aggiornare uno o più sottocampi, fornisci i valori per tutti i sottocampi (Amazon Comprehend imposta il valore su null per ogni sottocampo mancante nella richiesta).

Se ometti un parametro di primo livello nella UpdateFlywheel richiesta, Amazon Comprehend non modifica i valori del parametro o dei relativi sottocampi nel volano.

Per aggiungere o rimuovere tag sul volano, usa le operazioni and. TagResourceUntagResource

È possibile promuovere una versione del modello impostando il ActiveModelArn parametro, come illustrato nell'esempio seguente.

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

Il corpo della risposta dell'API include il seguente contenuto.

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

Eliminare un volano

Usa l'DeleteFlywheeloperazione Amazon Comprehend per eliminare i volani.

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

Una risposta API riuscita contiene un corpo del messaggio di risposta vuoto

Elenca i volani

Usa l'ListFlywheelsoperazione Amazon Comprehend per recuperare un elenco di volani nella regione corrente.

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

Il corpo della risposta dell'API include il seguente contenuto.

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