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

# CLI Operasi Cetak Biru
<a name="bda-blueprint-operations"></a>

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

## Membuat Cetak Biru
<a name="create-blueprints-cli"></a>

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
<a name="create-blueprint-parameters"></a>

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
<a name="view-blueprint-cli"></a>

**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
<a name="edit-blueprint-cli"></a>

**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
<a name="tag-management-cli"></a>

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
<a name="delete-blueprint-cli"></a>

**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
<a name="blueprint-optimization-cli"></a>

### Memohon Pengoptimalan Cetak Biru
<a name="invoking-blueprint-optimization"></a>

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
<a name="checking-blueprint-optimization-status"></a>

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
<a name="copying-blueprint-stages"></a>

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.