Blueprint Operations CLI

Questa guida descrive le operazioni Blueprint disponibili tramite l'interfaccia a riga di comando (CLI) di AWS Amazon Bedrock per l'automazione dei dati (BDA).

Creazione di progetti

I blueprint definiscono la struttura e le proprietà dei dati che desideri estrarre da documenti, immagini, file audio o video. Utilizzate il comando create-blueprint per definire un nuovo Blueprint.

Il comando seguente crea un nuovo Blueprint personalizzato per estrarre dati da un'immagine del passaporto.

Sintassi

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"
          }
        }
      }'

Riferimento completo ai parametri

La tabella seguente mostra tutti i parametri disponibili per il create-blueprint comando:

Parametri per create-blueprint

Parametro	Obbligatorio	Predefinito	Descrizione
--blueprint-name	Sì	N/D	Nome per il Blueprint
--type	Sì	N/D	Tipo di contenuto (IMMAGINE, DOCUMENTO, AUDIO, VIDEO)
--blueprint-stage	No	DAL VIVO	Stage for the Blueprint (DEVELOPMENT o LIVE)
--schema	Sì	N/D	Schema JSON che definisce la struttura Blueprint
--client-token	No	Generato automaticamente	Identificatore univoco per l'idempotenza della richiesta

Visualizzazione delle configurazioni Blueprint

Elenca tutti i progetti

Usa il comando list-blueprints per recuperare un elenco di tutti i progetti associati al tuo account.

Sintassi

aws bedrock-data-automation list-blueprints

Visualizza i dettagli di Blueprint

Per visualizzare informazioni dettagliate su uno specifico Blueprint, inclusi lo schema e la configurazione, utilizzare il comando get-blueprint.

Sintassi

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

Ispeziona una versione specifica

Quando lavori con Blueprint con versioni, usa il comando get-blueprint con l'opzione --blueprint-version per visualizzare una versione particolare.

Sintassi

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

Ispeziona una fase specifica

Per visualizzare i progetti in fase di SVILUPPO o LIVE, usa:

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

Modifica delle specifiche di Blueprint

Aggiorna le impostazioni di Blueprint

Per modificare lo schema o le proprietà di un Blueprint esistente, usa il comando update-blueprint.

Sintassi

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"
          }
        }
      }'

Nota: quando aggiorni un Blueprint, devi fornire lo schema completo, anche per i campi che non stai modificando.

Promuovi a LIVE

Per spostare un Blueprint dalla fase DEVELOPMENT alla fase LIVE per la produzione, usa il comando update-blueprint con l'opzione --blueprint-stage.

Sintassi

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

Controllo delle versioni di Blueprint

Crea una nuova versione del tuo Blueprint per preservarne lo stato attuale prima di apportare modifiche significative utilizzando il comando. create-blueprint-version

Sintassi

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

Gestione dei tag Blueprint

I tag aiutano gli utenti a organizzare e classificare i Blueprint per una gestione semplificata.

Aggiungi tag

Applica i metadati al tuo Blueprint aggiungendo tag.

Sintassi

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

Rimuovi i tag

Rimuovi tag specifici dal tuo Blueprint con il comando untag-resource.

Sintassi

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

Visualizza i tag

Elenca tutti i tag associati al tuo Blueprint usando il list-tags-for-resource comando.

Sintassi

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

Eliminazione di Blueprint

Eliminare un intero blueprint

Usa il comando delete-blueprint per rimuovere definitivamente un Blueprint e tutte le sue versioni.

Sintassi

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

Attenzione: questo comando elimina definitivamente un Blueprint e non può ripristinarlo.

Importante: non è possibile eliminare un Blueprint attualmente utilizzato da alcun progetto. Prima di eliminarlo, assicurati che il Blueprint non sia referenziato nella configurazione di output personalizzata di nessun progetto.