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:

Parameter untuk create-blueprint

Parameter	Diperlukan	Default	Deskripsi
--blueprint-name	Ya	N/A	Nama untuk Blueprint
--type	Ya	N/A	Jenis konten (GAMBAR, DOKUMEN, AUDIO, VIDEO)
--blueprint-stage	Tidak	LANGSUNG	Tahap untuk Cetak Biru (PENGEMBANGAN atau LANGSUNG)
--schema	Ya	N/A	Skema JSON mendefinisikan struktur Blueprint
--client-token	Tidak	Dihasilkan secara otomatis	Pengidentifikasi unik untuk idempotensi permintaan

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 Cetak Biru yang saat ini digunakan oleh proyek apa pun. Sebelum menghapus, pastikan Blueprint tidak direferensikan dalam konfigurasi keluaran kustom proyek apa pun.