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à.
# Elaborazione tramite CLI
Prima di elaborare i documenti con BDA, è necessario caricarli in un bucket S3:
**Sintassi**
```
aws s3 cp [--options]
```
Esempio:
```
aws s3 cp /local/path/document.pdf s3://my-bda-bucket/input/document.pdf
```
------
#### [ Async ]
**Struttura dei comandi di elaborazione di base**
Utilizzare il comando `invoke-data-automation-async` per elaborare i file:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://amzn-s3-demo-bucket/sample-images/sample-image.jpg"
}' \
--output-configuration '{
"s3Uri": "s3://amzn-s3-demo-bucket/output/"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
**Struttura avanzata dei comandi di elaborazione**
**Elaborazione video con segmenti di tempo**
Per i file video, è possibile specificare i segmenti di tempo da elaborare:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://my-bucket/video.mp4",
"assetProcessingConfiguration": {
"video": {
"segmentConfiguration": {
"timestampSegment": {
"startTimeMillis": 0,
"endTimeMillis": 300000
}
}
}
}
}' \
--output-configuration '{
"s3Uri": "s3://my-bucket/output/"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
**Utilizzo di blueprint personalizzati**
È possibile specificare blueprint personalizzati direttamente nel comando:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://my-bucket/document.pdf"
}' \
--output-configuration '{
"s3Uri": "s3://my-bucket/output/"
}' \
--blueprints '[
{
"blueprintArn": "Amazon Resource Name (ARN)",
"version": "1",
"stage": "LIVE"
}
]' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
**Aggiunta della configurazione della crittografia**
Per maggiore sicurezza, è possibile aggiungere una configurazione di crittografia:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://my-bucket/document.pdf"
}' \
--output-configuration '{
"s3Uri": "s3://my-bucket/output/"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--encryption-configuration '{
"kmsKeyId": "Amazon Resource Name (ARN)",
"kmsEncryptionContext": {
"Department": "Finance",
"Project": "DocumentProcessing"
}
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
**Notifiche eventi**
Abilita EventBridge le notifiche per il completamento dell'elaborazione:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://my-bucket/document.pdf"
}' \
--output-configuration '{
"s3Uri": "s3://my-bucket/output/"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--notification-configuration '{
"eventBridgeConfiguration": {
"eventBridgeEnabled": true
}
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
**Verifica dello stato dell'elaborazione**
Per verificare lo stato dell’elaborazione del processo, utilizzare il comando `get-data-automation-status`.
```
aws bedrock-data-automation-runtime get-data-automation-status \
--invocation-arn "Amazon Resource Name (ARN)"
```
La risposta includerà lo stato attuale:
```
{
"status": "COMPLETED",
"creationTime": "2025-07-24T12:34:56.789Z",
"lastModifiedTime": "2025-07-24T12:45:12.345Z",
"outputLocation": "s3://my-bucket/output/abcd1234/"
}
```
**Recupera i risultati dell'elaborazione**
**Individuazione dei file di output in S3**
Elencare i file di output nel bucket S3:
```
aws s3 ls s3://amzn-s3-demo-bucket/output/
```
Scaricare i risultati nella macchina locale:
```
aws s3 cp s3://amzn-s3-demo-bucket/output/ ~/Downloads/bda-results/ --recursive
```
**Comprendere la struttura di output**
In genere l’output include:
+ `standard-output.json`: contiene risultati di estrazione standard
+ `custom-output.json`: contiene risultati di blueprint personalizzati
+ `metadata.json`: contiene i metadati di elaborazione e i punteggi di attendibilità
**Campi di risposta comuni**
In genere l’output standard include:
+ `extractedData`: le principali informazioni estratte
+ `confidence`: punteggi di attendibilità per ogni campo estratto
+ `metadata`: informazioni sull’elaborazione tra cui timestamp e dettagli del modello
+ `boundingBoxes`: informazioni sulla posizione degli elementi rilevati (se abilitata)
**Gestione e risoluzione degli errori**
Scenari di errore comuni e soluzioni:
+ **URI S3 non valido**: assicurarsi che il bucket S3 esista e di disporre delle autorizzazioni appropriate
+ **Data-automation-profile-arn mancante**: questo parametro è obbligatorio per tutte le richieste di elaborazione
+ **Progetto non trovato**: verificare che l’ARN del progetto sia corretto e che il progetto esista
+ **Formato di file non supportato**: verificare che il formato di file sia supportato da BDA
**Aggiungere tag ai processi di elaborazione**
È possibile aggiungere tag per organizzare e tenere traccia dei processi di elaborazione:
```
aws bedrock-data-automation-runtime invoke-data-automation-async \
--input-configuration '{
"s3Uri": "s3://my-bucket/document.pdf"
}' \
--output-configuration '{
"s3Uri": "s3://my-bucket/output/"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--tags '[
{
"key": "Department",
"value": "Finance"
},
{
"key": "Project",
"value": "InvoiceProcessing"
}
]' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
```
------
#### [ Sync ]
**Struttura dei comandi di elaborazione di base**
Utilizzare il comando `invoke-data-automation` per elaborare i file:
```
aws bedrock-data-automation-runtime invoke-data-automation \
--input-configuration '{
"s3Uri": "s3://amzn-s3-demo-bucket/sample-images/sample-image.jpg"
}' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
--region "aws-region"
```
**Struttura avanzata dei comandi di elaborazione**
Uscita su bucket S3
```
aws bedrock-data-automation-runtime invoke-data-automation \
--input-configuration '{
"s3Uri": "s3://amzn-s3-demo-bucket/sample-images/sample-image.jpg"
}' \
--output-configuration '{"s3Uri": "s3://amzn-s3-demo-bucket/output/" }' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
--region "aws-region" //document only
```
Usa l'input in byte
```
aws bedrock-data-automation-runtime invoke-data-automation \
--input-configuration '{
"bytes": #blob input
}' \
--output-configuration '{"s3Uri": "s3://amzn-s3-demo-bucket/output/" }' \
--data-automation-configuration '{
"dataAutomationProjectArn": "Amazon Resource Name (ARN)",
"stage": "LIVE"
}' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
--region "aws-region"
```
**Nota**
**Byte**
Un blob di byte di documento codificati in base64. La dimensione massima di un documento fornito in un blob di byte è di 50 MB. Il tipo deve essere un oggetto di dati Base64-encoded binario.
**Usa progetti personalizzati (solo per l'immagine)**
```
aws bedrock-data-automation-runtime invoke-data-automation \
--input-configuration '{
"s3Uri": "s3://amzn-s3-demo-bucket/sample-images/sample-image.jpg"
}' \
--blueprints '[{"blueprintArn": "Amazon Resource Name (ARN)", "version": "1", "stage": "LIVE" } ]' \
--data-automation-profile-arn "Amazon Resource Name (ARN)"
--region "aws-region"
```
------