Konfiguration von Schwungrädern mithilfe der API

Sie können die Amazon Comprehend API verwenden, um Schwungräder zu erstellen, zu aktualisieren und zu löschen.

Wenn Sie ein Schwungrad erstellen, erstellt Amazon Comprehend einen Data Lake, der alle Daten enthält, die das Schwungrad benötigt, z. B. die Trainingsdaten und Testdaten für jede Version des Modells.

Wenn Sie ein Schwungrad löschen, löscht Amazon Comprehend weder den Data Lake noch das dem Schwungrad zugeordnete Modell.

Der Vorgang zum Löschen von Schwungrädern schlägt fehl, wenn das Schwungrad eine Iteration ausführt oder einen Datensatz erstellt.

Lesen Sie die Informationen im Abschnitt, Erstellung von Schwungrädern bevor Sie ein neues Schwungrad erstellen.

Erstellen Sie ein Schwungrad für ein vorhandenes Modell

Verwenden Sie die CreateFlywheelOperation, um ein Schwungrad für ein vorhandenes Modell zu erstellen.

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

Erstellen Sie ein Schwungrad für ein neues Modell

Verwenden Sie die CreateFlywheelOperation, um ein Schwungrad für ein neues benutzerdefiniertes Klassifizierungsmodell zu erstellen.

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

Beschreiben Sie ein Schwungrad

Verwenden Sie den Amazon Comprehend DescribeFlywheelComprehend-Vorgang, um konfigurierte Informationen über ein Schwungrad abzurufen.

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

Der API-Antworttext umfasst den folgenden Inhalt.

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

Aktualisieren Sie ein Schwungrad

Verwenden Sie den UpdateFlywheelVorgang, um die änderbaren Konfigurationswerte des Schwungrades zu aktualisieren.

Einige Konfigurationsfelder sind JSON-Strukturen mit Unterfeldern. Um ein oder mehrere Unterfelder zu aktualisieren, geben Sie Werte für alle Unterfelder an (Amazon Comprehend setzt den Wert für jedes Unterfeld, das in der Anfrage fehlt, auf Null).

Wenn Sie einen Parameter der obersten Ebene in der UpdateFlywheel Anfrage weglassen, ändert Amazon Comprehend weder die Werte des Parameters noch eines seiner Unterfelder im Schwungrad.

Verwenden Sie die Operationen und, um Tags auf dem Schwungrad hinzuzufügen oder zu entfernen. TagResourceUntagResource

Sie können eine Modellversion heraufstufen, indem Sie den ActiveModelArn Parameter festlegen, wie im folgenden Beispiel gezeigt.

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

Der API-Antworttext umfasst den folgenden Inhalt.

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

Löscht ein Schwungrad

Verwenden Sie den Amazon Comprehend DeleteFlywheelComprehend-Vorgang, um Schwungräder zu löschen.

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

Eine erfolgreiche API-Antwort enthält einen leeren Antwortnachrichtentext

Listet die Schwungräder auf

Verwenden Sie den Amazon Comprehend ListFlywheelsComprehend-Vorgang, um eine Liste der Schwungräder in der aktuellen Region abzurufen.

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

Der API-Antworttext umfasst den folgenden Inhalt.

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