Buat Proyek Otomasi Data Dapatkan Status Otomatisasi Data Respon Output Async API Pengoptimalan Cetak Biru

Menggunakan API Otomasi Data Bedrock

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, memanggil analisis, dan mengambil hasil. Untuk mengambil output kustom untuk data yang diproses, Anda menyediakan Blueprint ARN saat Anda memanggil 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 Kon Amazon Bedrock sol Amazon.

Menggunakan API

Saat menggunakan API untuk membuat proyek, Anda memanggil. CreateDataAutomationProject Saat membuat proyek, Anda harus menentukan pengaturan konfigurasi Anda 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 digunakan di masa mendatang. 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.

Async

Memanggil Otomatisasi Data Async

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

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

Berikut ini adalah struktur permintaan JSON:


{
   {
   "blueprints": [ 
      { 
         "blueprintArn": "string",
         "stage": "string",
         "version": "string"
      }
   ],
   "clientToken": "string",
   "dataAutomationConfiguration": { 
      "dataAutomationProjectArn": "string",
      "stage": "string"
   },
   "dataAutomationProfileArn": "string",
   "encryptionConfiguration": { 
      "kmsEncryptionContext": { 
         "string" : "string" 
      },
      "kmsKeyId": "string"
   },
   "inputConfiguration": { 
      "assetProcessingConfiguration": { 
         "video": { 
            "segmentConfiguration": { ... }
         }
      "s3Uri": "string"
   },
   "notificationConfiguration": { 
      "eventBridgeConfiguration": { 
         "eventBridgeEnabled": boolean
      }
   },
   "outputConfiguration": { 
      "s3Uri": "string"
   },
   "tags": [ 
      { 
         "key": "sstring",
         "value": "string"
      }
   ]
}
}

Saat Anda menjalankan InvokeDataAutomationAsync file video, Anda dapat mengatur bagian 5 menit atau lebih dari video yang akan diperlakukan sebagai video lengkap untuk ekstraksi data. Waktu ini diatur dengan stempel waktu dari milidetik awal dan akhir milidetik. Informasi ini ditambahkan dalam assetProcessingConfiguration elemen.

Sync

Memanggil Otomatisasi Data

Atau, Anda dapat menggunakan InvokeDataAutomation operasi. InvokeDataAutomationOperasi hanya mendukung pemrosesan gambar.

Panggilan API ini memulai pemrosesan sinkron dari yang disediakan melalui referensi S3, atau dalam payload. API menerima proyek ARN dan file yang akan diproses, dan mengembalikan wawasan terstruktur dalam respons. Kesalahan akan muncul jika proyek tidak ada, atau jika pemanggil tidak memiliki izin yang diperlukan, atau jika file input tidak dalam format yang didukung. Jika gambar yang dianalisis secara semantik diklasifikasikan sebagai dokumen, ini juga akan diangkat sebagai kesalahan, karena InvokeDataAutomation hanya mendukung Gambar. Untuk mencegah kesalahan ini, Anda dapat menggunakan Modality Routing pada proyek Anda untuk memaksa routing semua jenis file gambar sebagai Gambar (lihatMenonaktifkan modalitas dan jenis file routing).

Berikut adalah struktur permintaan JSON untuk gambar dan dokumen. Permintaan Sync API mendukung byte gambar dan bucket S3. Untuk menggunakan byte gambar, cukup ganti “s3Uri”: “string” di bagian “InputConfiguration” dengan “bytes“: “base64-encoded string“ outputConfiguration opsional dengan default adalah output inline. Jika URI S3 disediakan sebagai OutputConfiguration, output terenkripsi akan dimasukkan ke dalam bucket S3 yang ditentukan.


{
   {
    "blueprints": [ 
       { 
          "blueprintArn": "string",  //use for image
          "stage": "string",
          "version": "string"
       }
    ],
    "dataAutomationConfiguration": { 
       "dataAutomationProjectArn": "string",
       "stage": "string"
    },
    "dataAutomationProfileArn": "string",
    "inputConfiguration": { 
          "s3Uri": "string"
    },
    "outputConfiguration": { 
       "s3Uri": "string"
    }  
 }
}

Output mencakup struktur unik tergantung pada file, operasi, dan konfigurasi output kustom yang ditentukan dalam panggilan ke InvokeDataAutomation. Perhatikan bahwa respons ini mencakup respons keluaran standar dan kustom.

Berikut adalah struktur respons JSON dengan konfigurasi output standar dan kustom:


{
  "semanticModality": "IMAGE",
  "outputSegments": [
    {
      "customOutputStatus": "MATCH",
      "standardOutput": {
        "image": {
          "summary": "This image shows a white Nike running shoe with a black Nike swoosh logo on the side. The shoe has a modern design with a thick, cushioned sole and a sleek upper part. The word \"ROUKEA\" is visible on the sole of the shoe, repeated twice. The shoe appears to be designed for comfort and performance, suitable for running or athletic activities. The background is plain and dark, highlighting the shoe.",
          "iab_categories": [
            {
              "category": "Style and Fashion",
              "confidence": 0.9890000000000001,
              "taxonomy_level": 1,
              "parent_name": "",
              "id": "0ebe86c8-e9af-43f6-a7bb-182a61d2e1fd",
              "type": "IAB"
            },
            {
              "category": "Men's Fashion",
              "confidence": 0.9890000000000001,
              "taxonomy_level": 2,
              "parent_name": "Style and Fashion",
              "id": "13bd456a-3e1b-4681-b0dd-f42a8d5e5ad5",
              "type": "IAB"
            },
            {
              "category": "Style and Fashion",
              "confidence": 0.853,
              "taxonomy_level": 1,
              "parent_name": "",
              "id": "177b29a1-0e40-45c1-8540-5f49a3d7ded3",
              "type": "IAB"
            },
            {
              "category": "Women's Fashion",
              "confidence": 0.853,
              "taxonomy_level": 2,
              "parent_name": "Style and Fashion",
              "id": "f0197ede-3ba6-498b-8f7b-43fecc5735ef",
              "type": "IAB"
            }
          ],
          "content_moderation": [],
          "logos": [
            {
              "id": "2e109eb6-39f5-4782-826f-911b62d277fb",
              "type": "LOGOS",
              "confidence": 0.9170872209665809,
              "name": "nike",
              "locations": [
                {
                  "bounding_box": {
                    "left": 0.3977411523719743,
                    "top": 0.4922481227565456,
                    "width": 0.2574246356942061,
                    "height": 0.15461772197001689
                  }
                }
              ]
            }
          ],
          "text_words": [
            {
              "id": "f70301df-5725-405e-b50c-612e352467bf",
              "type": "TEXT_WORD",
              "confidence": 0.10091366487951722,
              "text": "ROUKEA",
              "locations": [
                {
                  "bounding_box": {
                    "left": 0.6486002310163024,
                    "top": 0.6783271480251003,
                    "width": 0.13219473954570082,
                    "height": 0.05802226710963898
                  },
                  "polygon": [
                    {
                      "x": 0.6486002310163024,
                      "y": 0.7025876947351404
                    },
                    {
                      "x": 0.7760931467045249,
                      "y": 0.6783271480251003
                    },
                    {
                      "x": 0.7807949705620032,
                      "y": 0.7120888684246991
                    },
                    {
                      "x": 0.6533020989743271,
                      "y": 0.7363494151347393
                    }
                  ]
                }
              ],
              "line_id": "9147fec0-d869-4d58-933e-93eb7164c404"
            }
          ],
          "text_lines": [
            {
              "id": "9147fec0-d869-4d58-933e-93eb7164c404",
              "type": "TEXT_LINE",
              "confidence": 0.10091366487951722,
              "text": "ROUKEA",
              "locations": [
                {
                  "bounding_box": {
                    "left": 0.6486002310163024,
                    "top": 0.6783271480251003,
                    "width": 0.13219473954570082,
                    "height": 0.05802226710963898
                  },
                  "polygon": [
                    {
                      "x": 0.6486002310163024,
                      "y": 0.7025876947351404
                    },
                    {
                      "x": 0.7760931467045249,
                      "y": 0.6783271480251003
                    },
                    {
                      "x": 0.7807949705620032,
                      "y": 0.7120888684246991
                    },
                    {
                      "x": 0.6533020989743271,
                      "y": 0.7363494151347393
                    }
                  ]
                }
              ]
            }
          ]
        },
        "statistics": {
          "iab_category_count": 4,
          "content_moderation_count": 0,
          "logo_count": 1,
          "line_count": 1,
          "word_count": 1
        },
        "metadata": {
          "semantic_modality": "IMAGE",
          "image_width_pixels": 173,
          "image_height_pixels": 148,
          "image_encoding": "jpeg",
          "s3_bucket": "test-bucket",
          "s3_key": "uploads/test-image.jpeg"
        }
      },
      "customOutput": {
        "matched_blueprint": {
          "arn": "arn:aws:bedrock:us-east-1:123456789012:blueprint/test",
          "version": "1",
          "name": "test-blueprint",
          "confidence": 1.0
        },
        "inference_result": {
          "product_details": {
            "product_category": "footwear"
          },
          "image_sentiment": "Positive",
          "image_background": "Solid color",
          "image_style": "Product image",
          "image_humor": false
        }
      }
    }
  ]
}

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 pemanggilan ARN yang dikembalikan oleh InvokeDataAutomationAsync. Ini memeriksa status pekerjaan saat ini dan mengembalikan informasi yang relevan. Setelah pekerjaan selesai, ini menyediakan lokasi hasil di S3.

Jika pekerjaan masih dalam proses, ia mengembalikan status saat ini (misalnya, "InProgress“). Jika pekerjaan selesai, ia mengembalikan “Sukses” bersama dengan lokasi S3 hasil. Jika ada kesalahan, ia mengembalikan "ServiceError" atau "ClientError" 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. Output mencakup struktur unik tergantung pada modalitas file dan jenis operasi yang ditentukan dalam panggilan ke InvokeDataAutomationAsync.

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

Sebagai contoh, untuk gambar dapat mencakup informasi berikut:

Ringkasan Gambar: Ringkasan deskriptif atau keterangan gambar.
Klasifikasi IAB: Kategorisasi berdasarkan taksonomi IAB.
Deteksi Teks Gambar: Teks yang diekstraksi dengan informasi kotak pembatas.
Moderasi Konten: Mendeteksi konten yang tidak pantas, tidak diinginkan, atau menyinggung dalam gambar.

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.

API Pengoptimalan Cetak Biru

InvokeBlueprintOptimizationAsync

Anda dapat meningkatkan akurasi cetak biru dengan memberikan contoh aset konten dengan hasil yang diharapkan yang benar. Pengoptimalan instruksi cetak biru menggunakan contoh Anda untuk menyempurnakan instruksi bahasa alami di bidang cetak biru Anda, yang meningkatkan akurasi Hasil inferensi Anda.

Untuk cetak biru, Anda dapat memanggil InvokeBlueprintOptimizationAsync API yang memulai pekerjaan pengoptimalan asinkron untuk meningkatkan instruksi bidang Blueprint berdasarkan data kebenaran dasar.

Isi Permintaan


{
    "blueprint": {
        "blueprintArn": "arn:aws:bedrock:us-east-1:123456789012:blueprint/my-document-processor",
        "stage": "DEVELOPMENT"
    },
    "samples": [
        {
            "assetS3Object": {
                "s3Uri": "s3://my-optimization-bucket/samples/document1.pdf"
            },
            "groundTruthS3Object": {
                "s3Uri": "s3://my-optimization-bucket/ground-truth/document1-expected.json"
            }
        }
    ],
    "outputConfiguration": {
        "s3Object": {
            "s3Uri": "s3://my-optimization-bucket/results/optimization-output"
        }
    },
    "dataAutomationProfileArn": "arn:aws:bedrock:us-east-1:123456789012:data-automation-profile/my-profile"
}

Respons


{
    "invocationArn": "arn:aws:bedrock:us-east-1:123456789012:blueprint-optimization-invocation/opt-12345abcdef"
}

penting

Simpan InvocationArn untuk memantau status pekerjaan pengoptimalan.

GetBlueprintOptimizationStatus

Mengambil status saat ini dan hasil dari pekerjaan pengoptimalan cetak biru yang dikeluarkan dengan memanggil API async. InvokeBlueprintOptimizationAsync GetBlueprintOptimizationStatus menerima permintaan ARN yang dikembalikan oleh InvokeBlueprintOptimizationAsync.

Respons


{
    "status": "Success",
    "outputConfiguration": {
        "s3Object": {
            "s3Uri": "s3://my-optimization-bucket/results/optimization-output"
        }
    }
}

Nilai Status:

Dibuat - Pekerjaan telah dibuat
InProgress - Optimasi sedang berjalan
Sukses - Optimasi selesai dengan sukses
ServiceError - Terjadi kesalahan layanan internal
ClientError - Parameter permintaan tidak valid

CopyBlueprintStage

Menyalin Blueprint dari tahap sumber ke tahap target (mis. tahap PENGEMBANGAN ke tahap LIVE). Ini akan digunakan untuk menyinkronkan semua konfigurasi termasuk bidang OptimizationSamples antar tahapan.

Isi Permintaan


{
    "blueprintArn": "arn:aws:bedrock:us-east-1:123456789012:blueprint/my-document-processor",
    "sourceStage": "DEVELOPMENT",
    "targetStage": "LIVE"
}

Nilai Panggung:

PENGEMBANGAN - Development/testing tahap
LIVE - Tahap produksi

Respons

{}

Awas

Operasi ini mengganti konfigurasi tahap target dan tidak dapat dengan mudah dibatalkan. Pastikan pengujian menyeluruh sebelum menyalin ke tahap LIVE.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menggunakan Konsol Otomasi Data Batuan Dasar

Menandai Inferensi dan Sumber Daya dalam Otomasi Data Batuan Dasar