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/A | Nome per il blueprint |
| --type | Sì | N/A | Tipo di contenuto (IMMAGINE, DOCUMENTO, AUDIO, VIDEO) |
| --blueprint-stage | No | LIVE | Fase del blueprint (DEVELOPMENT o LIVE) |
| --schema | Sì | N/A | Schema JSON che definisce la struttura blueprint |
| --client-token | No | Auto-generated | 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 blueprint per preservarne lo stato attuale prima di apportarvi 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 blueprint con il comando list-tags-for-resource.
**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 blueprint
### 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:::blueprint/",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:::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
Copia un blueprint da una fase all'altra
**Sintassi**
```
aws bedrock-data-automation copy-blueprint-stage \
--blueprint-arn "arn:aws:bedrock:::blueprint/" \
--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.