Mengkonfigurasi flywheel menggunakan API

Anda dapat menggunakan Amazon Comprehend API untuk membuat, memperbarui, dan menghapus flywheels.

Saat Anda membuat flywheel, Amazon Comprehend membuat data lake untuk menyimpan semua data yang dibutuhkan flywheel, seperti data pelatihan dan data pengujian untuk setiap versi model.

Saat Anda menghapus flywheel, Amazon Comprehend tidak menghapus data lake atau model yang terkait dengan flywheel.

Operasi penghapusan flywheel gagal jika flywheel menjalankan iterasi atau membuat dataset.

Tinjau informasi di bagian Pembuatan roda gila sebelum Anda membuat flywheel baru.

Buat flywheel untuk model yang ada

Gunakan CreateFlywheeloperasi untuk membuat flywheel untuk model yang ada.

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

Buat flywheel untuk model baru

Gunakan CreateFlywheeloperasi untuk membuat flywheel untuk model klasifikasi kustom baru.

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

Jelaskan flywheel

Gunakan operasi DescribeFlywheelAmazon Comprehend untuk mengambil informasi yang dikonfigurasi tentang flywheel.

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

Badan respons API menyertakan konten berikut.

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

Perbarui flywheel

Gunakan UpdateFlywheeloperasi untuk memperbarui nilai konfigurasi flywheel yang dapat dimodifikasi.

Beberapa bidang konfigurasi adalah struktur JSON dengan subbidang. Untuk memperbarui satu atau beberapa subbidang, berikan nilai untuk semua subbidang (Amazon Comprehend menyetel nilai ke null untuk setiap subbidang yang hilang dalam permintaan).

Jika Anda menghilangkan parameter tingkat atas dalam UpdateFlywheel permintaan, Amazon Comprehend tidak mengubah nilai parameter atau subbidangnya di flywheel.

Untuk menambah atau menghapus tag pada flywheel, gunakan TagResourcedan UntagResourceoperasi.

Anda dapat mempromosikan versi model dengan mengatur ActiveModelArn parameter, seperti yang ditunjukkan pada contoh berikut.

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

Badan respons API menyertakan konten berikut.

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

Hapus flywheel

Gunakan operasi DeleteFlywheelAmazon Comprehend untuk menghapus flywheels.

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

Respons API yang berhasil berisi badan pesan respons kosong

Daftar flywheels

Gunakan operasi ListFlywheelsAmazon Comprehend untuk mengambil daftar flywheel di wilayah saat ini.

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

Badan respons API menyertakan konten berikut.

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