Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan API Otomasi Data Batuan Dasar

Fitur Otomasi Amazon Bedrock Data (BDA) menyediakan alur kerja API yang efisien untuk memproses data Anda. Untuk semua modalitas, alur kerja ini terdiri dari tiga langkah utama: membuat proyek, menjalankan analisis, dan mengambil hasilnya. Untuk mengambil output kustom untuk data yang diproses, Anda memberikan Blueprint ARN saat Anda menjalankan operasi analisis.

Buat Proyek Otomasi Data

Untuk mulai memproses file dengan BDA, Anda harus terlebih dahulu membuat Proyek Otomasi Data. Ini dapat dilakukan dengan dua cara, dengan CreateDataAutomationProject operasi atau Amazon Bedrock Konsol Amazon.

Menggunakan API

Saat menggunakan API untuk membuat proyek, Anda memanggil file. CreateDataAutomationProject Saat membuat proyek, Anda harus menentukan pengaturan konfigurasi untuk jenis file yang cenderung Anda proses (modalitas yang ingin Anda gunakan). Berikut adalah contoh bagaimana Anda dapat mengkonfigurasi output standar untuk gambar:

{
"standardOutputConfiguration": {
"image": {
"state": "ENABLED",
"extraction": {
"category": {
"state": "ENABLED",
"types": ["CONTENT_MODERATION", "TEXT_DETECTION"]
},
"boundingBox": {
"state": "ENABLED"
}
},
"generativeField": {
"state": "ENABLED",
"types": ["IMAGE_SUMMARY", "IAB"]
}
}
}
}

API memvalidasi konfigurasi input. Ini menciptakan proyek baru dengan ARN yang unik. Pengaturan proyek disimpan untuk penggunaan masa depan. Jika proyek dibuat tanpa parameter, pengaturan default akan berlaku. Misalnya, saat memproses gambar, ringkasan gambar dan deteksi teks akan diaktifkan secara default.

Ada batasan jumlah proyek yang dapat dibuat per AWS akun. Kombinasi pengaturan tertentu mungkin tidak diizinkan atau mungkin memerlukan izin tambahan.

Memanggil Otomatisasi Data Async

Anda memiliki proyek yang disiapkan, Anda dapat mulai memproses gambar menggunakan InvokeDataAutomationAsync operasi. Jika menggunakan keluaran khusus, Anda hanya dapat mengirimkan satu cetak biru ARN per permintaan.

Panggilan API ini memulai pemrosesan asinkron file Anda dalam bucket S3 yang ditentukan. API menerima ARN proyek dan lokasi file yang akan diproses, kemudian memulai pekerjaan pemrosesan asinkron. ID pekerjaan dikembalikan untuk melacak proses. Kesalahan akan muncul jika proyek tidak ada, jika pemanggil memiliki izin yang diperlukan, atau jika file input tidak dalam format yang didukung.

Berikut ini adalah struktur permintaan JSON:

{
   "InputConfiguration" : { "s3Uri": "string"}, // required
  "DataAutomationConfiguration" : {
    "DataAutomationARN": "",
    "stage": LIVE | DEV
  }, // optional 
  "BlueprintArn": [], // optional
  "OutputConfiguration" : { 
    "s3Uri": "string"
  }, // required
  "EncryptionConfiguration": { // optional
    "KmsKeyId": "string",
    "KmsEncryptionContext": { "key" : "string" },
  },
  "NotificationConfiguration": { // optional
    "EventBridgeConfiguration": {"EventBridgeEnabled" : Boolean },
  } 
   "ClientToken": "string",
   "JobTags": { "string" : "string" }
}

Dapatkan Status Otomatisasi Data

Untuk memeriksa status pekerjaan pemrosesan Anda dan mengambil hasil, gunakan GetDataAutomationStatus.

GetDataAutomationStatus API memungkinkan Anda untuk memantau kemajuan pekerjaan Anda dan mengakses hasilnya setelah pemrosesan selesai. API menerima ID pekerjaan yang dikembalikan oleh InvokeDataAutomationAsync. Ini memeriksa status pekerjaan saat ini dan mengembalikan informasi yang relevan. Setelah pekerjaan selesai, ia memberikan lokasi hasil di S3.

Jika pekerjaan masih dalam proses, ia mengembalikan status saat ini (misalnya, “RUNNING”, “QUEUED”). Jika pekerjaan selesai, ia mengembalikan “SELESAI” bersama dengan lokasi S3 hasil. Jika ada kesalahan, ia mengembalikan “GAGAL” dengan detail kesalahan.

Berikut ini adalah format permintaan JSON:

{
   "InvocationArn": "string" // Arn
}

Respon Output Async

Hasil pemrosesan file disimpan dalam bucket S3 yang dikonfigurasi untuk gambar input. Outputnya mencakup struktur unik tergantung pada modalitas file dan jenis operasi yang ditentukan dalam panggilan ke InvokeDataAutomationAsync.

Untuk informasi tentang output standar untuk modalitas tertentu, lihat. Output standar dalam Otomasi Data Batuan Dasar

Sebagai contoh, untuk gambar dapat mencakup informasi tentang hal berikut:

Berikut ini adalah contoh cuplikan output untuk pemrosesan gambar:

{
"metadata": {
  "id": "image_123",
  "semantic_modality": "IMAGE",
  "s3_bucket": "my-s3-bucket",
  "s3_prefix": "images/",
  "image_width_pixels": 1920,
  "image_height_pixels": 1080
},
  "image": {
    "summary": "A lively party scene with colorful decorations and supplies",
    "iab_categories": [
  {
      "category": "Party Supplies",
      "confidence": 0.9,
      "parent_name": "Events & Attractions"
  }
],
 "content_moderation": [
  {
    "category": "Drugs & Tobacco Paraphernalia & Use",
    "confidence": 0.7
  }
],
  "text_words": [
        {
            "id": "word_1",
            "text": "lively",
            "confidence": 0.9,
            "line_id": "line_1",
            "locations": [
                {
                    "bounding_box": {
                        "left": 100,
                        "top": 200,
                        "width": 50,
                        "height": 20
                    },
                    "polygon": [
                        {"x": 100, "y": 200},
                        {"x": 150, "y": 200},
                        {"x": 150, "y": 220},
                        {"x": 100, "y": 220}
                    ]
                }
             ]
           }
         ],  
  }
}

Output terstruktur ini memungkinkan integrasi yang mudah dengan aplikasi hilir dan analisis lebih lanjut.