Konfigurieren von Flywheels mit der API - Amazon Comprehend
Erstellen eines Flywheels für ein vorhandenes ModellErstellen eines Flywheels für ein neues ModellBeschreiben eines FlywheelAktualisieren eines FlywheelLöschen eines FlywheelAuflisten der Flywheels

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren von Flywheels mit der API

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

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

Wenn Sie ein Flywheel löschen, löscht Amazon Comprehend weder den Data Lake noch das mit dem Flywheel verknüpfte Modell.

Der Löschvorgang für Flywheel schlägt fehl, wenn das Flywheel eine Iteration ausführt oder einen Datensatz erstellt.

Lesen Sie die Informationen im Abschnitt , Flywheel-Erstellung bevor Sie ein neues Flywheel erstellen.

Erstellen eines Flywheels für ein vorhandenes Modell

Verwenden Sie die -CreateFlywheelOperation, um ein Flywheel 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"   \

Wenn der Vorgang erfolgreich ist, enthält die Antwort den Flywheel-ARN.

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

Erstellen eines Flywheels für ein neues Modell

Verwenden Sie die -CreateFlywheelOperation, um ein Flywheel 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

Die Datei taskConfig.json enthält den folgenden Inhalt.

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

Der API-Antworttext enthält den folgenden Inhalt.

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

Beschreiben eines Flywheel

Verwenden Sie die Amazon Comprehend-DescribeFlywheelOperation, um konfigurierte Informationen zu einem Flywheel abzurufen. 

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

Der API-Antworttext enthält 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 eines Flywheel

Verwenden Sie die -UpdateFlywheelOperation, um die veränderbaren Konfigurationswerte des Flywheels 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 Anforderung fehlt, auf Null).

Wenn Sie einen Parameter der obersten Ebene in der UpdateFlywheel Anforderung weglassen, ändert Amazon Comprehend die Werte des Parameters oder seiner Unterfelder im Flywheel nicht.

Verwenden Sie die UntagResource Operationen TagResource und , um Tags auf dem Flywheel hinzuzufügen oder zu entfernen.

Sie können eine Modellversion hochstufen, 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 enthält den folgenden Inhalt.

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

Löschen eines Flywheel

Verwenden Sie die Amazon Comprehend-DeleteFlywheelOperation, um Flywheels zu löschen. 

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

Eine erfolgreiche API-Antwort enthält einen leeren Antwortnachrichtentext

Auflisten der Flywheels

Verwenden Sie die Amazon Comprehend-ListFlywheelsOperation, um eine Liste der Flywheels in der aktuellen Region abzurufen. 

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

Der API-Antworttext enthält 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
        }
    ]
}