CLI delle operazioni blueprint - Amazon Bedrock
Creazione di blueprintRiferimento completo ai parametriVisualizzazione delle configurazioni blueprintModificare le specifiche del blueprintGestione dei tag del blueprintEliminazione di blueprintOttimizzazione del progetto

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CLI delle operazioni blueprint

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 blueprint

I blueprint definiscono la struttura e le proprietà dei dati da estrarre da documenti, immagini, file audio o video. Per definire un nuovo blueprint, utilizza il comando create-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 comando create-blueprint:

Parametri per create-blueprint
Parametro Obbligatorio Predefinita Description
--blueprint-name Sì N/D Nome per il blueprint
--type Sì N/D Tipo di contenuto (IMMAGINE, DOCUMENTO, AUDIO, VIDEO)
--blueprint-stage No LIVE Fase del 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

Elencare tutti i blueprint

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

Sintassi

aws bedrock-data-automation list-blueprints

Visualizzare i dettagli del blueprint

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

Sintassi

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

Ispezionare 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"

Ispezionare una fase specifica

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


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

Modificare le specifiche del blueprint

Aggiornare le impostazioni del 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.

Promuovere 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 del 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 del blueprint

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

Aggiungere tag

Applica i metadati al blueprint aggiungendo tag.

Sintassi

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

Rimuovere i tag

Rimuovi tag specifici dal blueprint con il comando untag-resource.

Sintassi

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

Visualizzare 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 relative 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 in uso da parte di un progetto. Prima dell’eliminazione, assicurati che il blueprint non sia referenziato nella configurazione di output personalizzata di alcun progetto.

Ottimizzazione del progetto

Richiamo dell'ottimizzazione del blueprint

Avvia un lavoro asincrono di ottimizzazione del blueprint per migliorare le istruzioni del blueprint per ciascuno dei campi del blueprint e la precisione dei risultati.

Sintassi

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"

Verifica dello stato di ottimizzazione del blueprint

Monitora lo stato di avanzamento e i risultati di un lavoro di ottimizzazione del blueprint.

Sintassi

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

Utilizzate questo comando per tenere traccia dello stato del processo di ottimizzazione. La risposta include lo stato corrente (Creato InProgress, Operato con successo o ClientError) e i dettagli della configurazione dell'output una volta completata. ServiceError

Copiare le fasi del blueprint

Copiare un blueprint da una fase all'altra

Sintassi

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

Attenzione: questo comando copia l'intera configurazione di Blueprint dalla fase di origine alla fase di destinazione, sovrascrivendo qualsiasi configurazione esistente nella fase di destinazione.

Importante: assicurati che Blueprint sia accuratamente testato nella fase di origine prima di copiarlo nella fase di produzione (LIVE). Questa operazione non può essere annullata facilmente.