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

CLI Operasi Cetak Biru

Panduan ini mencakup operasi Blueprint yang tersedia melalui AWS Command Line Interface (CLI) untuk Otomasi Amazon Bedrock Data (BDA).

Membuat Cetak Biru

Cetak biru menentukan struktur dan properti data yang ingin Anda ekstrak dari dokumen, gambar, audio, atau file video Anda. Gunakan perintah create-blueprint untuk menentukan Blueprint baru.

Perintah berikut membuat Blueprint baru yang disesuaikan untuk mengekstrak data dari gambar paspor.

Sintaksis

aws bedrock-data-automation create-blueprint \
      --blueprint-name "passport-blueprint" \
      --type "IMAGE" \
      --blueprint-stage "DEVELOPMENT" \
      --schema '{
        "class": "Passport",
        "description": "Blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Referensi parameter lengkap

Tabel berikut menunjukkan semua parameter yang tersedia untuk create-blueprint perintah:

Melihat konfigurasi Blueprint

Daftar semua Cetak Biru

Gunakan perintah list-blueprints untuk mengambil daftar semua Blueprints yang terkait dengan akun Anda.

Sintaksis

aws bedrock-data-automation list-blueprints

Lihat detail Blueprint

Untuk melihat informasi rinci tentang Blueprint tertentu, termasuk skema dan konfigurasinya, gunakan perintah get-blueprint.

Sintaksis

aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)"

Periksa versi tertentu

Saat bekerja dengan Blueprints berversi, gunakan perintah get-blueprint dengan opsi --blueprint-version untuk melihat versi tertentu.

Sintaksis

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-version "version-number"

Periksa tahap tertentu

Untuk melihat Cetak Biru di tahap PENGEMBANGAN atau LANGSUNG, gunakan:

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Mengedit spesifikasi Blueprint

Perbarui pengaturan Blueprint

Untuk memodifikasi skema atau properti Blueprint yang ada, gunakan perintah update-blueprint.

Sintaksis

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --schema '{
        "class": "Passport",
        "description": "Updated blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Catatan: Saat memperbarui Cetak Biru, Anda harus menyediakan skema lengkap, bahkan untuk bidang yang tidak Anda ubah.

Promosikan untuk LIVE

Untuk memindahkan Blueprint dari DEVELOPMENT ke tahap LIVE untuk produksi, gunakan perintah update-blueprint dengan opsi --blueprint-stage.

Sintaksis

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Versi cetak biru

Buat versi baru Blueprint Anda untuk mempertahankan statusnya saat ini sebelum membuat perubahan signifikan menggunakan perintah. create-blueprint-version

Sintaksis

aws bedrock-data-automation create-blueprint-version \
      --blueprint-arn "Amazon Resource Name (ARN)"
      

Mengelola tag Blueprint

Tag membantu pengguna mengatur dan mengkategorikan Cetak Biru untuk pengelolaan yang disederhanakan.

Tambahkan tag

Terapkan metadata ke Blueprint Anda dengan menambahkan tag.

Sintaksis

aws bedrock-data-automation tag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tags '{"Department":"Finance","Project":"PassportProcessing"}'

Hapus tag

Hapus tag tertentu dari Blueprint Anda dengan perintah untag-resource.

Sintaksis

aws bedrock-data-automation untag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tag-keys '["Department","Project"]'

Lihat tag

Buat daftar semua tag yang terkait dengan Blueprint Anda menggunakan perintah. list-tags-for-resource

Sintaksis

aws bedrock-data-automation list-tags-for-resource \
      --resource-arn "Amazon Resource Name (ARN)"

Menghapus Cetak Biru

Hapus seluruh Blueprint

Gunakan perintah delete-blueprint untuk menghapus Blueprint dan semua versinya secara permanen.

Sintaksis

aws bedrock-data-automation delete-blueprint \
          --blueprint-arn "Amazon Resource Name (ARN)"
              

Perhatian: Perintah ini menghapus Blueprint secara permanen dan tidak dapat memulihkannya.

Penting: Anda tidak dapat menghapus Blueprint yang saat ini digunakan oleh proyek apa pun. Sebelum menghapus, pastikan Blueprint tidak direferensikan dalam konfigurasi keluaran kustom proyek apa pun.

Pengoptimalan Cetak Biru

Memohon Pengoptimalan Cetak Biru

Mulai pekerjaan pengoptimalan cetak biru asinkron untuk meningkatkan instruksi cetak biru dari setiap bidang cetak biru Anda dan akurasi hasil.

Sintaksis

aws bedrock-data-automation invoke-blueprint-optimization-async \
    --blueprint blueprintArn="arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>",stage="DEVELOPMENT" \
    --samples '[
        {
            "assetS3Object": {
                "s3Uri": "s3://my-optimization-bucket/samples/document1.pdf"
            },
            "groundTruthS3Object": {
                "s3Uri": "s3://my-optimization-bucket/ground-truth/document1-expected.json"
            }
        }
    ]' \
    --output-configuration s3Object='{s3Uri="s3://my-optimization-bucket/results/optimization-output"}' \
    --data-automation-profile-arn "Amazon Resource Name (ARN):data-automation-profile/default"

Memeriksa Status Pengoptimalan Cetak Biru

Pantau kemajuan dan hasil pekerjaan optimasi cetak biru.

Sintaksis

aws bedrock-data-automation get-blueprint-optimization-status \
    --invocation-arn "arn:aws:bedrock:<region>:<account_id>:blueprint-optimization-invocation/opt-12345abcdef"

Gunakan perintah ini untuk melacak status pekerjaan optimasi. Respons mencakup status saat ini (Dibuat, InProgress, Sukses ServiceError, atau ClientError) dan detail konfigurasi keluaran saat selesai.

Menyalin Tahapan Cetak Biru

Salin Blueprint dari satu tahap ke tahap lainnya

Sintaksis

aws bedrock-data-automation copy-blueprint-stage \
    --blueprint-arn "arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>" \
    --source-stage "DEVELOPMENT" \
    --target-stage "LIVE"

Perhatian: Perintah ini menyalin seluruh konfigurasi Blueprint dari tahap sumber ke tahap target, menimpa konfigurasi yang ada di tahap target.

Penting: Pastikan Cetak Biru diuji secara menyeluruh di tahap sumber sebelum menyalin ke tahap produksi (LIVE). Operasi ini tidak dapat dibatalkan dengan mudah.